원문 pacifio/atlas · tryatlas.cc · 문서 docs.tryatlas.cc 저장소 메타(2026-10-10
gh api확인): Apache-2.0, Rust, 2026-05-14 생성, Stars 약 9,500, 최신 릴리스alpha-0.3.4(2026-09-27). raw는 에이전트가 README·ARCHITECTURE·CONTRIBUTING을 한국어로 정리한 문서(2026-09-28 기준)다. 핵심 주장은 README 원문과 대조했다.
한 줄 요약
Atlas는 “코딩 에이전트를 위한 소스 컨트롤”을 표방하는 데스크톱 앱이다. Claude Code, Codex, Atlas 자체 에이전트, ACP 레지스트리 에이전트를 같은 코드베이스에서 나란히 돌린다. 세션마다 프롬프트·도구 호출·추론을 기록해 그 세션이 만든 커밋에 체크포인트로 연결하고, 모든 에이전트가 읽고 쓰는 공유 메모리를 둔다.
무엇을 풀려는가
| 문제 | 기존 | Atlas |
|---|---|---|
| 변경 이유 | 모델이 쓴 커밋 메시지만 남음 | 커밋 ↔ 세션(프롬프트·도구 호출·추론) 체크포인트 |
| 에이전트 전환 | Claude Code는 Codex 기록을 못 읽고, 그 반대도 마찬가지 | 공유 메모리 한 곳을 모든 에이전트가 읽음 |
| 컨텍스트 분산 | 지식 노트, CLAUDE.md, AGENTS.md, 에이전트별 메모리 파일 | 하나의 인덱스로 접고 @ 멘션으로 참조 |
핵심 구조
- 에이전트 3종: Claude Code·Codex는 외부 프로세스로 ACP(Zed의 Agent Client Protocol, JSON-RPC/stdio)를 통해 붙는다. Atlas 네이티브 에이전트는 인프로세스로 돈다. README는 이것을 “Apache-2.0 업스트림의 하드 포크”라고 하고, raw 정리는
vendor/codex(Codex 엔진)로 적는다. Cursor·OpenCode·Kilo Code 같은 ACP 레지스트리 에이전트는 Marketplace에서 설치한다. - 체크포인트: 세션은 시크릿을 지운 뒤
.atlas/sessions.db(SQLite)에 기록된다. 터미널이나 다른 에디터에서 한 커밋, Atlas를 닫은 상태의 커밋도 세션에 연결된다. amend·rebase 뒤에는 patch-id로 다시 맞추고, squash로 모호해지면 추측하지 않고 orphan으로 둔다. - 공유 메모리: 로컬 임베딩과 HNSW 검색을 쓰는 온디바이스 시맨틱 인덱스다. 결정·파일 변경·실패·아키텍처 노트가 쌓이고, Claude Code가 내린 결정이 Codex의 다음 프롬프트에 나타난다.
@멘션: 파일·폴더·심볼·브랜치·커밋·노트·스킬·논문·과거 세션을 전송 전에 로컬에서 해석한다. 폴더는 경로로, 스킬·논문·세션은 본문으로 넣는다.- 잠금 없음: 노트는 마크다운(
.atlas/knowledge/), 캔버스는 JSON, 세션은 JSONL로 둔다. 쿼리 대상인 체크포인트 기록만 SQLite다.
그 밖의 표면
에디터(CodeMirror), 레인 그래프가 있는 Git 패널, 블록 터미널, arXiv·Semantic Scholar 검색, WebKit 브라우저 탭, 최대 3칸 분할 보기, 에이전트 사용량 대시보드(Mission control)가 한 앱에 들어 있다. 스킬은 SKILL.md를 에이전트별 디렉터리에 symlink해 켜고, GitHub 저장소 단위 Pack은 skills.sh 인덱스로 찾는다.
구현과 배포
- Tauri v2 + Rust(Tokio) 백엔드, React 19·TypeScript·Tailwind v4 프런트엔드. 프런트엔드는 파일시스템·프로세스에 직접 접근하지 않고
invoke()/listen()만 쓴다. - 채팅 메시지·문서 텍스트·터미널 바이트는 Rust 쪽이 소유하고 Zustand에는 UI 상태만 둔다. 스트리밍 처리량을 위한 의도된 경계다.
- 지원 플랫폼은 macOS 13+(
.dmg)와 Windows 10+ x64(.msi). Linux는 빌드는 되지만 테스트되지 않았다. - 계정 없이 로컬에서만 동작하고, 계정은 조직·기기 간 동기화에만 필요하다. 익명 사용 분석은 기본 켜짐(코드·프롬프트는 수집하지 않음,
TELEMETRY.md에서 끄는 법 안내). main은 항상 최신 릴리스와 같고, 작업은0.2.5같은 버전 브랜치에 모았다가 merge하면 그것이 릴리스다.
볼 점
- 세션 기록 통합 도구는 이미 여럿 있다(2026-08-23-github-kenn-io-agentsview, 2026-08-23-github-iamcorey-wake). Atlas는 기록을 커밋 단위 체크포인트로 묶는다는 점이 다르다.
- 에이전트 간 공유 컨텍스트라는 방향은 2026-10-04-github-traycerai-traycer와 겹친다. 메모리를 온디바이스 인덱스로 두는지가 비교 지점이다.
- 아직 alpha(0.3.x) 단계이고, 네이티브 에이전트의 출처 표기는 README와 raw 정리가 다르다(위 참고).
관련
- moc-ai-coding-ops-console — 여러 코딩 에이전트를 묶고 감사하는 도구들
- moc-ai-agents-memory — 에이전트 메모리
- codex