Hive 是面向 CLI Coding Agent 的浏览器版蜂巢（hive-mind）。 Orchestrator 本身就是一个真实的 claude / codex / opencode / gemini 进程——不是你、也不是脚本——它派单的 Worker 同样是真 CLI agent。所有 agent 都是你电脑上真实的 PTY 进程，通过 Hive 注入到 shell 里的小型 team 协议互相通信，共享 <workspace>/.hive/tasks.md 这份 markdown 任务图。

🌐 官网：hive-site.pages.dev（English）

English · 简体中文

Public preview。Hive 是本机优先的工具，只监听 127.0.0.1，面向已经在用 CLI Coding Agent 的开发者。最新发布版本见 npm，上面的 badge 会指向它。

CLI Coding Agent 各自都很强，但同时管几个就有点别扭：

• 长任务的会话散在好几个终端里，注意力来回切。
• 想把"实现 / review / 测试"分给三个 agent，却没有一层把它们路由起来。
• Worker 的进度淹在 scrollback 里，回头看找不到。
• 想重启接着干，全看每个 CLI 自己的 session 恢复行为，散乱不可控。

Hive 加上这一层调度，不替换任何 CLI。Agent 还是真实跑在你电脑上的终端进程，Hive 只是它们外面的"团队 shell"。

还没装任何 agent CLI？运行 hive、打开它打印出的本地地址、在 first-run 向导里点 Try Demo。你会看到一个完全跑在客户端的预览——假 orchestrator + 两个 worker、预录的终端 scrollback、一份预填的任务清单——既不会连服务器，也不需要任何真实 CLI agent。适合决定要不要继续装真 CLI。

前置条件：

• Node.js 22 或更新版本
• 至少一个支持的 Agent CLI 已经安装好、登录过、在 PATH 上可调用

安装并启动 Hive：

npm install -g @tt-a1i/hive
hive

打开终端打印出来的本机地址，通常是 http://127.0.0.1:3000/。如果你想指定端口，可以用 hive --port 4010。

首次使用流程：

1. 选择一个项目目录作为 workspace。
2. 挑一个 Orchestrator 预设。
3. Hive 会创建 <workspace>/.hive/tasks.md，启动 Orchestrator 的 PTY，把内部的 team 命令注入这个 agent 会话。
4. 在 Team Members 面板里添加 Worker。
5. 跟 Orchestrator 说一声让它派活，它会用 team send <worker-name> "<task>" 发任务，Worker 完事后用 team report 回报。

浏览器 UI 跑在 127.0.0.1
  任务 · 团队 · 终端 · 汇报
          |
          | HTTP + WebSocket
          v
Hive Runtime
  SQLite 元数据 · PTY 生命周期 · 任务派单
          |
          +-- Orchestrator PTY
          |     可调用：team send、team list、team report
          |
          +-- Worker PTY
          |     可调用：team report
          |
          +-- Worker PTY
                可调用：team report

Workspace 任务图：
  <workspace>/.hive/tasks.md

三个细节值得记住：

• Agent 是真正的 CLI 进程，不是模拟的 subagent。
• team 命令只在 Hive 管理的 agent 会话里可用——通过把包内 bin 目录 prepend 到 PATH 实现，不会装成全局命令。
• 任务图就是 workspace 里的一份 markdown 文件，你可以在编辑器里直接看或者改。

Hive 不替你安装这些 CLI。请在启动 Hive 的同一个 shell 环境里先装好、登录好。

• Workspace 侧边栏，方便在多个本机项目之间切换。
• Orchestrator 和 Worker 终端都是真实 PTY 支撑的。
• Add Worker 流程预置了 coder / reviewer / tester 和自定义成员的角色模板。
• .hive/tasks.md 编辑器，带外部文件冲突处理。
• PTY 后台保留 + 尽力使用各 CLI 原生 session 恢复。
• 元数据存在本机 SQLite，默认在 ~/.config/hive，或者通过 $HIVE_DATA_DIR 指定。

Hive 不提供 sandbox 隔离、多用户认证、云端托管，也没有自带的编码模型。它只负责调度你已经在用的本机工具。

所有平台都需要 Node.js 22+。Hive 依赖 node-pty 和 better-sqlite3 这类原生包，没有预编译二进制时需要你本机有原生构建工具链。

Hive 是本机开发工具，不是托管服务。

• Runtime 只监听 127.0.0.1。不要把 Hive 端口通过公网隧道、反向代理或任何共享网络接口暴露出去。
• 内置预设会主动传 CLI 的 non-interactive / bypass flag。Worker 在选中的 workspace 里有跟启动 shell 同等的执行权限——把它当成"会自动跑命令的你自己"。
• 只打开你信任的 workspace。Worker 拥有跟你登录账户一样的文件系统访问权限。
• Agent token 是 session 级的，由本机 runtime 生成，注入到 agent 进程环境变量里，不用于跨网络通信。
• Hive 不做多用户认证。任何能从本机访问到端口的进程都视为可信本地访问。
• 浏览器 UI token 只是本机会话保护，不是用来防同一系统账户下其他进程的安全边界。

在敏感仓库里用 Hive 之前，请先读 SECURITY.md。

找不到 Agent CLI

确认选中的命令已经安装好、登录好、在启动 Hive 那个 shell 里能直接调用，且在 PATH 上。

端口被占用

换个本机端口启动：

hive --port 4020

原生包构建失败

Hive 依赖 node-pty 和 better-sqlite3，它们用原生二进制。确认 Node.js 22+，清干净 package manager 缓存，并准备好你平台的构建工具（macOS Xcode CLI、Linux build-essential + python3、Windows VS Build Tools）。

Linux 上目录选择器不弹

装 zenity，或者直接在对话框里粘路径。

Windows 上目录选择器不弹

确认 powershell.exe 在 PATH 上，或者直接粘路径。

Tasks 文件冲突 banner 出现

Hive 检测到磁盘上的 .hive/tasks.md 比 UI 里的新。Reload 接受磁盘版本，Keep Local 保留 UI 编辑并覆盖保存。

Worker 卡在 working 状态

Hive 不通过进程活动猜测任务完成。Worker 只有在调 team report 时才会回到 idle。如果它确实卡了，从 UI 里 Stop 或 Restart。

pnpm install
pnpm dev

开发模式下 runtime 跑在 127.0.0.1:4010，Vite 跑在 127.0.0.1:5180，把 API 和 WebSocket 代理到 runtime。

常用命令：

pnpm check
pnpm build
pnpm test

预演 production 构建：

pnpm build
node dist/src/cli/hive.js --port 4010

Production 模式下 runtime 直接服务构建好的 web UI，不需要单独的 Vite。

维护者本地预演：

pnpm release:dry

完整 tag 发版清单见 docs/release.md，里面包含 Windows 手动 smoke 步骤。

带 v* 的 tag push 会触发 GitHub Actions release workflow。workflow 会在 macOS、Ubuntu、Windows 三平台验证，然后用 NPM_TOKEN 发布到 npm。

Hive 正处于 alpha public preview 阶段。在本机调度模型稳定下来之前，UI 和协议细节还会继续调整。

Hive 使用 Business Source License 1.1（LICENSE.BSL）。BSL 允许个人使用、内部部署、嵌入其他产品、非商业 fork；仅禁止把 Hive 包装成多 agent 协作 SaaS 卖给第三方。

详细边界见 LICENSE.BSL 的 Additional Use Grant。