Agent-Sync

Remote sync

Move project sessions between machines through a private sidecar Git repo. Conversations stay attached to the right branch and commit — never to your source history.

Local migration

Switch Codex model_provider? clone-local copies current-project Codex sessions to the active provider and registers them in the UI; watch-local keeps doing it automatically.

Cross-tool transform

Normalize any synced bundle through the Conversation IR and re-emit it as readable Claude or Codex JSONL. Conversations become portable across tools.

Diagnose & stay safe

doctor checks the whole chain, privacy scans for secrets before any push, conflicts quarantines divergent sessions, and the TUI ties it all together.

Agent conversations are real work. Treat them like it.

Not just syncing

Remote sync started it — but the same toolbox now migrates providers locally, transforms sessions across tools, and diagnoses the whole chain.

Structured ownership

Sessions are matched by cwd, remote, branch, commit, and workdir — not transcript text. Different projects never cross-contaminate.

Source stays clean

Sessions live in a separate .agent-sync-store/ sidecar repo. Your business commits contain only source code.

A complete sync, replayed as a concrete example.

The example project is shop-admin. The left side is a sequence diagram; every step adds an action. The right side shows the exact data created, read, or changed.

git-agent-sync simulator1/12

STEP 01

Initialize project

The tool reads the current project remote, then creates local config plus a standalone sidecar Git repository.

completed

$git agent-sync init --remote git@github.com:wood-q/agent-session-store.git

Data changed in this step.agent-sync/config.json

{  "projectName": "shop-admin",  "projectIdentity": "git:github.com/wood-q/shop-admin",  "projectId": "shop-admin-a18c4f2d09",  "storePath": "/repo/shop-admin/.agent-sync-store",  "remote": "git@github.com:wood-q/agent-session-store.git"}

Terminal outputCLI

agent-sync initialized for shop-admin

store: /repo/shop-admin/.agent-sync-store

project id: shop-admin-a18c4f2d09

STEP 1/12Create project identity

Agent-SyncA toolbox for your AI coding sessions