dsh-baton

English | 中文

macOS · Windows（ガイド） · Node.js 不要 · 依存関係なし · MIT

Claude Code と Codex からそれぞれ DeepSeek Harness にタスクを渡すと、サブエージェントが 1 時間 41 分でこの雨の夜の街を作り上げます（40 秒、音声あり）：

https://github.com/user-attachments/assets/72e2fdff-275e-48bc-8e5a-39ffb025a0a8

実行の様子を見る

1 つの Codex チャットからタスクを開始し、追加のタスクをキューに入れ、実行中のターンに指示を出し、3 つすべての完了を待ちます：

Codex と Claude が同じ Harness セッションで交互にやり取りし、各メッセージには送信者が表示されます：

その他のデモ →

クイックスタート

DeepSeek Harness ≥ 0.2.1-rc.2（サインイン済み）と Claude Code または Codex が必要です。それ以外は不要です。Node.js もターミナルも必要ありません。手順は macOS と Windows で同じです。

1. Harness にプラグインを追加： Plugins（插件） → Add plugin（添加插件） → dsh-baton-host と入力 → Install（安装） → Enable now（立即启用）。

有効にすると、このプラグインはすべてのフォルダーで使えるよう Claude Code と Codex 用に dsh-baton を登録し、Harness がその旨を通知します。

2. 確認： Claude Code または Codex の新しい会話で、dsh_list_workspaces を呼び出すよう依頼します。Harness のワークスペースが一覧表示されます。

これで完了です。Harness が登録できなかったと表示した場合は、ターミナルで npx -y dsh-baton-mcp setup を実行してください（Node.js ≥ 22.15 が必要です）。同じ登録処理を行います。更新、削除、Windows の詳細については下記をご覧ください。

仕組み

各クライアントの待機方法（設定は不要です）：

• Claude Code はバックグラウンドで実行を待機します（dsh_send が返す wait_command）。実行が終了すると、一度だけ呼び出しが再開されます。
• Codex は dsh_wait 内で、呼び出しごとに最大 270 秒待機します。これはツールのタイムアウトである 300 秒をわずかに下回る時間です。待機中に実行が完了しなかった場合、状態だけが返されるため、Codex は要約せずに再度呼び出します。Codex には wait_command は返されません。Codex のターミナルからは呼び出しを再開できないため、ポーリングすることになります。
• Codex では MCP ツール呼び出しの承認が求められます。dsh-baton ツールを承認してください。無人の codex exec 実行には、--approve-for-me を追加してください。

ツール

CLI

dsh-baton workspaces
dsh-baton new-workspace ~/code/new-app --title "New App"
dsh-baton sessions --cwd ~/code/new-app
dsh-baton send --cwd ~/code/new-app "Scaffold the project"
dsh-baton send --session session-xxxx "Next: add tests"
dsh-baton send --session session-xxxx --mode steer "Interjection: don't change the API"
dsh-baton wait hrun-xxxx              # blocks, prints the final reply; exit 0 on success
dsh-baton status hrun-xxxx
dsh-baton activity session-xxxx       # running turn, sub-agents, background jobs
dsh-baton cancel --session session-xxxx
dsh-baton rename session-xxxx "New title"
dsh-baton rename-workspace ~/code/new-app "New name"

設定

プラグインを有効にしたときの動作。 MCP サーバーをそのまま保持されるフォルダー ~/.dsh-baton/app にコピーし、~/.claude.json と ~/.codex/config.toml に MCP エントリーを直接書き込み、それぞれのバックアップとして *.bak-dsh-baton を作成します。PATH 上に Node.js ≥ 22.15 が見つかった場合はそれを使ってサーバーを起動し、見つからない場合は Harness 独自のランタイム（Node モードの Harness アプリ、ELECTRON_RUN_AS_NODE=1）を使うため、ほかに何かをインストールする必要はありません。いずれの場合も、claude / codex が PATH 上になくても、デスクトップアプリだけがインストールされていれば動作します。Harness の起動ごとに再度実行されますが、すでに正しいエントリーや、dsh-baton の別コピーを起動する動作中のエントリーはそのまま維持されます。Harness では、パッケージ名を入力するとソースが自動的に npm レジストリ（「公式 npm レジストリ」、「npm 官方源」）に切り替わり、再起動は不要です。登録を無効にするには、Harness に DSH_BATON_AUTO_REGISTER=0 を設定します。

