AI导哈

Claude tmux编排工具

通过tmux编排多个Claude Code实例的服务，支持并行任务管理和会话控制。

  • by Ilm-Alan
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 Ilm-Alan/claude-tmux

使用说明

克劳德·特穆克斯

MCP服务器，用于通过tmux编排多个Claude Code实例。

安装

添加到您的Claude Code MCP设置中：

{
  "mcpServers": {
    "claude-tmux": {
      "command": "npx",
      "args": ["-y", "claude-tmux"]
    }
  }
}

需求

工具

产卵

在tmux会话中启动一个新的Claude Code实例。

spawn(name, prompt, workdir)
  • name：唯一会话名称（例如，“重构身份验证”、“调试api”）
  • prompt：发送给Claude的初始提示
  • workdir：Claude操作的工作目录

读

等待Claude会话完成工作并返回终端输出。

read(name: "task-name")           // single session
read(names: ["a", "b", "c"])      // parallel wait on multiple sessions

对于多个会话，请使用 names 并行等待-全部完成后返回所有输出。

发送

向正在运行的Claude会话发送后续消息。

send("task-name", "do something else")

列表

列出所有活动的Claude tmux会话。

list()

杀死

终止Claude tmux会话并清理资源。

kill("task-name")

使用模式

spawn(name, prompt, workdir)  → start session
read(name)                    → wait for completion, get output
send(name, text)              → steer with follow-up
read(name)                    → wait again
kill(name)                    → cleanup

对于并行任务：

spawn("task-a", ...)
spawn("task-b", ...)
spawn("task-c", ...)
read(names: ["task-a", "task-b", "task-c"])  → wait for all

怠速检测

read 通过以下方式检测完成：

  1. 完成指示器 -克劳德的状态线显示 ✻ model for Xm
  2. 稳定性 -输出在10秒内保持不变（处理不显示指示器的亚分钟任务）

超时时间为15分钟。

提示

  • 在终止之前，验证输出是否显示任务完成。闲置的代理可以继续运行。
  • 手动连接： tmux attach -t claude-<name>

相关 MCP