← 목록으로
AI-assisted content
Entire: AI 에이전트 시대의 컨텍스트 버전 관리
developer-toolsgitentire

들어가며

AI 에이전트로 코드를 작성하다 보면, 에이전트가 잘못된 방향으로 빠지는 순간이 옵니다. 수십 턴의 대화 끝에 원래 의도와 전혀 다른 코드가 나오고, 되돌리려면 어디서부터 잘못됐는지 추적해야 합니다. Git은 코드의 변경 이력을 관리하지만, 에이전트가 왜 그런 코드를 만들었는지 — 프롬프트, 추론 과정, 컨텍스트 — 는 기록하지 않습니다.

Entire는 이 빈 공간을 채우는 플랫폼입니다. GitHub가 코드를 버전 관리했듯이, Entire는 AI 에이전트의 컨텍스트를 버전 관리합니다.

배경

전 GitHub CEO Thomas Dohmke가 2025년 8월 퇴임을 발표하고, 2025년 말 GitHub을 떠난 뒤 2026년 2월에 런칭한 프로젝트입니다. 6천만 달러(약 870억 원)의 시드 라운드를 유치했는데, 이는 개발자 도구 역사상 최대 규모의 시드 투자입니다. Felicis가 리드하고, Madrona, Basis Set, Microsoft의 벤처 펀드인 M12가 참여했습니다.

Dohmke는 GitHub를 단순 코드 저장소에서 Copilot 중심의 AI 플랫폼으로 진화시킨 사람입니다. 그가 GitHub을 떠나면서 내린 판단은 명확합니다. GitHub는 인간 대 인간 협업을 위해 만들어졌고, AI 에이전트 시대를 위해 설계된 게 아니라는 것입니다.

핵심 기능: Checkpoints

Entire의 첫 번째 제품은 Checkpoints입니다. Git 워크플로우에 연동되어 매 푸시마다 AI 에이전트 세션을 캡처하고, 코드와 그 맥락·추론 과정을 하나로 통합합니다.

  • 에이전트가 잘못된 방향으로 갔을 때 이전 체크포인트로 즉시 복구
  • Git 히스토리를 깔끔하게 유지하면서 에이전트 컨텍스트를 별도 브랜치에 보존
  • 프롬프트 → 변경 → 커밋으로 이어지는 과정 추적
  • 감사(audit) 및 컴플라이언스 요건 지원

Entire는 관찰자(Observer) 역할입니다. Claude Code가 API와 주고받는 대화를 옆에서 캡처해서 저장하는 것이지, 토큰을 추가 소모하지 않습니다. entire explain --generate처럼 AI 요약을 명시적으로 요청할 때만 토큰이 소모됩니다.

Claude Code와 함께 사용하기

설치와 활성화

# macOS
brew install entireio/tap/entire

# 프로젝트에 Entire 활성화
cd my-project
entire enable --agent claude-code

작업 흐름

Claude Code로 작업을 시작하면 Entire가 백그라운드에서 세션을 캡처합니다.

# Claude Code로 작업
claude
> JWT 토큰을 이용한 사용자 인증 기능 추가해줘

# 세션 상태 확인
entire status
entire status --detailed

에이전트가 잘못된 방향으로 갔다면, 리윈드(Rewind)로 되감을 수 있습니다.

# 체크포인트 목록 확인
entire rewind --list

# 대화형으로 선택하거나 특정 체크포인트로 이동
entire rewind
entire rewind --to <checkpoint-id>

커밋 후에는 해당 커밋이 어떤 에이전트 세션에서 만들어졌는지 조회할 수 있습니다.

# 특정 커밋의 에이전트 세션 설명
entire explain --commit abc1234

# AI 요약 자동 생성 (토큰 소모)
entire explain --checkpoint a3b2c4d5 --generate

# 이전 세션 재개
entire resume feature/auth-branch

리윈드가 복원하는 것

리윈드가 복원하는 건 코드 파일과 세션 로그(JSONL 파일) 입니다. Claude의 컨텍스트 윈도우는 Entire가 직접 제어할 수 없으므로, Claude Code를 종료 후 재시작해서 컨텍스트를 초기화하고, 복원된 세션 로그로 entire resume하는 흐름입니다.

