agentstack sync
Synopsis
Section titled “Synopsis”agentstack sync <subcommand>Description
Section titled “Description”sync keeps your local ~/.agentstack/profiles/ store aligned across machines.
Current backends:
- git — repo-first sync for teams and versioned profile packages
- github-gist — zero-config convenience sync via a private Gist
Recommended backend
Section titled “Recommended backend”Use git when you want the profile/package itself to be the canonical shared unit.
Use github-gist when you want lightweight personal backup/restore with minimal setup.
Subcommands
Section titled “Subcommands”| Subcommand | Description |
|---|---|
auth | Authenticate GitHub CLI and store a token for zero-config gist mode |
discover | Discover either a configured git remote (--repo) or an existing zero-config gist |
init | Initialize sync in git mode (--repo) or gist mode (default) |
restore | Initialize then pull from the selected backend |
status | Show current sync status |
pull | Pull latest changes from remote |
push | Push local changes to remote |
auto | Pull if behind, then push if ahead |
Examples
Section titled “Examples”Discover a git remote before initializing:
agentstack sync discover --repo git@github.com:acme/agentstack-profiles.git --branch mainInitialize repo-first sync:
agentstack sync init --repo git@github.com:acme/agentstack-profiles.git --branch mainRestore from a git remote on a new machine:
agentstack sync restore --repo git@github.com:acme/agentstack-profiles.git --branch mainDiscover an existing zero-config gist:
agentstack sync authagentstack sync discoverInitialize zero-config gist sync:
agentstack sync authagentstack sync initDaily workflow:
agentstack sync auto