ONEDEV

atlas

AI Agent OrchestrationskillRust

★ 4,756주당 +1,893조회 21

무엇인가

Atlas는 코딩 에이전트의 작업 이력을 소스 컨트롤에 결합하는 계층이다. 에이전트가 만든 커밋 하나하나를 그 커밋을 생산한 세션과 연결해, 어떤 에이전트가 무엇을 왜 바꿨는지를 추적 가능한 기록으로 규율한다. 규율 대상은 코드 변경 자체가 아니라 변경에 이르는 과정 — 프롬프트, 도구 호출, 파일 변경, 추론 — 이다.

어떻게 동작하나

동작은 파일 계층과 로컬 DB 계층으로 나뉜다. 세션은 프로젝트의 gitignore된 `.atlas/sessions.db`(SQLite)에 기록되며, 디스크에 닿기 전에 비밀이 제거된다. 노트는 `.atlas/knowledge/` 아래 마크다운, 캔버스는 JSON, 세션은 JSONL로 저장되고, 프로젝트에 이미 있는 `CLAUDE.md`와 `AGENTS.md`도 함께 읽혀 모든 에이전트의 컨텍스트로 들어간다. 커밋이 만들어지면(Atlas가 닫혀 있어도) 그 커밋이 세션에 연결되어 체크포인트가 되고, 이 연결은 리베이스와 amend를 견딘다. 프롬프트를 보내기 전에 `@`로 지시한 파일·폴더·심볼·브랜치·커밋·노트·논문·과거 세션이 로컬에서 해석되고, 임베딩도 기기 안에서 실행된다.

무엇과 다른가

프롬프트를 직접 쓰거나 `CLAUDE.md`·`AGENTS.md` 같은 규칙 파일만 두는 방식과의 차이는 읽는 주체와 연결 범위에 있다. 규칙 파일은 한 에이전트만 읽고 커밋과 연결되지 않지만, Atlas는 그 파일들을 그대로 컨텍스트로 쓰면서 세션 기록과 체크포인트를 별도 계층으로 얹는다. Claude Code가 읽은 내용이 Codex의 다음 프롬프트에 나타나고 그 반대도 성립한다. 잠금은 최소화되어 노트는 마크다운, 캔버스는 JSON, 세션은 JSONL, 에디터는 디스크 위 파일이며, 조회 대상인 체크포인트 기록만 SQLite다.

어떻게 쓰나

설치는 릴리스 페이지나 tryatlas.cc에서 macOS용 `.dmg`(Apple Silicon·Intel) 또는 Windows용 `.msi`를 받아 실행한다. Claude Code 에이전트를 쓰려면 `claude` CLI를 설치해 `PATH`에 두어야 하고, Atlas 자체 에이전트는 외부 CLI가 필요 없다. 소스에서 빌드하려면 Bun과 Rust(stable, rustup)가 필요하고, macOS는 Xcode Command Line Tools, Windows는 MSVC 빌드 도구(C++ 워크로드)를 갖춘다. 프로젝트를 열고 에이전트를 실행한 뒤 커밋하면 해당 세션이 체크포인트로 묶이고, 체크포인트를 선택해 그 세션과 직접 대화할 수 있다.

전제와 한계

지원 플랫폼은 macOS 13+와 Windows 10+(x64)이며, 같은 Tauri 코드베이스의 Linux 빌드는 테스트되지 않았다. Claude Code와 Codex는 ACP를 통해 외부 서브프로세스로 실행되고, Atlas Agent는 Codex 엔진을 하드 포크한 런타임에서 인프로세스로 돈다. ACP 레지스트리의 나머지 에이전트(Cursor, OpenCode, Kilo Code 등)는 공식 바이너리를 자동으로 받아 실행하지만 그 긴 꼬리에 대한 QA는 진행 중이다. 기본값은 로컬이고, 팀 단위 동기화는 로그인과 조직 생성이 있어야 한다.

유사 도구