Dotbrain为 Coding Agent 提供私有上下文
让每个 Coding Agent 都能读到项目的决策、术语和任务。这些上下文有版本记录,但不放在代码仓库里。
让每个 Coding Agent 都能读到项目的决策、术语和任务。这些上下文有版本记录,但不放在代码仓库里。


每个项目的 Brain 和任务跟踪都放在 ~/dotbrain/ 下。代码仓库通过被 gitignore 的链接和生成的运行时文件连到这个私有目录。Agent 在会话开始时加载上下文,私有内容不会进入提交。
Brain 存项目知识,设计记录当前意图,Beads 跟踪任务。一组专注的技能在整个过程中把它们串起来。
从项目的术语和决策出发,在改代码之前先找出约束和未解决的问题。
把方案、未知项和成功标准写进一份持续更新的设计,再拆成范围明确的任务。
实现并检查每个改动,把新发现反馈到设计和相关任务里。
审阅结果,记录证据,把有用的决策留在 Brain 里,留给下一个会话。
比如意外碰到一个 API 限制,它会先成为一个设计问题,而不是直接绕过去。定下来之后,设计和任务会把这个决策带下去。了解这些技能。
在 Claude Code 中,下面两行要分两次发送。Codex 用户请看安装指南。
/plugin marketplace add arminzou/dotbrain/plugin install dotbrain@dotbrain在 Coding Agent 里调用 wire-brain。它会按需安装 CLI 和依赖,然后连接仓库。想手动安装,请看 CLI 安装指南。
如果是手动安装的 CLI,用下面的命令创建或修复项目的 Brainspace,并把它链接到仓库。
dotbrain wire --repo ~/repos/my-app只读的健康检查。通过后,在仓库里新开一个 Agent 会话。
cd ~/repos/my-app
dotbrain doctor