Baton
概览
作者提供的说明(英文原文)
Pass the baton between coding agents: convert sessions across Claude Code, OpenCode, Codex & more.
它能帮你做什么
我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。
- 连接方式: 在你的电脑上运行
- 传输方式: stdio
- 分类: 开发者工具
安装
选择你使用的 AI 应用,然后复制设置。
通过 1/2 项检查 · 在你的电脑上运行
第一步:你用哪个 AI?
选择你用的应用,步骤会显示在下方。
可连接 Claude,但需要先准备
需要先在电脑上安装 Node.js(只需一次) · 仅限电脑上的 Claude 应用(Windows 或 Mac),网页和手机不可用
打开电脑版 Claude 应用的设置文件
SettingsDeveloperEdit Config
粘贴这些设置并保存文件
{ "mcpServers": { "baton": { "command": "npx", "args": [ "-y", "@kasabeh/baton-mcp", "serve" ] } } }退出 Claude 再重新打开
试一试
用 Baton 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude 说正在使用 Baton,或回答中出现 Baton 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
ChatGPT 暂时无法连接 Baton
Baton 需要安装在你的电脑上,而 ChatGPT 只能连接在网上运行的服务器
你可以改用这些方式
A · 使用能连接 Baton 的应用
- 需要先在电脑上安装 Node.js(只需一次) · 仅限电脑上的 Claude 应用(Windows 或 Mac),网页和手机不可用
- 需要先在电脑上安装 Node.js(只需一次)
- 需要先在电脑上安装 Node.js(只需一次)
- 需要先在电脑上安装 Node.js(只需一次)
B · 开发者工具 类中能连接 ChatGPT 的其他服务器
从同类中使用较多的里挑选,仅限用地址即可连接、无需密钥的
- Sentry✓ ChatGPT
- Front-End Checklist✓ ChatGPT
- Compiler Explorer✓ ChatGPT
可连接 Claude Code,但需要先准备
需要先在电脑上安装 Node.js(只需一次)
打开终端
Mac:按 Command+空格,输入 Terminal · Windows:打开 PowerShell
粘贴这条命令并按 Enter
claude mcp add baton -- npx -y @kasabeh/baton-mcp serve在 Claude Code 中输入 /mcp
应能看到 Baton 在列表中并显示已连接
试一试
用 Baton 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude Code 说正在使用 Baton,或回答中出现 Baton 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
可连接 Cursor,但需要先准备
需要先在电脑上安装 Node.js(只需一次)
在 Cursor 中以 Agent 模式打开 AI 聊天
试一试
用 Baton 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Cursor 说正在使用 Baton,或回答中出现 Baton 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同
可连接 VS Code,但需要先准备
需要先在电脑上安装 Node.js(只需一次)
在 VS Code 中以 Agent 模式打开 AI 聊天
试一试
用 Baton 告诉我你能帮我做什么,然后做一件给我看✓ 如果 VS Code 说正在使用 Baton,或回答中出现 Baton 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同
开发者专用:终端命令和 JSON 设置
安装在电脑上
Claude Code
claude mcp add baton -- npx -y @kasabeh/baton-mcp serveClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"baton": {
"command": "npx",
"args": [
"-y",
"@kasabeh/baton-mcp",
"serve"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"baton": {
"command": "npx",
"args": [
"-y",
"@kasabeh/baton-mcp",
"serve"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"baton": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@kasabeh/baton-mcp",
"serve"
]
}
}
}这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
一览
哪些应用可以使用它
依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。
在你的电脑上运行,适用于
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
它能做什么
它在你的电脑上运行;安装后,工具列表会显示在你的 AI 应用中。
基础检查i
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月11日
- ! 注意
作者与仓库一致
发布者(kasabeh.tech)不是仓库所有者(Kaseban);可能是其他人代为上架的
- ✓ 通过
仍在维护
代码最后更新于25天前
- … 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
- – 不适用
端点有响应
它在你的电脑上运行,没有互联网端点
- – 不适用
使用 OAuth 登录
在你的电脑上运行,改用本地设置
- … 尚未检查
工具描述中没有隐藏指令
它在你的电脑上运行;我们只能读取互联网端点的工具列表
讨论
提问、分享技巧或报告无法使用。按“有帮助”数量排序。
用户评价
还没有评价
与“开发者工具”中的其他服务器比较i
- 星标数多于此分类中其他 5747 个服务器的 0%
- 发布到注册中心的时间比此分类中其他 5747 个服务器的 21% 更新
- 基础检查结果等于或优于此分类中其他 5747 个服务器的 12%
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
常见问题
Baton 安全吗?
它在 2 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
它需要哪些密钥或代码?
注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。
它在我的电脑上运行还是在云端?
它在你的电脑上运行。你的 AI 应用会在需要时启动它,数据不会经过作者的服务器(除非它自己调用在线服务)。
它还在维护吗?
GitHub 仓库最后更新于25天前,最新版本(0.3.0)于4个月前进入注册中心。
哪些应用可以使用它?
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Node.js。
有什么可以替代它?
同一分类中有:REA, Netdata, Front-End Checklist
替代选择
同一分类中其他作者的服务器,按星标数排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
Netdata
Real-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.
Front-End Checklist
Review frontend code and live pages against 386 quality-gated web development rules.
作者的 README
打开 README
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
Pass the baton between coding agents.
Convert any coding-agent session to any other. One command. Keep going where you left off.
A passed transcript kept 14/17 concrete facts. A hand-written handoff summary kept 3/17. Benchmark ↓
The 4 p.m. problem
It's 4 p.m. Claude Code says "usage limit reached — resets at 10 p.m." You're three hours into a session: architecture decided, edge cases mapped, half the diff written.
❌ Without baton — open another agent and start from zero. Re-explain the plan. Re-read the files. Re-litigate every decision you already made.
✅ With baton — pass the session and keep going:
baton convert --from claude-code --to opencode --latest --import
using latest claude-code session: 2026-07-09 15:58 Refactor the auth middleware to…
passed baton: claude-code → opencode (1388 messages) → handoff.json
Imported session: ses_8c4c973a521549e2
opencode -s ses_8c4c973a521549e2 # same conversation, different runner
Works in every direction: switch agents mid-task, try a second opinion on a hard bug, move a session from your editor agent to a terminal agent, or archive everything in one format.
Quick start
# zero-install run (downloads prebuilt binary)
npx @kasabeh/baton-mcp --help
convert your most recent session + auto-import into the target agent
baton convert --from claude-code --to opencode --latest --import
or omit the path to pick interactively — newest first,
each session previewed by its first user message
baton convert --from claude-code --to opencode --import
or pass an explicit session file
baton convert --from claude-code --to opencode --import
see every session on your machine, across all agents
baton list
Where do session files live?
You never have to hunt these down (--latest and the interactive picker find them for you), but for reference — each agent stores its transcripts on disk:
| Agent | Location |
|---|---|
| Claude Code | ~/.claude/projects/ / .jsonl |
| Codex CLI | ~/.codex/sessions/ / / /rollout-*.jsonl |
baton list prints the path of every session it can find, across all agents.
Supported formats
| Agent | Read | Write | Auto-import |
|---|---|---|---|
| Claude Code | ✅ | ✅ | — |
| OpenCode | ✅ | ✅ | ✅ opencode import |
| Codex CLI | ✅ | ✅ | — |
| Gemini CLI | ✅ | ✅ | — |
| Zed | ✅ | ✅ | — |
| Aider | ✅ | ✅ | — |
| Cursor | ✅¹ | —² | — |
| Continue | ✅ | — | — |
| Cline / Roo | ✅ | —² | — |
¹ Cursor reads from exported JSON (sqlite3 state.vscdb "SELECT value FROM ItemTable WHERE key='aiService:chats'")
² Not planned: Cursor and Cline keep session state inside editor databases (SQLite / VS Code globalState) with no file-level import path.
Benchmark
Does carrying the full transcript beat writing a handoff summary for the next agent? We measured both on a real 3.4 MB Claude Code session (same model both arms, only the context differs):
| session size | baton transcript | handoff summary |
|---|---|---|
| sm (93 KB) | 3/3 details recalled | 1/3 |
| md (198 KB) | 6/6 | 1/6 |
| lg (599 KB) | 5/8 | 1/8 |
| total | 14/17 | 3/17 |
The summary lost concrete facts (versions, line counts, MSRV) even on the smallest slice — the receiving agent had to re-read files and re-run commands to rediscover them. Mechanical fidelity: all 896 messages are written to every target; round-trip loss reflects each target format's expressiveness (claude-code 896/896, codex 736, gemini-cli 723, aider 111 — it stores chat text only).
We also measured task continuation: cut the session at three mid-task points, ask a fresh agent to state the task, state, and next steps. Result: parity (baton 10/12, handoff 10/12) — a good summary is enough for *what to do next*; the transcript is what answers the *specific factual questions* the summary's author didn't anticipate. And the summary only exists if an agent spends a full transcript read writing it — baton makes the transfer free.
Full methodology, caveats, and reproduction steps: benchmark/RESULTS.md.
MCP server
baton is also an MCP server — your agent can pass the baton itself, mid-conversation:
| Tool | Description |
|---|---|
list_sessions | Scan all agents, return a unified list |
convert_session | Convert a session from one format to another |
import_to_target | Convert + run the target agent's import command |
detect_format | Sniff a file/dir and report which agent produced it |
baton install # registers baton in every detected agent's MCP config
baton doctor # verify baton uninstall # remove from all agents
How it works
Claude Code session (.jsonl)
│ ▼ baton read ──► canonical Session { messages: [Text, Reasoning, ToolCall, ToolResult] } │ ▼ baton write ──► OpenCode import JSON (SessionV1 schema)
Every agent format is read into a canonical intermediate representation, then written out in the target format. Adding a new format is O(1), not O(N×M) per-pair converters.
Install
# npm (prebuilt binary, no Rust needed)
npm install -g @kasabeh/baton-mcp
Homebrew
brew install kaseban/tap/baton-mcp
Cargo binstall (prebuilt binary)
cargo binstall baton-mcp
Cargo (from source)
cargo install baton-mcp
Shell installer (prebuilt binary)
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/Kaseban/baton/releases/latest/download/baton-mcp-installer.sh | sh
Or grab a binary from GitHub Releases.
Building
git clone https://github.com/Kaseban/baton.git
cd baton cargo build --release ./target/release/baton --help
Contributing
Each format lives in src/formats/ .rs and implements the Format trait (read + write). See src/formats/claude_code.rs for a complete reference implementation.
All nine formats have readers; Claude Code, OpenCode, Codex, Zed, Aider, and Gemini CLI also have writers. The most impactful contribution now is a writer for Continue.
Regenerating the demo
The README GIF is scripted with VHS: vhs assets/demo.tape. It records against a sandboxed $HOME (/tmp/demo) populated with fabricated sessions, so no real session data ends up in the GIF.
Don't drop the baton.
License
Dual-licensed under MIT OR Apache-2.0.