用途:cmux-team 的只读帮助文档,提供使用说明、概念解释、CLI 命令参考与故障排查,回应「怎么用」「是什么」「help」类提问,不执行实际操作。
概念:借助 cmux 的终端复用功能协调多个 Claude Code 会话,自主完成开发任务的多智能体编排工具,采用四层架构:用户↔Master(对话、建任务、报进度)→Manager(TypeScript daemon,检测并分配任务、检测完成、记录日志)→Conductor(常驻 Claude 会话,自主执行任务,用 git worktree 隔离并启停 Agent)→Agent(实际实现、测试、调研,完成后停止)。上层以 pull 方式监控下层;所有任务在 .worktrees/<taskRunId>/ 内执行,main 分支保持安全,成功则合并并删除 worktree,失败则强制清理。
安装与启动:需已装 cmux 且可用 Claude Code(推荐 Claude Max)。npm install -g @hummer98/cmux-team;在 cmux 内执行 cmux-team start,启动 daemon、Master 与 3 个 Conductor,构建固定 2x2 布局,最多 3 任务并行,其余排队。cmux 退出时 daemon 自动停止。
用法:用 create-task、update-task、close-task、abort-task、restart-task、delete-task 管理任务生命周期(draft→ready→assigned→closed/aborted),支持 --depends-on、--base-branch 等选项;另有 status、spawn-agent、agents、kill-agent、trace、trace-hooks、artifacts、metrics、events 等命令,各命令可用 --help 查看详情;全命令支持 --project-root。Claude 内可用 /master、/team-spec、/team-task、/team-archive、/artifact、/docs-sync 斜杠命令。启动后自动打开 TUI 仪表盘,含 Conductor、任务、Journal、Artifacts、Settings、Issues、Metrics 等标签页与快捷键。
限制:任务文件 .team/tasks/ 禁止直接编辑,须走 CLI;任务并行上限 3;API 限流超 90% 会暂停新分配;写入非同目录 root 需确认门控。文档未提供具体收费与价格信息。