RoBrain 是一个自托管的决策记忆系统，用于在团队和 AI 编码智能体之间共享记忆，并对“什么值得保留”做出判断。其目标不是单纯存储发生过的事情，而是帮助人和智能体避免重复已否决的方案。
用途 RoBrain 记录团队及其智能体做出的决定，以及他们排除掉的替代方案，无需人工打标签。它还针对“决策遗忘”的问题：一个已被团队拒绝的方案，可能被没有相关记忆的智能体再次提出。官方称，在缺乏决策记忆的情况下，编码智能体在多达 10 个任务中的 9 个会重新提出团队已经拒绝的方法；通过 RoBrain 完整流程，在五次归档运行中为 50 个任务 0 次重提。
主要能力
- 被动捕获：Sensing 捕获会话轮次，Perception 将每个决策提取到 Postgres，每行可携带结构化的 rejected[] 字段（被拒绝的备选方案）。
- 判断层：Batch Synthesis 读取整个语料，标记矛盾、立场漂移和反复出现的实体，这些是单个会话看不到的。
- 三遍合成：drift（立场在没有明确反转的情况下移动）、contradictions（来自不同会话的不兼容决策）、entity promotion（反复出现的工具/模式被压缩进 planning_blocks）。它把标记和边写入数据库，不捕获新决策。
- 决策生命周期（active / superseded / invalidated）与决策图（conflicts_with / extends / related_to）。
- 评审：通过 npx robrain review 查看合成发现。
- 接入 git 的决策账本（可选）。
- 安全：默认启用 secrets redaction，在捕获和入库两处擦除 API 密钥、令牌、私钥、连接字符串密码；支持全本地模式，提取与嵌入运行在 OpenAI 兼容的本地服务器（Ollama / LM Studio / vLLM）。
使用方式 提供两种运行方式。 选项一，自托管（免费、开源）：全部运行在本地——自有 Postgres、自有 API 密钥，数据不离开本机。无需克隆，robrain up 会拉取已发布的 Perception 镜像并把凭据生成到 ~/.robrain/stack/.env。默认路径使用 Anthropic（提取）+ OpenAI（嵌入）；也支持仅 OpenAI、Gemini、其他嵌入、全本地等配置。 选项二，Rory Plans 云（托管）：无需托管、无需密钥，包含在付费 Rory Plans 计划中。在 roryplans.ai 登录、创建 API token，安装时粘贴即可；无需 Docker、数据库、LLM 或嵌入密钥。 安装后，init-project 会为每个仓库生成 CLAUDE.md 和 AGENTS.md（Codex CLI），Cursor 还会得到 .cursor/rules/robrain.mdc（alwaysApply: true）。Claude Code 自托管用户可加装基于 hook 的捕获与任务前对已否决方案的预警；Codex CLI / IDE 也获得相同的生命周期 hook，由 robrain install 自动写入 ~/.codex/config.toml；Hermes 通过 npx robrain install --hermes 安装独立记忆提供者插件。跨工具统一配置可覆盖 Claude Code、Cursor、GitHub Copilot（VS Code）和 Codex CLI，指向同一个 Postgres 存储；分类器 LLM 可选 Anthropic Haiku 或 OpenAI。
适用场景 编码是首个垂直领域，因为反馈回路紧——回滚、事故和返工让“遗忘否决”的代价可度量。同一架构也适用于智能体做出跨会话决策的任何场景。典型情形：某人在 Cursor 中决定不让 Perception 迁移到 Express，新同事第二天在 Claude Code 中又提出完全相同的改动，RoBrain 在智能体走向已被否决的路径前呈现记录在案的理由。
限制与要求 自托管需要 Docker + Docker Compose（运行 Postgres 和 Perception）、Node.js 与 pnpm（构建和 CLI）、分类器 LLM 密钥（Anthropic Haiku 或 OpenAI）或本地 OpenAI 兼容服务器、嵌入密钥（如 OpenAI）或同一本地服务器。记忆语料由 PERCEPTION_API_KEY 保护，Perception 在密钥为空时拒绝启动。升级流程与其他细节、故障排查见官方文档。项目采用 Apache 2.0 许可，由 Rory Plans 构建。
