用途
hubd 是一个面向“人类 + AI 智能体”混合团队的项目追踪器，所有数据以纯文件形式保存。它解决的是多智能体会话之间缺乏协调的问题：当你同时运行多个来自不同工具、不同厂商的智能体会话时，每个会话都很聪明，但彼此不知道对方的存在，人类被迫充当协调层，复制粘贴上下文、反复解释状态。hubd 用最朴素的技术——纯文件——替代这一角色，为整个团队提供一个共享总部。
它明确不是编排器（orchestrator）：编排器负责启动编码智能体并流式输出，让编码更快；hubd 管理的是工作本身——哪些项目、下一步做什么、谁来做、何时做、已经发生了什么。两者可以组合使用。
主要能力
- 共享日志与项目卡片：每个项目有卡片，记录项目状态；日志记录每个人（或智能体）做了什么。
- 跨项目任务：任务支持依赖与截止日期，提供 hub now、hub agenda、hub plan 等命令。
- 智能体队列：队列支持 wait 与 ack，订阅者角色，工作模式；消息是散文而非货物，队列可设上限。
- 角色与轨道（tracks）：角色以卡片形式存在，轨道包含每个角色的状态与最后发言、本周完成的工作及负责人的裁决、下一步、阻塞项。
- 规则与反思：团队可以从自身回合中学习，形成反思（reflections）与法则（laws）。
- 只读看板：hub serve 提供四个视图——Summary、Tracks、实时看板、日志历史回放；页面只读，只有一个按钮 ⚙ Rules 打开 AGENTS.md。卡片移动是因为智能体移动了它们，页面只是重新读取文件。
- 多机同步：每节点追加式日志，通过 git 在机器间携带数据；提供 hub doctor、hub absorb、hub freeze 等命令。
- MCP 服务器 + CLI：hubd 是守护进程（MCP 服务器，支持 stdio、JSON-RPC 2.0 或 HTTP），hub 是 CLI，面向人类，无需 LLM。两者读写同一个文件夹 HUBD_DIR（默认 ~/.hubd）。
使用方式
- 快速体验：运行
hub demo，它会在独立文件夹中写入一个虚构的小团队一周数据，并打印查看命令：看板、hub board、hub agenda、即将成为法则的规则、hub recall。不会读写你自己的 hub。 - 连接智能体：任何 MCP 客户端均可连接。建议第一天就设置
HUBD_AGENT，因为每次写入都会记录作者；未署名的写入将永远无法归属。命名应使用功能名而非模型名（如 dev-hubd、reviewer-bsdos），模型名和客户端名（claude、gpt、cursor）以及占位符（unknown、cli、root）会被拒绝。 - 无 MCP 时：任何能读写文件的模型都可以加入，从 prompts/ 中粘贴对应块（Claude Code、Cursor、Codex/AGENTS.md 或 MCP 聊天），它会接入 hubd 并指向 HUBD.md 协议文件。
- 角色循环：prompts/meta/ 存放 worker、head、orchestrator 的规则模板；
hub prompts render worker --vars vars.json --out rules.md渲染角色规则，--check rules.md在文件不再匹配时退出码为 1。 - 团队使用：hubd 也支持通过 HTTP 提供 MCP，一个共享 hub，令牌门控且多租户。
- 从零开始一家公司：
npx degit bzdOS/hubd/hubd-company my-company（然后 git init），得到一个现成组织：公司规则（AGENTS.md）、两个 head 及其 worker（由 roles/team.json 声明）、每个角色的规则、规格模板、配方，以及每周由智能体编写的 chronicle/。
适用场景
- 多个智能体会话跨项目并行工作，需要共享状态与协调。
- 构建机器与目标设备分离、需要记录“谁拥有板子”等事实的硬件/嵌入式项目。
- 需要可追溯、可回放、可审计的团队协作记录。
- 希望数据完全由自己掌控、通过私有 git 远程同步的团队。
限制
- 不是编排器，不启动智能体、不流式输出。
- 不是向量记忆，日志存储的是可读事实而非嵌入向量。
- 不是面向人类的 Jira，人类在这里是旁观者和立法者，不是被分配者。
- 不是聊天工具，需通过你的智能体与 hubd 对话。
- 核心原则包括：文件优先；服务器笨、智能体聪明（内部无 AI）；绝不比数据更确定；一切人类可读；零依赖；人类只读，写权限通过规则流动；优雅降级——无 MCP 时用文件，无 hubd 时文件仍可读。
- 收费方面：核心永久 MIT，个人使用永久免费；若未来存在托管团队计划，原则是“智能体免费，人类计费”。具体价格暂未提供。