AgentSync¶
Snapshot, encrypt, and sync AI agent configs — Claude, Cursor, Codex, Copilot, VS Code — across machines via a Git vault.
AgentSync is a CLI and background daemon that captures the local configuration of your AI coding assistants, encrypts each artifact with age recipients, and stores the result in a private Git repository (the vault). Pull on any other machine and you have the same agents, the same skills, the same workflows — without ever putting plaintext secrets in Git.
Why?¶
- One source of truth across machines. Move from your laptop to a desktop without re-installing agents or losing skill bundles.
- Encryption is non-negotiable. Every byte in the vault is encrypted before it leaves your machine. The Git remote sees ciphertext.
- Sanitizer first. Hard-coded never-sync patterns and literal-secret detection abort the push before anything is written.
- Fast-forward only. Reconciliation refuses divergent history rather than silently merging.
Where to next?¶
-
Get started in five minutes
Install the CLI, create your first vault, push from machine A, pull on machine B.
-
Understand the system
A high-level tour of the encrypt → sanitize → reconcile pipeline, then a deep dive into the internals.
-
Look up a command
Every flag for
init,push,pull,daemon,key,skill, … -
Operate it day-to-day
Daemon installs, key rotation, troubleshooting, vault migrations.
Project status¶
AgentSync is pre-1.0. The vault format is versioned and migrations are
shipped through agentsync migrate — see Migrations. The
public CLI surface is stable; internal APIs may move between minors.