Install

Pre-1.0

agentsync is pre-1.0. Per semantic versioning, the interfaces may still change in breaking ways before v1.0.0 — both the programmatic API (Go package surface) and the CLI surface (commands and flags). The core functionality is considered stable: the three-state model, the canonical ~/.agentsync/ schema, and the apply/reconcile behavior are solid and safe to rely on. We avoid gratuitous interface churn and call out any breaking change in the changelog.

Package managers (recommended)

macOS

brew tap spxrogers/tap
brew install agentsync

Windows

Scoop:

scoop bucket add spxrogers https://github.com/spxrogers/scoop-bucket
scoop install agentsync

Chocolatey — pending: the package is in the community moderation queue and not yet installable (publishing is paused until it clears review — see issue #188):

choco install agentsync

Linux

Pick the package for your architecture (amd64 or arm64).

Debian / Ubuntu:

curl -fsSL https://github.com/spxrogers/agentsync/releases/latest/download/agentsync_linux_amd64.deb -o agentsync.deb
sudo dpkg -i agentsync.deb

RPM:

sudo rpm -i https://github.com/spxrogers/agentsync/releases/latest/download/agentsync_linux_amd64.rpm

Arch (AUR) — wired but not published yet (issue #13); use the .deb/.rpm or prebuilt binary for now:

yay -S agentsync-bin

From source

Prefer to build it yourself, or want the latest unreleased commit?

go install github.com/spxrogers/agentsync/cmd/agentsync@latest

Or clone and build:

git clone https://github.com/spxrogers/agentsync
cd agentsync
go build ./cmd/agentsync

You’ll need Go ≥ 1.26.2 (the version pinned in go.mod).

Verify

agentsync --version

Run a health check

Once installed, doctor confirms your environment is ready — PATH, home and state writability, config schema, and the secrets backend:

agentsync doctor

1. Install the binary (above).

2. Initialize your config directory:

   agentsync init

3. Continue to your first sync.