Set up and manage automatic Git syncing for shared documents, notes, and skills on macOS. The skill guides repository registration, removal, service checks, and maintenance, with local changes automatically committed and pushed by repo-sync.
Manage automatic Git syncing on macOS with repo-sync. Use only when the user explicitly invokes /repo-sync.
Review the instructions the agent will receive before you install.
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.
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.
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.
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.
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.
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.
.env, private keys, and .npmrc, but does not scan contents; ordinary filenames can hide secrets. Normal syncing can unstage blocked files.repo-sync allow only when publishing that file is explicitly authorized.pause, resume, or sync now command. Check help before using any command.No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Work through sixteen open questions in four rounds to clarify major product decisions, risky changes, or large refactors. The agent adapts later questions to earlier answers, then turns your decisions into a step-by-step implementation plan.
Document approved decisions as concise ADRs, or architecture decision records. It preserves the user's meaning and conditions, removes conversational filler, follows the project's numbering, and presents the saved record for review.
Keep a Mac awake for a chosen duration or while a specified process runs. The skill uses built-in macOS tools to manage one session, verify that sleep prevention is active, and control whether the display stays on.
Turn a feature or refactoring idea into a concise implementation prompt for another agent. It asks focused questions one at a time, records decisions, and includes development steps, validation, and working rules.
Inspect and manage BB threads, environments, projects, and plugins through its command line interface. The skill guides agents to identify the correct targets, apply changes, and verify the resulting state.
Create, install, and debug TypeScript plugins that extend bb with custom pages, sidebar panels, CLI commands, agent tools, themes, and other features. The skill also guides development reloads, log checks, and verification of installed plugins.