captpascallv-dev

Agent Baton — AI skill for Claude Code

AI community

Local-first toolkit for a lead agent: dispatch task cards to agent CLIs, wake the original conversation on delivery, and let leads message each other.

How to install Agent Baton

This entry records only its repository, not the path inside it, so there is no exact command to give. Open captpascallv-dev/agent-baton and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Agent Baton does

Local-first toolkit for a lead agent: dispatch task cards to agent CLIs, wake the original conversation on delivery, and let leads message each other. No relay model, no model polling.

Alternatives in AI

  • Wmux — The original Windows terminal multiplexer for AI agents 353 ★
  • Oc Claw — A desktop pet that monitors your AI coding agents (OpenClaw, Claude Code, Codex, Cursor, Gemini CLI, opencode 352 ★
  • PromptEnhance — Rewrite the following prompt to be clearer, more specific, and more effective for an AI assistant 250 ★

README

agent-baton

**让一个 Lead agent 指挥一群 agent CLI:派活、等交卷、Lead 之间商量,全在本地完成,等待期间不花模型额度。**

agent-baton is a local-first toolkit for running a team of coding agents. A "lead" agent (Claude Code or Codex App) plans, dispatches task cards to cheaper agent CLIs, and reviews the results. Local programs do the waiting and wake the lead's original conversation when work is delivered; leads can also talk to each other through file mailboxes. No relay model, no polling by the model.

名字取自两种"棒":指挥手里的指挥棒(Lead 负责指挥),接力赛里的接力棒(任务在 agent 之间交出、交回)。本仓库原名 `agent-lead-wake`,旧链接会自动跳转。


它解决什么问题

一个顺手的分工是:**判断力强的模型当 Lead**,只负责理解需求、写任务卡、验收;**便宜、额度多的执行者**(各家 agent CLI)负责埋头干活。真这么用起来,会卡在三件事上:

  1. 派活:每家 CLI 的启动方式、参数和会话续接都不一样。
  2. 等:执行者一跑就是几分钟到几小时。让模型自己轮询,每查一次都要花一轮额度;另开一个便宜模型定时中转,交卷后最多还要多等一个周期。
  3. 商量:多个 Lead 各管一摊时,需要一条可靠的线来交接、提问、回执,而且不能把 Lead 之间的信混进执行者的任务里。

agent-baton 的做法是:**派活和等待都交给本地程序**。守候只看文件在不在、进程活不活,不读日志正文,也不调用模型。只有执行者真正干活、Lead 被叫醒处理交卷的时候,才消耗模型额度。


五个部分

目录 干什么 适用
`claude/` 派活 + 叫醒(Claude 侧):Claude Code 当 Lead,把任务卡派给任意 agent CLI;执行者最后写 READY.json,后台守候退出,原会话被叫醒 Claude Code(CLI / 桌面版)
`codex/` 叫醒(Codex 侧):codex-mail-wake 插件,执行者交卷时把通知投回 Codex App 的原 Lead 会话 Codex App(桌面版)
`mailbox/` Lead 之间的信箱:一封信就是一个 Markdown 文件,支持线程、回复和"需要回复"标记;本地守着来信,有信就叫醒 两个或多个 Lead 会话
`acp/` 统一插头:通用 ACP(Agent Client Protocol)客户端,驱动任何支持 ACP 的执行者;模型和档位只在对方支持时设置并回读,权限请求默认拒绝并逐条留痕 提供 ACP stdio 的 agent
`watch/` 执行观察窗:只读查看本机 CLI 进程、派单记录和交卷状态;未知如实显示,结束任务留在历史 Windows x64(成品下载)

怎么组合

              ┌──────────── mailbox/ ────────────┐
              │   Lead A ⇄ Lead B:商量、交接、回执   │
              └──────────────────────────────────┘
 Lead(Claude Code / Codex App)
   │  写任务卡
   ▼
 claude/ Dispatch.ps1 ──启动──▶ 执行者(Codex CLI / Cursor / Grok Build / PI / 任何 ACP agent …)
   │