📜 Entire CLI hooks into your Git workflow to capture AI agent sessions as you work. Sessions are indexed alongside commits, creating a searchable record of how code was written in your repo.

전체 CLI – AI 증강 Git 워크플로우

무엇인가 – Entire는 Git 리포지토리에 연결되어 사용자가 AI 코딩 도우미(Claude, Codex, Cursor 등)와 상호 작용한 모든 기록을 저장하는 명령줄 도구입니다. 각 AI 세션은 해당 커밋과 연결된 특별한 Git 참조에 체크포인트로 저장됩니다. 그 결과는 단순히 무엇이 변경되었는지뿐만 아니라 코드가 왜 변경되었는지에 대한 검색 가능하고 버전 관리되는 기록이 됩니다.

빠른 설치

플랫폼	방법
macOS / Linux	`brew install --cask entireio/tap/entire`
Windows	PowerShell: `irm https://entire.com/install.ps1
모든 OS (Go)	`go install github.com/entireio/cli/cmd/entire@latest`

동일한 스크립트를 통해 특정 버전을 가져오거나 나이틀리 채널을 사용할 수도 있습니다.

핵심 개념

개념	의미
세션	하나의 완전한 AI 상호 작용(모든 프롬프트, 응답, 건드려진 파일).
체크포인트	Git 커밋을 할 때 저장되는 스냅샷. Git 참조 `refs/entire/checkpoints/<shard>/<id>`로 저장되며 `Entire-Checkpoint` 트레일러를 통해 커밋에 연결됩니다.
체크포인트 저장소	메타데이터는 Git 객체에 저장됩니다(브랜치 기록에 저장되지 않음). 따라서 코드 기록은 깨끗하게 유지되면서 AI 컨텍스트는 버전 관리되고 필요할 때 가져올 수 있습니다.
에이전트 훅	Entire는 AI 에이전트 트래픽을 캡처하는 Git 훅을 설치합니다. `entire agent`를 사용하여 에이전트를 추가하거나 제거할 수 있습니다.

일반적인 워크플로우

리포지토리에 활성화하기: entire enable (훅을 추가하고 .entire/settings.json을 생성합니다).
평소처럼 AI 도우미와 작업하기; Entire는 백그라운드에서 조용히 실행됩니다.
평소처럼 커밋하기 – 훅이 Entire-Checkpoint 트레일러를 추가하고 체크포인트 참조를 작성합니다.
이전 세션 재개하기: entire session resume <branch>는 체크포인트 메타데이터를 복원하여 중단했던 지점부터 계속할 수 있게 합니다.
검색 / 감사: entire search, entire checkpoint explain, 또는 entire recap을 사용하여 기록, 토큰 사용량, 변경된 파일 등을 확인합니다.

주요 명령어 (개요)

entire enable / disable – 현재 리포지토리에 대해 Entire를 켜거나 끕니다.
entire status – Entire가 활성화되어 있는지 및 현재 세션 정보를 표시합니다.
entire agent – 지원되는 AI 에이전트를 추가/제거/목록화합니다.
entire session … – AI 세션을 나열, 검사, 중지, 연결 또는 재개합니다.
entire checkpoint … – 저장된 체크포인트를 나열, 설명 또는 검색합니다.
entire search – 체크포인트 및 커밋 전반에 걸친 의미론적/키워드 검색을 수행합니다.
entire login / logout – Entire 제어 평면과 인증합니다(헤드리스 CI를 위한 브라우저 흐름 또는 장치 코드 흐름).
entire doctor – 진단 및 정리 유틸리티입니다.

Entire를 사용하는 이유?

추적 가능성 – 모든 프롬프트, 응답, 파일 편집, 토큰 수, 도구 호출이 변경 사항을 도입한 커밋과 함께 보관됩니다. 감사, 규정 준수 또는 새로운 팀원 온보딩에 유용합니다.
깔끔한 Git 기록 – 브랜치에 추가 커밋이 추가되지 않습니다. AI 컨텍스트는 별도의 참조에 존재합니다.
작업 재개 – 다른 머신에서도 모든 체크포인트에서 일시 중지된 AI 세션으로 돌아갈 수 있습니다.
검색 가능한 지식 기반 – entire search를 사용하여 과거 AI 제안을 찾아 리포지토리를 살아있는 문서 소스로 만듭니다.
모든 Git 워크플로우와 호환 – 워크트리, 다중 동시 세션, 기존 Git 훅과 공존하는 것을 지원합니다.

보안 및 개인 정보 보호 참고 사항

토큰은 기본적으로 OS 키링에 저장됩니다. 헤드리스 환경에서는 파일 기반 저장소(ENTIRE_TOKEN_STORE=file)를 사용할 수 있습니다.
CI의 경우, 자격 증명이 지속되는 것을 방지하기 위해 ENTIRE_TOKEN을 통해 토큰을 제공하십시오.
체크포인트 데이터는 Git 참조에 저장되므로 다른 Git 객체와 마찬가지로 푸시, 가져오기 또는 제거할 수 있습니다.

라이선스

이 리포지토리는 LICENSE 파일에 명시된 조건에 따라 배포됩니다(여기에 재현되지 않음).

결론 – Entire는 AI 지원 코딩을 버전 관리 워크플로우의 일급 구성 요소로 전환하여 Git 기록을 깔끔하게 유지하면서 코드가 왜 변경되었는지에 대한 영구적이고 검색 가능한 기록을 제공합니다.

entireio/cli