1. entire rewind --to <checkpoint-id>    ← 코드 + 세션 로그 복원
2. Claude Code 종료 후 재시작              ← 컨텍스트 윈도우 초기화
3. entire resume <branch>                ← 복원된 시점부터 이어서 작업

저장 구조

Entire는 코드를 별도 서버에 올리지 않습니다. GitHub App은 읽기 권한만 요청하며, 리포지토리에 쓰기 작업은 하지 않습니다.

GitHub (기존 그대로)
├── main 브랜치              ← 코드 (Entire와 무관)
├── feature 브랜치           ← 코드 (Entire와 무관)
└── entire/checkpoints/v1   ← 메타데이터만 (프롬프트, 트랜스크립트, 토큰 사용량)

Entire.io 서버
└── GitHub에서 entire/checkpoints/v1 브랜치를 읽어서 시각화만 함

체크포인트는 Git 커밋 트레일러 방식으로 커밋에 직접 연결됩니다.

feat: Add user authentication

Entire-Checkpoint: a3b2c4d5e6f7
Entire-Attribution: 73% agent (146/200 lines)

커밋 → 체크포인트 ID, 체크포인트 ID → 커밋 SHA 양방향 맵핑이 됩니다. 브랜치를 머지해도 각 브랜치의 작업 컨텍스트는 독립적으로 보존됩니다.

프롬프트가 기록으로 남는다는 것

Entire를 쓰면 프롬프트가 영구 기록으로 남습니다. "이거 고쳐줘" 같은 모호한 프롬프트 대신 "어떤 이유로 어떻게 고쳐줘"라고 써야 하고, 중요한 판단은 프롬프트에 명시해야 나중에 맥락을 파악할 수 있습니다. 프롬프트 품질이 곧 팀의 기술 문서 품질이 되는 구조입니다.

External Agent Plugin 프로토콜

Entire는 Claude Code의 훅 시스템을 활용하여 에이전트 세션을 캡처합니다. 내부적으로 다음과 같은 이벤트를 처리합니다.

훅 이벤트설명
SessionStart / SessionEnd에이전트 세션 시작·종료
UserPromptSubmit프롬프트 제출 시점
Stop에이전트 턴 완료 후 체크포인트 저장
PreToolUse / PostToolUse[Task]서브에이전트 생성·완료 모니터링
PostToolUse[TodoWrite]태스크 상태 변경 캡처

MCP가 "에이전트가 외부 도구를 쓰는 표준"이 된 것처럼, 이 프로토콜이 "에이전트의 컨텍스트를 버전 관리하는 표준" 이 될 수 있는 구조입니다.

3계층 플랫폼 구조

Entire는 3개의 레이어로 구성된 플랫폼을 구축하고 있습니다. Checkpoints는 이 중 첫 번째로 출시된 제품입니다.

기반 레이어  →  새로운 Git 호환 데이터베이스 (처음부터 AI 에이전트를 위해 설계)
중간 레이어  →  멀티 에이전트 조율을 위한 시맨틱 추론 레이어
상위 레이어  →  AI 네이티브 사용자 인터페이스

마치며

GitHub가 코드 버전 관리로 개발자 협업을 바꿨듯, Entire는 AI 에이전트 시대에 가장 희소한 자원인 정확한 컨텍스트를 버전 관리하려 합니다. 코드를 작성하는 것보다 에이전트가 만든 코드를 리뷰하는 것이 병목이 되는 시대에, 코드뿐 아니라 그 코드가 만들어진 맥락까지 추적할 수 있다면 리뷰의 질이 달라질 수 있습니다.

아직 초기 단계이고 Claude Code 외 다른 에이전트 지원이 확대되는 과정이지만, "AI 에이전트의 작업 맥락을 구조적으로 보존한다"는 방향 자체는 에이전트 기반 개발이 확산될수록 필수적인 인프라가 될 가능성이 높습니다.

참고