← Back to Skills Marketplace
workspace-git-sync
by
David668HAHA
· GitHub ↗
· v1.0.0
· MIT-0
115
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install workspace-git-sync
Description
将 OpenClaw workspace 目录（~/.openclaw/workspace/）同步到指定的本地 Git 仓库， 自动执行 git add、commit 和 push 操作。 使用场景： - 备份 workspace 文件到 Git 仓库 - 将工作目录同步到远程备份 - 定期归档 OpenClaw...
Usage Guidance
This skill appears to do what it says, but take these precautions before installing or running it: 1) Ensure Git and Python are available on the host (the metadata omits these requirements). 2) Inspect the bundle source/author (README clone URL is a placeholder), and review the included script locally before execution. 3) Before running, run a dry test: point the script at an empty test repo or a copy of the target to observe behavior. 4) Check the target repo's 'origin' remote URL — the script will push the workspace contents to that remote using your existing git credentials, so confirm you trust that remote. 5) Be aware the script deletes all non-excluded items in the target directory (preserves only .git) and can force-style push; back up the target repo first. 6) If you need a less-destructive workflow, request or modify the code to support a dry-run mode and safer defaults (no delete, no force).
Capability Analysis
Type: OpenClaw Skill
Name: workspace-git-sync
Version: 1.0.0
The workspace-git-sync skill is a utility designed to synchronize the OpenClaw workspace directory to a user-specified local Git repository. The script (sync_workspace.py) implements a standard sync flow: pulling remote changes, mirroring the source directory to the target (including a cleanup step for non-excluded files), and pushing the updates. It includes safety checks such as verifying the target is a valid Git repository and using '--force-with-lease' for forced pushes. While the script modifies local Git configurations and deletes files in the target directory, these actions are documented and necessary for the stated purpose of repository synchronization.
Capability Assessment
Purpose & Capability
The skill's name/description and its code align: it copies ~/.openclaw/workspace into a local Git repo, runs git add/commit/push, and can force-push. However the metadata declares no required binaries or primary credential even though the implementation calls out to the 'git' CLI (and the SKILL.md examples call 'python3'). The omission of 'git' and 'python3' as required binaries is an incoherence the user should note.
Instruction Scope
SKILL.md and the script stay within the stated scope: they validate the source directory, validate the target is a git repo, pull, wipe non-excluded files in the target, copy workspace contents, commit, and push. This is expected for a sync/backup tool. Important caveats: the script deletes non-excluded files in the target repo (preserving only .git) and will push whatever it copies (including any sensitive files present in the workspace). The tool also offers a 'force' strategy that skips pull and uses --force-with-lease; this is destructive by design and must be used with care.
Install Mechanism
There is no install spec (instruction-only skill with included script files). That is low risk from an installer perspective, but the README contains a placeholder clone URL (github.com/yourname) which suggests the source/maintainer is unclear. The code is present in the skill bundle and will be written to disk when the skill is installed/used.
Credentials
The skill declares no required environment variables or credentials (appropriate), but it relies on locally configured Git credentials/remote configuration to push data. That means data copied from your workspace can be transmitted to whatever remote is configured for the target repo (origin). You should verify the target repo's remote URL and that you trust it before running; the skill itself does not request keys but will use any existing git auth helpers or credentials on the host.
Persistence & Privilege
always:false (normal). The skill does not request permanent platform-wide privileges and does not modify other skills. It will write to the target git repo and set local git user.name/email inside that repo (expected and scoped). The default allow-autonomous-invocation is platform normal — not sufficient alone to raise a flag.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install workspace-git-sync - After installation, invoke the skill by name or use
/workspace-git-sync - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Sync your OpenClaw workspace to a local Git repository with automated backup and version control.
- Adds commands to sync `~/.openclaw/workspace/` to any specified Git repo, including pull → copy → commit → push.
- Supports exclusion of large/system/generated folders (e.g., `skills/`, `.git/`, `__pycache__/`).
- Handles merge conflicts and uses safe push strategies.
- Provides Python API and CLI usage examples.
- Includes error handling for common issues like missing directories or permissions.
Metadata
Frequently Asked Questions
What is workspace-git-sync?
将 OpenClaw workspace 目录（~/.openclaw/workspace/）同步到指定的本地 Git 仓库， 自动执行 git add、commit 和 push 操作。 使用场景： - 备份 workspace 文件到 Git 仓库 - 将工作目录同步到远程备份 - 定期归档 OpenClaw... It is an AI Agent Skill for Claude Code / OpenClaw, with 115 downloads so far.
How do I install workspace-git-sync?
Run "/install workspace-git-sync" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is workspace-git-sync free?
Yes, workspace-git-sync is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does workspace-git-sync support?
workspace-git-sync is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created workspace-git-sync?
It is built and maintained by David668HAHA (@david668haha); the current version is v1.0.0.
More Skills