octomux 是一个本地仪表盘，用于并行运行多个 Claude Code 和 Cursor 智能体。每个智能体在独立的 git worktree 中工作，避免互相干扰；所有“是否允许此工具？”的权限提示集中到一个收件箱，并提供整个智能体集群的实时网格和应用内 diff 审查。它完全运行在用户机器上，无云端同步、无遥测，采用 MIT 许可。
用途
octomux 解决的是“编写代码变快了，但管理智能体没有”的问题。它把从提示词到合并 PR 的流程集中到一个窗口，让用户能够同时指挥多个编码智能体，而不用在多个终端面板之间来回切换。
主要能力
- 调度（Dispatch）：输入任务、粘贴 Jira/Linear/GitHub 链接或整个列表，每个任务获得独立的 worktree、分支和智能体；可按任务选择模型和 harness。
- 无人值守运行：附加验证命令后，智能体会在全新上下文中循环执行，直到命令以 0 退出；可放到 cron 定时执行。将目标交给编排器后，它会规划、拆分并派发子任务，等待用户批准。
- 监控：所有智能体的实时终端集中到一个 Monitor 网格，diff 实时增长，所有权限提示收集到单一收件箱。
- 审查与交付：智能体基于真实 diff 起草走查说明和内联评论；用户在应用内阅读、标记文件已审查、把评论发回修复，接受后作为一个批量 GitHub 审查发布。octomux 通过分支识别 PR，合并后关闭任务。
- 恢复：崩溃、重启或合上笔记本后，运行
octomux start可恢复所有任务、分支和会话。
使用方式
打开 localhost:7777，描述任务，选择 Claude Code 或 Cursor 即可开始。支持 npm CLI、macOS 桌面应用（.dmg），也可托管在服务器上通过 Tailscale 从手机访问（界面已适配移动端）。默认绑定 127.0.0.1；远程模式生成随机访问令牌，路径记录在 ~/.octomux/data/remote-token，可用 OCTOMUX_REMOTE_TOKEN 覆盖。
环境要求：macOS（arm64/x64）或 Linux 用于 CLI；macOS 用于桌面应用；Node.js 20+；git（tmux 已捆绑）；至少一个 harness：Claude Code（claude）和/或 Cursor CLI（cursor-agent）。
工作流示例
- 验证者：两个智能体、两种意见。Claude 写完后，让 Cursor 在同一分支上二次审查，不同模型不继承前者的假设，可捕获类型检查通过但生产环境出错的 bug。
- 批量处理：粘贴 Jira 过滤器或 GitHub issue 列表，每个工单获得独立 worktree 和智能体，午休前可产出五个待审查 PR。
- 操作员：一个提示词变成一个 epic。给智能体编排技能后，它会规划规范、拆分子任务并分发到各自 worktree，在 Orchestrator 视图中监督。
扩展与插件
octomux 是元 harness，第三方 npm 包可注册工作流、集成提供者或 harness，无需 fork。在 ~/.octomux/octomux.yml 中列出，导出一个 apply(ctx) 函数，octomux 启动时调用。目前安装插件需手动，没有 octomux plugins add 命令。octomux plugins list 显示清单内容，octomux doctor 报告每行是否实际加载及 apply() 耗时。
安全提示：插件在进程内运行，拥有数据库句柄、所有存储的凭据和完整 process.env，没有沙箱，也不计划提供。只安装你信任其 npm install postinstall 脚本的插件。octomux start --safe-mode 可在启动时跳过所有插件行。
适用场景
需要同时运行多个编码智能体、集中管理权限提示、批量审查 diff、编排大型任务的开发者。octomux 不增加推理成本，它驱动已有的 Claude Code 或 Cursor 订阅；循环会按迭代次数成倍增加 token 消耗，因此可设置 --max-iterations 和预算。每个任务独立 worktree，主工作树不会移动；合并时仍会有正常的 git 冲突，但所有 diff 集中在一个审查队列，可 deliberate 选择合并顺序。
限制
- 当前暂无自定义 UI 视图的即插即用 API。
- 插件安装需手动。
- 没有云端同步或遥测，远程访问需借助 Tailscale 等网络。
- 完整设置、Jira/Linear 集成和编排技能参见 ONBOARDING.md。
