agentsync

name	agentsync
description	跨 AI Coding Agent 会话同步工具。在 OpenCode、Claude Code、Codex 之间迁移会话历史，保留完整对话上下文。 触发条件： - 用户说"迁移会话"、"导出到 XX"、"同步历史" - 用户说"把 X 的会话迁移到 Y" - 用户需要在不同 Agent 之间切换工作 - 用户说"备份会话"或"迁移到 [OpenCode/Claude Code/Codex]" - 用户询问"怎么在另一个 Agent 里继续这个对话" 使用前必须确认： 1. 源 Agent（会话来源） 2. 目标 Agent（会话去向，可多选） 3. 要同步的会话 ID（最多 10 个） 注意：agentsync 是一个独立的 CLI 工具，需要已安装到系统 PATH 中。

AgentSync - 会话同步工具

跨 Agent 会话迁移，支持 OpenCode、Claude Code、Codex 三个平台。

工作流程

1. 列出源 Agent 的会话 - 获取会话 ID 列表
2. 查看会话详情（可选）- 确认要同步的内容
3. 执行同步 - 将指定会话迁移到目标 Agent

可用命令

列出会话

agentsync list <agent> [--json]

• <agent>: opencode | claude-code | codex
• --json: 以 JSON 格式输出

示例:

# 列出 Claude Code 的所有会话
agentsync list claude-code

# 以 JSON 格式输出
agentsync list claude-code --json

查看会话详情

agentsync view <agent> <session-id> [--json]

显示会话的完整消息历史（简化格式，每条消息显示前 100 字符）。

示例:

agentsync view claude-code abc-123-def

搜索会话

agentsync search <agent> <keyword> [--limit <n>] [--json]

按标题关键词搜索会话。

示例:

# 搜索标题包含 "html" 的会话
agentsync search claude-code html

# 最多返回 5 个结果
agentsync search claude-code html --limit 5

导出会话

agentsync export <agent> <session-id> -o <output-file>

将会话导出为 JSON 文件（UnifiedSession 格式）。

示例:

agentsync export claude-code abc-123-def -o /tmp/session.json

同步会话

agentsync sync -s <source> -t <targets> -i <ids> [--dry-run] [--json]

参数:

• -s, --source <agent>: 源 Agent
• -t, --target <agents>: 目标 Agent（多个用逗号分隔）
• -i, --ids <ids>: 会话 ID（多个用逗号分隔，最多 10 个）
• --dry-run: 预览模式，只显示会同步什么，不实际执行
• --json: 以 JSON 格式输出结果

示例:

# 同步单个会话到单个目标
agentsync sync -s claude-code -t opencode -i abc-123

# 同步多个会话到多个目标
agentsync sync -s claude-code -t "opencode,codex" -i "id1,id2,id3"

# 预览模式
agentsync sync -s claude-code -t opencode -i abc-123 --dry-run

# JSON 输出
agentsync sync -s claude-code -t opencode -i abc-123 --json

完整工作流程示例

场景：用户说"把 Claude Code 的会话迁移到 OpenCode"

# 1. 列出 Claude Code 的会话
agentsync list claude-code

# 2. 用户确认要同步的会话 ID 后，执行同步
agentsync sync -s claude-code -t opencode -i <session-id>

# 或者用预览模式先确认
agentsync sync -s claude-code -t opencode -i <session-id> --dry-run

场景：用户搜索特定会话

# 搜索标题包含 "html" 的会话
agentsync search claude-code html

# 找到后同步
agentsync sync -s claude-code -t opencode -i <found-id>

注意事项

1. 会话 ID 限制: 一次最多同步 10 个会话
2. 目标 Agent 可多选: 支持同步到多个 Agent，用逗号分隔
3. JSON 输出: 所有命令都支持 --json 参数，便于脚本解析
4. 错误处理: 命令失败时返回非零退出码，错误信息输出到 stderr

支持的 Agent

• opencode - OpenCode
• claude-code - Claude Code
• codex - Codex

数据格式

同步时会保留完整的会话上下文，包括：

• 所有用户和助手的消息
• 工具调用和结果
• 时间戳信息

系统注入的消息（如 <environment_context>、AGENTS.md 指令等）会被自动过滤，不会同步到目标 Agent。