用途:作为项目经理,把 Claude Code、Codex 或 Pi 启动为 tmux 中的 worker,向它们发送提示、等待完成、读取输出,并可移交给人类接管。worker 以绕过权限方式运行,工具调用不再询问。
主要能力:统一 CLI csd 提供 launch、adopt、list、prune、grant-consent;每个 worker 通过 /tmp/csd-workers/bin/<tmux-name> 垫片执行 converse、send、wait-for-turn、status、read-turn、read-events、stop、handoff、session-id、events-file。worker 通过 hook(Claude、Codex)或原生扩展(Pi)把生命周期事件写入 JSONL,可实时跟踪工具调用。
用法:先运行 csd grant-consent 做一次性授权,再 csd launch [--harness claude|codex|pi] <tmux-name> <cwd>,stdout 返回垫片路径。典型流程用 converse 发送并等待,或 send + wait-for-turn 分步控制。支持并行 fan-out 与流水线模式。
限制:每个 worker 只能有一个控制器;worker 与控制器仅通过磁盘文件和事件流共享状态;垫片路径内嵌绝对技能路径,插件重装后需重新启动。csd 是透明中继而非校验器,converse/read-turn 原样返回 worker 输出,关键交付应检查磁盘产物。adopt 仅支持 Claude;Codex 和 Pi 在 stop 后会话不保留。worker 运行时状态位于 /tmp,macOS 重启会清除。
环境变量:CSD_CLAUDE_BIN、CSD_CODEX_BIN、CSD_PI_BIN、CSD_CODEX_MODEL、CSD_PI_MODEL、CSD_CONVERSE_DIAG_FILE、CSD_WORKER_DIR、CSD_SUBMIT_TIMEOUT、CSD_SUBMIT_RETRY_INTERVAL、CSD_REGISTER_TIMEOUT、HOME。
前置条件:tmux、至少一个 harness CLI(claude/codex/pi)、node。