원문 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 정리가 다르다(위 참고).

관련