Brigade：把一支 AI 团队塞进你的终端

想象一个场景：周一下午三点，你要在四个系统之间来回搬运同一份信息——客户在邮件里提了个需求，你要把它抄进 Notion，再在 Linear 建单，然后在 Slack 里 @ 一下同事，同时还得记住上周跟这个客户沟通过的承诺不要踩雷。多数人的做法是开五个窗口，切六次上下文，漏掉一两个关键细节。

Brigade 想做的是另一件事：把这件苦活的执行者换成一个"团队"。不是一个更聪明的聊天框，而是一群有分工、有上下级、共享同一份长期记忆的 AI 智能体。你的 WhatsApp/Telegram 消息进来，被路由到对应的智能体上，它按需调用子智能体、写进组织架构里的同级同事，最后把结论发回给你。整个过程发生在你自己的机器上，API Key 不会离开本地。

从哪里来：一个"生态而非应用"的野心

Brigade 由 Spinabot 团队开发，仓库创建于 2026 年 6 月，四个月不到就涨到 11352 星、632 次提交、9 位贡献者，版本迭代到 v1.39.0。它的 README 里有一句话很能说明定位："An ecosystem, not an app"——不是又一个聊天客户端，而是一套可以自己托管的运行时。

技术上它构建在 pi SDK（@earendil-works/pi-agent-core 等，锁定 0.79.9 版本）之上，自己往上叠了记忆、技能、子智能体、工具、组织层级、消息渠道、定时任务、扩展 SDK 和双模式存储层。仓库自带的 56 个技能目录（从 notion、obsidian、discord 到 nano-pdf、xurl、spotify-player）直接对标了 Claude Code 生态里的那套技能范式。

打个比方：它更像一家公司，而不是一个助理

多数 Agent 框架是"你 → 一个万能助手"。Brigade 的抽象是"你 → 一家公司"。

公司里有部门（department）、汇报线（reporting line）、部门总监。Brigade 把这套东西搬成了 cfg.org 配置：成员、部门、上下级关系，并且能从中推导出一条 A2A（agent-to-agent）策略，直接决定谁能给谁发消息。你可以 brigade org show 看看组织图，或者 brigade explain 让它把策略讲明白。

而"Tideline"（潮汐线）是这家公司的大脑。它不是简单的聊天记录，而是一套带来源标记（origin）的长期事实库：主人说的话和渠道里陌生人的消息被严格区分，外人的事实绝不会泄漏进你的上下文。事实会按三层衰减、写入时会去重，并且有一道"来源写入门"防止不可信来源覆写你的身份和偏好。召回走混合路线——BM25 关键词 + 一个不依赖模型的向量通道，辅以类型化的链接图，每晚还有一轮反思/固化（reflect/consolidate）任务。

真正能干什么

渠道接入。 目前支持 WhatsApp（Baileys，二维码配对）、Telegram（Bot API + 内联按钮审批）、Slack（Socket Mode）、Discord、iMessage（走 imsg CLI）、BlueBubbles（macOS server）。所有渠道走同一条入站管线：访问控制、去重、中断触发、审批路由。同一套契约被设计成可扩展的，意味着自己写一个渠道适配器是可行路径。

子智能体与并行。 spawn_agent（单个）和 spawn_agents（并行扇出），深度上限默认 3、并发子智能体上限默认 5，带中断级联和完成桥——子任务结束时唤醒父任务。

文件处理是真能用的那种。 analyze_media 能读 PDF（文本层和扫描件都行）、Word/Excel/PPT（含内嵌图片）、图片、音频、视频；写入侧的 make_document/edit_document 能创建和编辑 Word/Excel/PPT/PDF——填模板和表单域、设单元格和公式、加图表、合并/拆分/盖章/加水印 PDF，全程用纯 JS 库，不用沙箱。

1000+ 连接器。 内置 Composio 工具（owner-only），接上之后一句话就能"connect my Gmail"、"post to #team"。注意它要的是 Composio 的 PLATFORM key（ak_ 开头），不是 FOR YOU 的 consumer key，这是个容易踩的坑。

技能系统。 往工作区扔一个带 SKILL.md 的文件夹，下次对话就被发现。技能是"提示词驻留"模式——只有名字和描述进系统提示，正文按需读取。六个发现源按优先级合并，还能按操作系统、必需二进制、环境变量做资格过滤。

其他。 定时任务支持 cron 表达式（带 IANA 时区和错峰）、固定间隔、一次性时间点；MCP 双向——既能把自己的长期记忆暴露给任意 MCP 客户端，也能接外部 MCP server；存储可选本地文件系统或自托管的 Convex（带静态加密）。

