pacifio/atlas

Source control for agents. Use multiple coding agents, track their changes and query them in one place

Atlas – 面向编码代理的源代码控制感知 IDE

它是什么 – Atlas 是一款桌面应用程序（macOS / Windows），将代码编辑器、Git UI、终端和知识库与 AI 编码代理运行时相结合。每次代理（Claude Code、Codex、Atlas 自己的原生代理，或任何遵循 Agent-Client-Protocol 的代理）进行更改时，Atlas 都会记录一个 检查点，将 Git 提交与产生该提交的确切提示、工具调用和推理关联起来。数据保留在您的机器上，除非您选择与团队同步。

为什么重要 – 当前的 AI 辅助开发工具丢失了更改背后的“原因”：提示、思维链和任何中间工具调用在滚动缓冲区清除后都会消失。Atlas 保留了该上下文，允许您稍后查询，并允许多个代理共享共同记忆，以便您可以在任务中途切换代理而不会丢失进度。

核心概念

概念	作用
检查点	当您提交时，Atlas 将提交与产生它的代理会话关联起来，将提示、工具调用、文件更改和推理存储在本地 SQLite 数据库（`.atlas/sessions.db`）中。
共享代理记忆	设备上的语义索引（本地嵌入 + HNSW 搜索），每个代理都可以读写，使一个代理能够看到另一个代理的计划和决策。
`@` 提及	提示中的快捷方式，可本地解析为文件、文件夹、符号、分支、提交、Markdown 笔记、论文或过去的会话。解析后的内容在发送提示之前注入，保持上下文窗口较小。
知识库	`.atlas/knowledge/` 下的纯 Markdown 笔记，与代码一起进行版本控制，并自动索引以供检索。
组织	可选的登录功能，可在队友之间同步项目、检查点和知识；其他所有功能均可完全离线使用。

主要功能（如 README 中所述）

多代理会话 – 在单独的选项卡中并排运行 Claude Code、Codex、Atlas 的原生代理或任何 ACP 注册代理；会话独立于 UI 选项卡，因此切换 UI 永远不会中止正在运行的代理。
代理感知的 Git UI – 完整的 Git 图谱、暂存、分支和差异视图；提交自动链接到产生它们的代理会话。
终端集成 – 每个终端命令记录其输出、退出代码和持续时间；您可以在 Atlas 中运行 vim、htop 等。
语义搜索和嵌入 – 设备上的嵌入允许您 @ 提及相关知识（论文、笔记、过去的会话），而无需将数据发送到云端。
技能和包 – SKILL.md 文件（全局或项目级）和 GitHub 托管的包可以添加自定义命令、子代理或钩子；它们被符号链接到代理的技能目录中。
研究工具 – 搜索 arXiv / Semantic Scholar，导入论文，并直接在提示中 @ 提及它们。
浏览器选项卡 – 原生 WebKit 视图，支持完整登录/cookie 支持和阅读器模式。
空间 – 基于 JSON 的空间板，用于可视化笔记和链接。
遥测 – 匿名使用指标默认开启，但可以禁用；绝不发送代码或提示。

工作原理（高级流程）

用户在聊天窗格中编写提示。
Atlas 在本地使用 Rust 解析任何 @ 提及（文件、笔记、过去的会话等）。
它将解析后的内容、共享记忆快照和简短的“会话交接”事实包注入提示中。
提示通过 Agent-Client-Protocol（ACP）发送到所选代理 – 要么作为外部子进程（Claude Code、Codex），要么作为进程内原生 Atlas 代理。\n在会话期间，每次工具调用、文件读/写和生成的补丁都会被记录。当用户稍后提交时，Atlas 观察 Git 操作，将生成的补丁 ID 与存储的会话匹配，并创建检查点条目。

典型工作流程

打开项目 – Atlas 在仓库旁边创建一个 .atlas/ 文件夹。
启动会话 – 选择一个代理（例如 Claude Code），并要求其实现一个功能。
@ 提及 一个文件或设计文档；代理接收路径，而不是整个文件内容。
代理进行更改 – Atlas 应用补丁，更新共享记忆索引并记录工具调用。
提交 – Atlas 将新提交作为检查点链接到会话。
切换代理 – 使用 Codex 打开新选项卡；共享记忆使 Codex 能够看到 Claude 的计划，因此工作可以无缝继续。
稍后审查 – 选择一个检查点，打开聊天并询问“您为什么更改此函数？” – 代理使用原始推理进行回复。

可用性和入门

下载 – 在 tryatlas.cc 或 GitHub 发布页面上提供预构建的 macOS .dmg（Apple Silicon 或 Intel）和 Windows .msi。
从源代码构建 – 需要 Bun、Rust 和特定平台的构建工具（macOS 上的 Xcode CLI，Windows 上的 MSVC C++ 工作负载，Linux 上的 GTK 3/WebKit2GTK）。仓库包含用于开发和生产的脚本（bun run dev:app、bun run build:app:*）。
文档 – 完整文档位于 https://docs.tryatlas.cc/，涵盖聊天、记忆、编辑器、Git 集成、组织同步等。
社区 – Discord 服务器、问题跟踪器和贡献指南从 README 链接。

许可证

Apache License 2.0（根据 LICENSE 文件）。

底线

Atlas 是一款功能齐全、本地优先的 IDE，将 AI 编码代理视为软件开发生命周期中的一等参与者。通过将提示、工具调用和推理与代码一起持久化，它为开发人员提供了更改生成方式的可审计历史，并允许多个代理在不丢失上下文的情况下协作。