Skip to content

Dotbrain为 Coding Agent 提供私有上下文

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

Dotbrain 的标志:相连的大脑图形和一个青色圆点Dotbrain 的标志:相连的大脑图形和一个青色圆点

代码仓库保持干净 ​

每个项目的 Brain 和任务跟踪都放在 ~/dotbrain/ 下。代码仓库通过被 gitignore 的链接和生成的运行时文件连到这个私有目录。Agent 在会话开始时加载上下文,私有内容不会进入提交。

让上下文推动工作向前 ​

Brain 存项目知识,设计记录当前意图,Beads 跟踪任务。一组专注的技能在整个过程中把它们串起来。

  1. 加载上下文

    从项目的术语和决策出发,在改代码之前先找出约束和未解决的问题。

  2. 敲定设计

    把方案、未知项和成功标准写进一份持续更新的设计,再拆成范围明确的任务。

  3. 处理任务

    实现并检查每个改动,把新发现反馈到设计和相关任务里。

  4. 审阅与沉淀

    审阅结果,记录证据,把有用的决策留在 Brain 里,留给下一个会话。

比如意外碰到一个 API 限制,它会先成为一个设计问题,而不是直接绕过去。定下来之后,设计和任务会把这个决策带下去。了解这些技能。

四步连接一个项目 ​

  1. 安装插件

    在 Claude Code 中,下面两行要分两次发送。Codex 用户请看安装指南。

    text
    /plugin marketplace add arminzou/dotbrain
    text
    /plugin install dotbrain@dotbrain
  2. 安装 CLI

    在 Coding Agent 里调用 wire-brain。它会按需安装 CLI 和依赖,然后连接仓库。想手动安装,请看 CLI 安装指南。

  3. 连接仓库

    如果是手动安装的 CLI,用下面的命令创建或修复项目的 Brainspace,并把它链接到仓库。

    bash
    dotbrain wire --repo ~/repos/my-app
  4. 检查连接

    只读的健康检查。通过后,在仓库里新开一个 Agent 会话。

    bash
    cd ~/repos/my-app
    dotbrain doctor

阅读文档 ​

基于 MIT 许可证发布。