上手门槛：终端优先，没有浏览器

安装路径对国内用户比较友好：curl -fsSL https://brigade.spinabot.com/install.sh | sh 这条命令会自己搞定 Node 22.12+ 的安装，不需要 root（安装脚本会搭一个用户私有的运行时）。有 Node 的话直接 npm i -g @spinabot/brigade。

首次运行是五步引导：选存储模式（filesystem 或自托管 Convex）、选 provider、连接（粘贴 API Key / 用 Claude、ChatGPT、Copilot 订阅登录 / 复用已登录的 Claude Code 或 Codex CLI 登录 / 连本地 Ollama）、选默认模型、选搜索后端。之后 brigade gateway run 起常驻网关，brigade tui 开聊天。

架构上是典型的守护进程 + 瘦客户端模式：网关（默认监听 127.0.0.1:7777）持有全部状态，TUI、brigade connect、各渠道适配器都是 WebSocket 客户端。断线、走开、回头重连，智能体照样在跑。心跳文件加上进程外 supervisor 负责在事件循环卡死时重启它，还能装成 launchd / systemd / Task Scheduler 服务。

有意思的是 v1.9.0 引入的 "B³ — Brigade Bloody Benchmark"：一条命令把你的智能体扔到公网上暴露（默认走 Cloudflare，也能自建 bore/frp/sish 中继），接受陌生人在凌晨三点来戳你的 Agent。撞门的人会撞在 401 上，因为有一把隐形的密钥。这本质上是个红队压测工具，胆量不小。

争议与局限

说难听点的话得放在前面。

没有 Web UI。 默认形态是无闪烁的终端 TUI，项目明确说"不是 Electron"。对习惯图形界面的人是一道门槛，虽然 brigade expose 能把它暴露成网页体验。

没有 Docker / Compose。 我在仓库里搜过 Dockerfile，零结果。它是"装在你自己机器上的 CLI"这个假设下设计的——你必须能管理 Node 环境、端口、后台服务。对没有运维环境的团队，这个假设就变成成本。

生态依赖偏重。 Composio 是外部 SaaS，1000+ 连接器的能力本质上是"接了 Composio 才有"，不接就只有内置工具。渠道适配器里 WhatsApp 走的是 Baileys 这类非官方库，存在账号风控的现实风险（README 自己也提到过相关话题）。

成熟度存疑。 仓库创建仅四个月，版本号已到 1.39.0，迭代极快，但也意味着接口和配置随时可能变。632 次提交里有大量 Conventional Commits 和 release-please 自动发版，版本号的高频跳动本身也说明 API 还在找形态。

测试规模与代码体量不匹配。 AGENTS.md 说有 281 个 .test.ts 文件、CI 跑 typecheck + test + build 三件套，但 TypeScript 主源码已超过 1600 万字节，覆盖率数字没有公开。

安全边界靠自觉。 项目自述"无遥测、无分析、无云端组件"，Key 以 0600 权限存在 ~/.brigade/，rm -rf ~/.brigade 就能干净抹除——这些承诺很吸引人，但凡是本地跑 Agent 的项目，真正的风险都来自 Agent 自己拿着你的凭证去调工具。brigade bloody benchmark 恰好是把这件事的代价摆到明面上。

行业意义

Brigade 把 2026 年下半年 AI Agent 生态的几个方向叠在了一起：多智能体编排（不再是串行工具调用，而是有组织图和 A2A 策略的公司结构）、长期记忆（从"聊天历史"升级为带来源和衰减的事实图谱）、技能生态（SKILL.md 目录约定成为事实标准之一）、渠道即入口（IM 是一等公民而非附属）、以及数据主权（本地优先、可选自托管后端、无遥测）。

它本质上是给 Claude Code / Codex 这类"编码向 CLI Agent"补上非编码场景的一块拼图——个人助理、渠道网关、长期个人知识库。这些方向过去需要自己拼三四个工具，Brigade 试图用单一运行时收拢。

11352 星、四个月、MIT 协议、9 位贡献者——数字本身说明这类"本地优先的 Agent 运行时"的需求是真实存在的。至于它能否从"生态宣言"走到"每天真想用"，还得看一年后的留存数据和配置格式的稳定程度。

结论

Brigade 适合这样的场景：你愿意在自己机器上装 Node、跑一个守护进程，接受终端交互，想要一个能接管日常杂事、多渠道可达、有长期记忆的 AI 团队，且拒绝把凭证交出去。

不适合这样的场景：团队需要标准化容器部署、需要一个图形界面、或者只是想快速问个问题。

MIT 协议，想试的话 curl -fsSL https://brigade.spinabot.com/install.sh | sh 就能起步。