A background service for macOS and Linux that provides automated, periodic synchronization for a list of Git repositories with built-in failure isolation.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install git-sync-daemon
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install git-sync-daemon using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Git Sync Daemon?
The Git Sync Daemon is a specialized utility designed to handle the complexity of maintaining multiple synchronized Git repositories without manual overhead. By integrating this into your Openclaw Skills toolkit, you gain a reliable daemon process that monitors a central repository list and performs periodic add, commit, pull, and push operations. It is built for stability, offering independent failure isolation and native service integration for both macOS and Linux environments.
This skill is particularly valuable for developers who need to keep dotfiles, documentation, or distributed project folders in sync across different machines. It provides a structured approach to automation, ensuring that your local changes are safely committed and remote updates are pulled in the background, allowing you to focus on coding rather than repository maintenance.
Git Sync Daemon Use Cases
- Automating the synchronization of personal configuration and dotfiles across multiple workstations.
- Keeping local documentation or wiki repositories up to date with remote sources in real-time.
- Managing automated backups for high-velocity project directories to a central Git server.
- Ensuring continuous integration for local environments by pulling the latest team changes in the background.
How Git Sync Daemon Works
- The user initializes the daemon environment and registers desired repositories via the Control CLI.
- The system maintains a configuration file (repos.conf) specifying the path, remote, and branch for each tracked repository.
- The daemon engine periodically iterates through the repository list, attempting a sequence of add, commit, pull, and push commands.
- Lock files are utilized per repository to prevent concurrent access issues and ensure process integrity.
- Status logs are generated for every cycle, providing transparency and allowing for easy troubleshooting of any merge conflicts or network errors.
Git Sync Daemon Setup
To get started with this skill from the Openclaw Skills collection, follow these steps:
# Initialize the state directory and configuration
bash scripts/git_sync_ctl.sh init
# Register your first repository
bash scripts/git_sync_ctl.sh add-repo /path/to/your/repository
# Run a manual synchronization test
bash scripts/git_sync_ctl.sh run-once
# Install as a background service on macOS
bash scripts/git_sync_ctl.sh install-launchd
# Or install as a background service on Linux
sudo bash scripts/git_sync_ctl.sh install-systemd
Git Sync Daemon Data Schema & Taxonomy
The Git Sync Daemon organizes its operational data within the user's config directory to ensure portability and ease of access:
| Item | Path | Description |
|---|---|---|
| State Directory | ~/.config/git-sync-daemon |
The root folder for configuration and logs. |
| Repo List | ~/.config/git-sync-daemon/repos.conf |
A pipe-delimited file storing repo paths, remotes, and branch targets. |
| Log File | ~/.config/git-sync-daemon/git-sync-daemon.log |
A persistent record of all sync cycles and isolated failure events. |
Git Sync Daemon Advanced Features
- Failure Isolation: Errors in one repository (such as merge conflicts) do not prevent other registered repositories from syncing.
- Custom Remote Targeting: Support for specifying unique remote names and branch targets for every individual entry.
- Service Lifecycle Management: Built-in commands to install, uninstall, and check the status of launchd (macOS) or systemd (Linux) services.
- SSH Optimization: Designed to work with non-interactive SSH agents and explicit identity routing for seamless background authentication.
- Safety Guardrails: Explicitly avoids force-pushes and handles missing dependencies like Git LFS with descriptive logging.
SKILL.md
Loading
Related Openclaw Skills
Telegram Analyzer Skill
A professional toolset for AI agents to search SaaS contacts, retrieve recent Telegram messages, and manage contact metadata like stages and tags.
Music Player Skill
A local media controller that allows AI agents to manage music playback through the MPV media player and organized local directories.
QA Reviewer
A comprehensive quality assurance framework for AI agents to perform automated code reviews, execute tests, and track project health.
UniFuncs Web & Deep Research Skill
A powerful suite of web tools for AI agents to browse, search, and research the internet with high precision.
GitHub Monitor
A high-efficiency monitoring skill that tracks multiple GitHub repositories to deliver filtered, severity-based alerts and daily digests via OpenClaw.
Aleph Cloud Self-Deployment
A sophisticated skill enabling AI agents to autonomously provision, configure, and replicate themselves on the Aleph Cloud decentralized network.
Featured*
