dsh-baton: pass the baton from Claude Code or Codex to DeepSeek Harness, watch it run live, and get it handed back when it's done
dsh-baton · 中文说明
macOS · Windows (guide) · no Node.js needed · zero dependencies · MIT
dsh-baton-host
The DeepSeek Harness plugin for dsh-baton. It runs inside the Harness host (desktop app or dsh web) and serves a local, owner-only Unix socket (~/.dsh-baton/host.sock; a per-user named pipe on Windows). Through it, an MCP client can list and create workspaces, create sessions, continue a specific session, and wait for its turn to finish. All of this goes through Harness's own session controller, so the messages show up live in the Harness UI.
DeepSeek Harness 插件，配合 dsh-baton 使用。它运行在 Harness 内部，只开一个当前用户才能访问的本地套接字，让 MCP 客户端能新建工作区和对话、续接指定对话、等待任务完成。所有操作都走 Harness 官方会话服务，界面实时可见。
Create workspaces and sessions, continue a session, run live in the Harness UI labelled with the sender, get woken when it is done, no extra API key, macOS and Windows with zero dependencies
Install / 安装
Step 1: in Harness open Plugins, Add plugin, enter dsh-baton-host, Install, Enable now; it registers dsh-baton for Claude Code and Codex. Step 2: in a new chat, ask for dsh_list_workspaces
Harness → Plugins / 插件 → Add plugin / 添加插件 → dsh-baton-host → Install / 安装 → Enable now / 立即启用
That is the whole install: switched on, the plugin registers the dsh-baton MCP server (the dsh-baton-mcp package, installed with it) for Claude Code and Codex, user-wide, and Harness says so. New conversations then have the dsh_* tools. If it could not register, run npx -y dsh-baton-mcp setup. Details: dsh-baton.
装好就完成了：插件启用时会为 Claude Code 和 Codex 注册 dsh-baton MCP 服务器（dsh-baton-mcp 包，随插件一起安装），Harness 里会提示。新开的对话就有 dsh_* 工具。没能注册的话，运行 npx -y dsh-baton-mcp setup。详见 dsh-baton。
Codex needs nothing extra: from 0.6.4 it waits for a run in one dsh_wait call of up to 59 minutes, with no hook to trust. / Codex 不用额外设置：从 0.6.4 起一次 dsh_wait 最长等 59 分钟，不需要信任钩子。
Update / 更新: uninstall, then add it again; the MCP server is updated with it. Right after a release, type the exact version, such as dsh-baton-host@0.6.4. / 先卸载再重新添加，MCP 服务器会一起更新；刚发版时请输入完整版本号，例如 dsh-baton-host@0.6.4。
Remove / 卸载: uninstall, then npx -y dsh-baton-mcp setup --remove / 卸载插件后运行 npx -y dsh-baton-mcp setup --remove.
How it works / 工作原理
MCP clients call dsh-baton-mcp over stdio; it reaches the dsh-baton-host plugin inside Harness through an owner-only local socket; the plugin drives Harness sessions live, with dsh headless as fallback
Socket protocol / 套接字协议
Newline-delimited JSON: request {"id", "method", "params"}, reply {"id", "result"} or {"id", "error"}.
| Method | Params |
|---|
ping | — |
workspaces | — |
create_workspace | path, title?, create_dir? (default true) |
list_sessions | cwd?, query?, limit? |
read_session | session_id, last? |
models | — |
send | message, and session_id or cwd or workspace_id; mode? (followup | steer; left out, Harness's busy-send setting, else followup) |
status | run_id, tail? |
wait | run_id, timeout_s? |
activity | session_id |
cancel | run_id or session_id |
rename_session | session_id, title |
rename_workspace | workspace_id or path, title |
list_runs | session_id?, limit? |
answer | run_id, answers ([{ id?, choose?, text?, skip? }]) |
update_queued | run_id, action (edit | remove | steer), message? (for edit) |
DSH_BATON_SOCKET / DSH_BATON_HOME in the Harness process environment move the socket. DSH_BATON_AUTO_REGISTER=0 turns off the MCP registration.
The Plugins page reads the registration outcome from GET /dsh-baton/status on the Harness web server.
License
MIT