npx -y dsh-baton-mcp setup は、ターミナルから同じ登録を行います。プラグインが登録できなかった場合や、MCP ディレクトリから利用する場合に使います。プラグインがすでに登録されていれば何も変更せず、プラグインが見つからない場合はその追加方法を案内します。

更新。 Harness では公式プラグインのみ更新ボタンを利用できるため、Plugins → dsh-baton-host → Uninstall、続いて Add plugin → dsh-baton-host の順に操作します。リリース直後は Harness が以前のバージョンをインストールすることがあります（pnpm の minimumReleaseAge が公開直後のバージョンを保留し、インストールダイアログにもその旨が表示されます）。すぐに新しいバージョンを使うには、バージョンを指定して [email protected] と入力します。再び有効にすると、プラグインが MCP サーバーを同じバージョンに更新します。新しい会話ではそのバージョンが使われます。バージョンが一致しない場合は、それに気づいた最初のツール呼び出しで通知されます。

削除。 Harness → Plugins → dsh-baton-host → Uninstall の順に操作してから、npx -y dsh-baton-mcp setup --remove を実行します。プラグインはアンインストールと Harness の終了を判別できないため、MCP エントリーはこのコマンドが削除できるよう残します。このコマンドは ~/.dsh-baton/app も削除します。実行記録は ~/.dsh-baton に残るため、不要な場合は削除してください。

dsh-bridge からのアップグレード。 Harness で dsh-bridge-host をアンインストールしてから dsh-baton-host を追加します。有効にすると、古い dsh-bridge の MCP エントリーが置き換えられます。DSH_BRIDGE_* 変数と既存の ~/.dsh-bridge フォルダーは、今のところ引き続き使えます。ツールのプレフィックスが新しくなる（mcp__dsh-baton__…）ため、権限の許可リストを更新してください。0.4 より前に ~/.dsh-baton/app/host を貼り付けて追加したプラグインも引き続き動作しますが、npm では更新されません。これをアンインストールし、名前を指定して dsh-baton-host を追加してください。

ソースから利用する場合（main を追跡する、またはコードを変更する場合）：git clone https://github.com/JialaoLiu/dsh-baton.git を実行し、Harness でクローンの host フォルダーからプラグインを追加します（Add plugin → パスを貼り付け）。有効にすると、クローン自体が登録されるため、変更は公開前に実行できます。git pull で更新します。node dsh-baton/src/cli.mjs setup を実行すると、ターミナルからクローンを登録できます。

Windows。 手順は同じです。異なる点（ソケットファイルの代わりに名前付きパイプを使用）と、プラグインのインストールやアンインストールができない場合の解決方法については、WINDOWS.md を参照してください。

claude mcp add dsh-baton -s user -- "$(command -v node)" "$PWD/dsh-baton/src/server.mjs"
codex mcp add dsh-baton -- "$(command -v node)" "$PWD/dsh-baton/src/server.mjs"

{ "mcpServers": { "dsh-baton": { "command": "/absolute/path/to/node", "args": ["/absolute/path/to/dsh-baton/src/server.mjs"] } } }

OS ユーザーとして実行されているプロセスであれば、dsh を直接実行する場合と同じように、ソケット経由で Harness を操作できます。dsh-baton は Harness 0.2.1 系列の内部サービス API に依存するため、Harness のメジャーアップデート後に追随リリースが必要になる場合があります。

その他のデモ →

ライセンス

MIT