repo-sync
Manage automatic Git syncing on macOS with repo-sync. Use only when the user explicitly invokes /repo-sync.
Install / Use
npx skills add davidondrej/skills --skill repo-syncInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Our assessment of repo-sync
repo-sync scores 88/100 on our quality scale, 1511th of 2,790 Automation skills we index.
Its SKILL.md is 5.3 KB long, well organised into 8 sections with 6 code examples: a solid amount of guidance for an agent.
With 4,079 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so repo-sync is actively maintained.
- Our last check on 2026-11-01 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
repo-sync compared with similar skills
All 4 of these similar skills score higher than repo-sync; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| repo-sync (this skill)by davidondrej | 88 | 4.1k | 53d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
Frequently asked questions
- How do I install repo-sync?
- Run
npx skills add davidondrej/skills --skill repo-sync. The install tabs above show the steps for each supported agent. - Which AI agents does repo-sync work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is repo-sync safe to use?
- It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is repo-sync still maintained?
- The repository was last updated about 2 months ago, so repo-sync is actively maintained.
Skill content
View source on GitHubname: repo-sync description: Manage automatic Git syncing on macOS with repo-sync. Use only when the user explicitly invokes /repo-sync. disable-model-invocation: true
repo-sync
What it does
Sync shared Git repos for team documents, notes, skills, and context on macOS. Complex software projects and pull request workflows are outside scope.
By default, after 60 seconds without local edits, repo-sync commits eligible non-ignored changes (including staged edits, renames, and deletions), rebases, and pushes. It checks remote changes every 60 seconds and starts at login without an AI agent.
Only the remote's default branch syncs (origin/HEAD, falling back to main). Feature branches and detached HEAD are skipped; branches are never switched.
Check first
command -v repo-sync
repo-sync help
Installed help is the command contract. Older binaries may lack skill, remove, status, or version; run repo-sync version when listed. Installing the skill does not install or upgrade the binary.
Default config: ~/Library/Application Support/repo-sync/config.json. Check ProgramArguments in ~/Library/LaunchAgents/com.vectal-labs.repo-sync.plist for a custom path and use the selected config throughout. Flags precede positional arguments.
Read references/operations.md for custom settings, unsupported commands, legacy removal, upgrades, or failed checks.
Start syncing
A request to sync a named repo authorizes automatic commits and pushes. Mention that staged changes are included; do not ask again when already authorized.
For a fresh installation:
brew install --cask vectal-labs/tap/repo-sync
repo-sync setup
repo-sync status
Homebrew must already be available; it installs Git and GitHub CLI. Setup checks identity/access and service health, and preserves existing registrations. Select only requested repos.
For an existing local clone:
repo-sync add "/absolute/path/to/notes"
repo-sync status
add defaults to the current repo, which needs an origin remote. When asked to clone a remote repo, check the destination, clone, then add it. Do not overwrite folders, create remote repos, or change remotes without authorization.
For a custom config:
repo-sync add --config "/absolute/path/to/config.json" "/absolute/path/to/notes"
repo-sync status --config "/absolute/path/to/config.json"
add may save registration despite restart failure. Check fresh status; if setup is needed, use the same config. Report registration separately from active syncing when readiness fails.
Stop syncing one repo
When installed help lists remove:
repo-sync remove "/absolute/path/to/notes"
repo-sync status
repo-sync remove --config "/absolute/path/to/config.json" "/absolute/path/to/notes"
repo-sync status --config "/absolute/path/to/config.json"
remove defaults to the current repo. For missing or moved folders, use the old configured absolute path.
Removal unregisters the repo and restarts the matching service. Files, history, local work, and pushed data remain; teammates' syncing is unaffected. In-progress Git operations may finish during shutdown.
Verify registration is absent and the service applied the change. Removing the last repo leaves an empty running service. With no background service, only config changes; manually started repo-sync run processes still need restarting.
Without remove, follow Legacy removal in the reference. Do not uninstall or delete the clone instead.
Install or maintain this skill
When help lists skill, use repo-sync skill install, then repo-sync skill status. The binary bundles the skill and references; no checkout or download is needed. Setup also offers installation. Start a new agent session afterward.
Homebrew upgrades refresh unchanged managed copies. After Go upgrades, rerun setup or repo-sync skill refresh. repo-sync skill uninstall removes unchanged managed copies, preserving customized folders, the program, and syncing service. See Agent skill installation in the reference for destinations and conflicts.
Uninstall everything
Run repo-sync uninstall only on request. After confirmation, it removes the service, settings, logs, cache, program, and unchanged managed skills. Customized skills, repositories, Git history, and shared Git credentials remain. --keep-binary retains the program; --yes skips the prompt when already authorized.
Safety and verification
- Filename protection blocks names such as
.env, private keys, and.npmrc, but does not scan contents; ordinary filenames can hide secrets. Normal syncing can unstage blocked files. - Use
repo-sync allowonly when publishing that file is explicitly authorized. - Conflicts preserve local commits, abort repo-sync's own rebase, and retry. No automatic conflict resolution or force-push; one failing repo does not block others.
- Do not reset history, switch branches, delete lock files, or override secret protection just to clear an error.
- There is no
pause,resume, orsync nowcommand. Check help before using any command. - Check exit codes and fresh status; a running service can still have repo failures. Do not create verification commits or push test files without authorization.
- Briefly report the repo, action, verification, and remaining failures.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Scrapling
103.6k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
