claude-conductor

终端 TUI 控制台，统一管理多个并行的 claude -p 任务。

任务在后台运行，完成时铃声 + 高亮通知，无需在多个终端 tab 间反复切换轮询。

安装

需要 Python 3.10+，以及已安装 Claude CLI。

git clone git@github.com:BensonJinBin/cconductor.git
cd cconductor
pip install -e .

macOS 上若有多个 Python 版本（如同时安装了 Homebrew Python 和 Framework Python），确保 pip 和 conductor 命令属于同一环境。可用 which conductor 确认路径。

使用

conductor

界面布局

┌─────────────────┬──────────────────────────────┐
│  任务列表        │  选中任务的输出               │
│                 │                              │
│  ✓ fix bug  a1b2│                              │
│  ● write doc c3d│                              │
│  ○ add test e5f6│                              │
├─────────────────┴──────────────────────────────┤
│  输入栏（新建任务 / 追加指令）                   │
└────────────────────────────────────────────────┘

操作

状态说明

任务变为 done 或 error 时，终端铃声响起。Header 副标题显示所有任务累计费用。

任务持久化

每个任务自动保存到 ~/.conductor/sessions/<uuid>.json，重启后恢复最近 max_visible_tasks 个任务。

已持久化的任务可以继续追加指令（resume 模式），跨重启不丢失上下文。

配置文件

路径：~/.conductor/config.toml（不存在时自动使用默认值）

[claude]
# 每次调用 claude 时附加的默认参数
default_flags = ["--dangerously-skip-permissions"]

[ui]
# 任务完成时是否响铃
bell_on_complete = true
# 启动时加载的最近任务数量
max_visible_tasks = 20

进程生命周期

关闭 conductor（Ctrl+Q）不会终止正在运行的 claude 子进程。任务会在后台继续执行，输出在下次启动时可恢复查看。

查看当前运行的 claude 进程：

pgrep -la claude

贡献

欢迎提交 Issue 和 Pull Request。

License

MIT