远程同步
通过独立的私有 sidecar Git 仓库在多机之间移动项目会话。对话始终绑在正确的分支和 commit 上——绝不进源码历史。
Agent-SyncAI 编程会话的全能工具箱
同步、迁移、转换、诊断你的 Codex 和 Claude Code 对话——绝不让它们污染源码仓库。一套工具搞定 agent 会话的方方面面。
Skip to content
$
为什么需要它
Agent 对话是真正的工作成果，理应被这样对待
不只是同步
远程同步是起点——但同一套工具箱现在还能本地迁移 provider、跨工具转换会话、诊断整条链路。
结构化归属
会话靠 cwd、remote、branch、commit、workdir 匹配——不是正文文本。不同项目的会话不会互相污染。
源码保持干净
会话存在独立的 .agent-sync-store/ sidecar 仓库里。业务提交只包含源码。
Workflow
一次完整同步流程
示例项目是 shop-admin。左侧是时序图，每一步都会出现新的动作；右侧显示这一步写入、读取或改变的具体数据。
git-agent-sync simulator1/12
STEP 01
completed初始化项目
工具先读取当前业务仓库 remote，再创建本地配置和独立 sidecar Git 仓库。
git agent-sync init --remote git@github.com:wood-q/agent-session-store.git本步数据变化.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"}终端输出CLI
agent-sync initialized for shop-admin
store: /repo/shop-admin/.agent-sync-store
project id: shop-admin-a18c4f2d09
STEP 1/12生成 project identity
Install
CLI 和 VS Code 扩展都已经可以使用
bash
npm install -g git-agent-sync
git agent-sync --helpbash
git agent-sync init --remote git@github.com:you/agent-session-store.git
git agent-sync push --m "sync current agent sessions"
git agent-sync restore --latest 1