Quickstart

Requirements: Linux, git, at least one supported coding agent, and two machines with clones of the same repository.

Get access

Join the C3Sync beta waitlist. Your beta invitation includes the release for each enrolled Linux machine and the integrity-verification steps for that cohort.

Guided setup

On the machine that will host the hub:

c3sync setup

Choose host the hub on this machine. The wizard creates the trust chain, starts the embedded NATS hub, enrolls the first device, and installs background services.

On each additional machine:

c3sync setup

Choose join and provide the hub address, TLS PIN, enrollment credentials, and master passphrase from the first setup.

Enable a project

Run this from a git working tree on every machine:

cd ~/code/myproject
c3sync enable

Clones with the same origin and root commit join the same project identity even when their local paths differ.

Verify the system

c3sync status
c3sync sync
c3sync checkout --list

Open a supported agent on one machine. After a turn completes, verify that the session appears natively on the second machine and that its working tree receives the same file state.

c3sync status also reports each project's git position (up to date / behind / ahead). When you commit and push on one machine, the others fast-forward automatically — see git integration.

Headless secret storage

When an OS keyring is unavailable, configure the encrypted-file backend before setup:

export C3SYNC_KEYSTORE_FILE=1
export C3SYNC_KEYRING_PASSWORD='<a strong password>'

The guided setup records these settings in the service it installs.