第 119 期 · GitHub 今日趋势
Atlas:给 AI 编码 Agent 配一套会记事的源代码管理
判断:如果你同时跑 Claude Code、Codex、Cursor 多个编码 Agent,却总在“它昨天为什么这么改”上卡住,Atlas 值得一试——它把每个 Agent 的改动都记下了“是谁、为什么”。
它到底是什么
Atlas 把“源代码管理”的概念从代码本身,扩展到了写代码的 Agent。项目官网的定义是 Source control for coding agents。它解决一个很现实的问题——现在 Agent 写了大量代码,却几乎不保留“为什么这么写”的来龙去脉。一个 prompt、几次工具调用、先试后弃的思路,全躺在终端滚动缓冲里,滚过去就没了;几个月后你只看到一条模型自己写的 commit message,却不知道当初为什么长这样。
Atlas 的做法是:每次 Agent 跑完都会生成“检查点(checkpoint)”,把这次提交和产生它的会话绑定在一起——prompt、工具调用、文件改动都放在一起,几个月后还能查。而且它把 Claude Code、Codex、自带的 Atlas Agent,以及 ACP 注册表里的任意 Agent,放到同一个窗口、同一份代码上并排跑,并共享记忆,中途换 Agent 不用从头交代背景。
怎么用
最省事的方式:macOS 直接从 tryatlas.cc 或 releases 页下载 .dmg 安装即可。想在 Linux 上从源码构建,README 给出的依赖与命令如下(Debian/Ubuntu):
sudo apt install -y libglib2.0-dev libgtk-3-dev libwebkit2gtk-4.1-dev git clone https://github.com/pacifio/atlas cd atlas bun install bun run dev:app
生产构建:
bun run build:app bun run build:app:dmg
如果用 Claude Code Agent,需要自己把 claude CLI 装好并放进 PATH;Atlas 原生 Agent 不依赖外部 CLI。
日常用法不是写命令,而是在它的 Agents 标签页里:并排拉起多个 Agent,用 @ 把文件、文件夹、符号、分支、提交、笔记甚至过往会话直接喂进 prompt;任意工具提交后,这次提交会自动关联回对应会话成为检查点;写进 .atlas/knowledge/ 的 Markdown 笔记会变成所有 Agent 共享的上下文。
优点:它真正解决的三件事
1. 每个提交都有解释:检查点把 commit 链回产生它的会话,prompt、工具调用、文件改动一起存,可随时“和那次会话对话”找回上下文;链接在 rebase、amend 后通过 patch-id 重连,不会丢。
2. Agent 之间不丢线程:Claude Code 做的决定会出现在 Codex 的下一条 prompt 里,计划、文件改动、失败记录自动共享;@ 大文件只发路径不发内容,不占上下文窗口。
3. 默认本地优先:代码、笔记、会话都留在本机,无任何账号也能离线跑;密钥在落盘前就被擦除,本地存储不会变成泄密源;同步到团队是可选的。
缺点:现在的几个坑
- 只有 macOS 是官方支持平台。Linux、Windows 能基于同一套 Tauri 代码构建,但官方明确说“未经测试”。
- 目前只有深色主题,社区已有人提浅色主题需求但尚未实现。
- 匿名用量统计默认开启,只收集粗粒度元数据、不含代码或 prompt,但你需要手动去关。
- ACP 长尾 Agent 兼容性仍在 QA;一等 MCP 支持还在路线图上,重度 MCP 用户暂时要等等。
- 从源码构建依赖 Bun + Rust stable + Xcode 命令行工具,首次编译要几分钟,门槛不低。
最终能达到什么效果
简单说:你从“一堆记不住为什么的 commit”变成“一份可追问的 Agent 工作档案”。换 Agent 不丢上下文、查旧改动能问出当初思路、团队还能按需同步。它不改变你现有的 Claude Code / Codex 订阅和工作流,只是给它们套了一层会记事的“源代码管理”。
适合谁
同时用多个编码 Agent、被“历史上下文丢失”反复折磨、且主要在 Mac 上干活的人。
不适合谁
只用单个 Agent、或主力在 Windows / Linux 上、且不想折腾构建的人。
三个坑
① 先确认你在 Mac;② 接受深色主题;③ 装完第一件事去关匿名统计。
下期预告:把多个 Agent 的“记忆”接到编辑器——Continue / Cline 类开源编码助手横向对比。
仓库:github.com/pacifio/atlas · 协议:MIT · 抓取时间:2026-09-15
