entireio/cli

Entire 는 Git 워크플로우에 hooks 를 적용하여 작업 중 AI 에이전트 세션을 캡처합니다. 세션은 커밋과 함께 인덱싱되며, 코드 작성 과정의 검색 가능한 기록을 생성합니다.

Entire 를 사용하면 다음이 가능합니다:

코드 변경 이유 이해— 전체 프롬프트/응답 전사 및 수정된 파일을 볼 수 있습니다.즉시 복구— 에이전트가 이상한 방향으로 진행될 때 알려진 좋은 체크포인트로 되돌아갈 수 있으며 원활하게 재개할 수 있습니다.Git 히스토리 유지— 별도의 브랜치에 에이전트 컨텍스트를 보존합니다.더 빠른 온보딩— 프롬프트 → 변경 → 커밋의 경로를 보여줍니다.추적성 유지— 필요시 감사 및 준수 요구사항을 지원합니다.

코드 변경 이유 이해, 아닌 것만— 전사, 프롬프트, 수정된 파일, 토큰 사용량, 도구 호출 등 모든 커밋과 함께 캡처됩니다.어떤 체크포인트에서든 되돌아갈 수 있고 재개할 수 있습니다— 이전 에이전트 세션으로 돌아갈 수 있으며 자신이나 동료의 작업에서 정확히 어디에서 시작할지 선택할 수 있습니다.완전한 컨텍스트 보존 및 검색 가능— Git 히스토리와 연결된 모든 AI 상호작용에 대한 버전 기록이 있으며 아무것도 손실되지 않습니다.컨텍스트 전환 제로— Git 네이티브, 2 단계 설정, Claude Code, Codex, Gemini 등 지원.

• Why Entire

• Quick Start

• Typical Workflow

• Key Concepts

• Local Device Auth Testing

• Commands Reference

• Configuration

• Security & Privacy

• Troubleshooting

• Development

• Getting Help

• License

• Git

• macOS, Linux or Windows

• Supported agent installed and authenticated

# Install stable via Homebrew
brew tap entireio/tap
brew install --cask entire
...

초기 설정 후 entire agent 를 사용하여 에이전트를 추가하거나 제거하고, entire configure 를 사용하여 에이전트와 관련된 설정을 업데이트하며, entire enable / entire disable 을 사용하여 Entire 를 켜거나 끕니다.

Entire 는 현재 두 개의 릴리스 채널을 제공합니다:

stable
: 대부분의 사용자에 권장. 안정적 릴리스는 덜 자주 변경되며 Homebrew, Scoop, 및 install.sh 의 기본값입니다.

.nightly
: 최신 변경 사항을 더 일찍 원하는 사용자를 위한 프리릴리스 빌드. Nightlies 는 더 빈번하게 게시되며 stable 보다 새로운, 덜 검증된 변경 사항을 포함할 수 있습니다.

각 채널을 사용하는 방법:

• Homebrew stable:
  brew install --cask entire

• Homebrew nightly:
  brew install --cask entire@nightly

install.sh

stable:curl -fsSL https://entire.io/install.sh | bash

install.sh

nightly:curl -fsSL https://entire.io/install.sh | bash -s -- --channel nightly

• Scoop: 현재는 stable 만 지원하며 scoop install entire/cli 를 통해.

entire enable

아직 활성화되지 않은 저장소 (repo) 에서 entire enable 를 실행하면:

초기 활성화 흐름을 실행합니다: Entire 설정을 생성하고, git hooks 를 설치하며, 어떤 에이전트 hooks 를 설치할지 선택하도록 안내합니다. 특정 에이전트를 비대화적으로 활성화하려면 entire enable --agent <name> 을 사용하세요.

(예를 들어, entire enable --agent cursor)

설치 후:

• 저장소가 현재 비활성화되어 있다면 entire enable 를 사용하여 Entire 을 다시 켭니다.
• entire agent 를 사용하여 에이전트를 추가하거나 제거합니다.
• entire configure 를 사용하여 에이전트와 무관한 설정 (telemetry, hooks, checkpoint remote, summary provider) 을 업데이트합니다.

hooks 는 작업 중 세션 데이터를 캡처합니다. Checkpoints 는 사용자가 또는 에이전트가 git commit 을 만들 때 생성됩니다. 코드 커밋은 깨끗하게 유지되며, Entire 은 활성 브랜치에 커밋을 생성하지 않습니다. 모든 세션 메타데이터는 별도의 entire/checkpoints/v1 브랜치에 저장됩니다.

이전에 사용하던 AI 에이전트를 그대로 사용할 수 있습니다. Entire 은 백그라운드에서 실행되어 세션을 추적합니다:

entire status # 언제든지 현재 세션 상태를 확인

변화를 되돌리고 이전 체크포인트로 돌아가고 싶다면:

entire checkpoint rewind

이 명령은 현재 세션의 모든 이용 가능한 체크포인트를 표시합니다. 하나를 선택하여 코드를 해당 정확한 상태로 복원합니다.

브랜치에 대한 최신 체크포인트된 세션 메타데이터를 복원하려면:

entire session resume <branch>

Entire 는 브랜치를 체크아웃하고, 최신 체크포인트된 세션 메타데이터 (하나 이상의 세션) 를 복원하며, 계속 진행할 명령어를 출력합니다.

entire disable

git hooks 을 제거합니다. 코드와 커밋 기록은 변하지 않습니다.

세션 (session) 은 AI 에이전트와의 완전한 상호작용을 의미하며, 시작부터 끝까지를 포함합니다. 각 세션은 모든 프롬프트, 응답, 수정된 파일 및 타임스탬프를 캡처합니다.

세션 ID 형식: YYYY-MM-DD-<UUID>

(예: 2026-01-08-abc123de-f456-7890-abcd-ef1234567890)

세션은 코드 커밋과 별도로 entire/checkpoints/v1 브랜치에 저장됩니다.

체크포인트 (checkpoint) 는 되돌릴 수 있는 세션 내의 스냅샷으로, 작업의 "저장점" 입니다.

Checkpoints 는 사용자가 또는 에이전트가 git commit 을 만들 때 생성됩니다. 체크포인트 ID 는 12 자 문자열입니다 (예: a3b2c4d5e6f7).

Your Branch entire/checkpoints/v1
│ │
▼ │
...

체크포인트는 작업 중 저장됩니다. 커밋을 할 때, 세션 메타데이터는 영구적으로 entire/checkpoints/v1 브랜치에 저장되며 사용자의 커밋과 연결됩니다.

Entire 는 git 기록을 깨끗하게 유지하기 위해 수동 커밋 전략을 사용합니다:

No commits on your branch— 분기에는 커밋을 생성하지 않습니다
Safe on any branch— main, master, feature 브랜치 모두 지원
Non-destructive rewind— 커밋 히스토리를 변경하지 않고 체크포인트에서 파일을 복원합니다
Metadata stored separately— 세션 데이터는 entire/checkpoints/v1에 저장됩니다

Entire 는 git worktrees 와 원활하게 작동합니다. 각 worktree 는 독립적인 세션 추적 기능을 가지므로, 충돌 없이 다른 worktree 에서 여러 AI 세션을 실행할 수 있습니다.

동일한 커밋에서 여러 AI 세션을 실행할 수 있습니다. 다른 세션이 미완료 작업을 진행 중일 때 두 번째 세션을 시작하면 Entire 는 경고하고 각각을 별도로 추적합니다. 두 세션의 체크포인트는 모두 보존되어 독립적으로 복원할 수 있습니다.

CLI device auth flow 로 로컬 entire.io
checkout 에서 작업 중이라면:

# 앱 리포지토리에서
cd ../entire.io-1
mise run dev
...

개발 중에 유용한 명령어:

# 로컬 서버에 로그인 플로우 실행 (브라우저 열기 전에 Enter 를 누름을 요청)
go run ./cmd/entire login --insecure-http-auth
# 로그인에 대한 집중된 통합 테스트 커버리지 실행
...

명령어	설명
entire clean
세션 데이터와 유실된 Entire 데이터를 정리합니다 (--all 을 사용하여 리포지토리 전체 정리)
entire agent
현재 리포지토리를 위한 에이전트 통합을 추가, 제거 또는 나열합니다
entire configure
에이전트가 아닌 설정 (telemetry, git hook, 전략 옵션, 요약 제공자) 을 업데이트합니다
entire disable
리포지토리에서 Entire hooks 를 제거합니다
entire doctor
고장 난 세션 정리 또는 복원합니다
entire enable
리포지토리에 Entire 를 활성화합니다
entire checkpoint
체크포인트 나열, 설명, 복원, 검색합니다
entire checkpoint explain
세션, 커밋 또는 체크포인트를 설명합니다
entire checkpoint rewind
이전 체크포인트로 복원합니다
entire login
CLI 를 Entire device auth 로 인증합니다
entire session
Toke by Entire 를 추적하는 에이전트 세션 보기 및 관리
entire session resume
브랜치 전환, 최신 체크포인트된 세션 메타데이터 복원, 명령어 표시
entire session attach
이전에 분리된 세션에 연결합니다
entire status
현재 세션 정보 표시
entire doctor trace
hook 성능 추적 표시
entire version
Entire CLI 버전 표시

Flag	Description
--agent <name>
AI agent to install hooks for: claude-code, codex, gemini, opencode, cursor, factoryai-droid, or copilot-cli
--force, -f
Force reinstall hooks (removes existing Entire hooks first)
--local
Write settings to settings.local.json instead of settings.json
--project
Write settings to settings.json even if it already exists
--skip-push-sessions
Disable automatic pushing of session logs on git push
--checkpoint-remote <provider:owner/repo>
Push checkpoint branches to a separate repo (e.g., github:org/checkpoints-repo)
--telemetry=false
Disable anonymous usage analytics

Examples:

# First-time setup with a specific agent
entire enable --agent claude-code
# Re-enable a disabled repo
...

entire enable

is primarily for turning Entire on. On an unconfigured repo it will also bootstrap setup. Use entire agent

for adding or removing agents, and entire configure

for non-agent settings.

Use entire configure

to update non-agent settings on a repo that's already set up. Agent installation lives under entire agent

.

Typical uses:

• Toggle telemetry
• Reinstall the Entire git hook (--force, --absolute-git-hook-path) - Update strategy options such as --checkpoint-remote or --skip-push-sessions
• Pick a summary provider for entire explain --generate

Examples:

# Show help and the hint pointing to 'entire agent'
entire configure
# Opt out of telemetry
...

Entire uses two configuration files in the .entire/ directory:

Shared across the team, typically committed to git:

{
"enabled": true
}

Personal overrides, gitignored by default:

{
"enabled": false,
"log_level": "debug"
...

| Option | Values | Description |
|---|---|
enabled |
true, false |
Enable/disable Entire |
log_level |
debug, info, warn, error |
Logging verbosity |
strategy_options.push_sessions |
true, false |
Auto-push entire/checkpoints/v1 branch on git push |
strategy_options.checkpoint_remote |
{"provider": "github", "repo": "org/repo"} |
Push checkpoint branches to a separate repo (see below) |
strategy_options.summarize.enabled |
true, false |
Auto-generate AI summaries at commit time |
telemetry |
true, false |
Send anonymous usage statistics to Posthog |

Each agent stores its hook configuration in its own directory. When you run entire enable

각 선택된 에이전트마다 적절한 위치에 hooks 가 설치됩니다:

Agent	Hook Location	Format
Claude Code	.claude/settings.json	JSON hooks config
Codex	.codex/hooks.json	JSON hooks config
Copilot CLI	.github/hooks/entire.json	JSON hooks config
Cursor	.cursor/hooks.json	JSON hooks config
Factory AI Droid	.factory/settings.json	JSON hooks config
Gemini CLI	.gemini/settings.json	JSON hooks config
OpenCode	.opencode/plugins/entire.ts	TypeScript plugin

동시에 여러 에이전트를 활성화할 수 있습니다. 각 에이전트의 hooks 는 독립적입니다. Entire 는 settings.json 의 설정을 확인하는 것이 아니라 설치된 hooks 를 검색하여 어떤 에이전트가 활성화되었는지 감지합니다.

기본적으로 Entire 는 코드와 같은 원격 저장소에 entire/checkpoints/v1 을 푸시합니다. 체크포인트 데이터를 별도의 저장소 (예: 공개 프로젝트용 프라이빗 저장소) 로 푸시하고 싶다면, 구조화된 제공자와 저장소를 사용하여 checkpoint_remote 를 구성하세요:

{
"strategy_options": {
"checkpoint_remote": {
...
}
}

또는 CLI 를 통해:

entire enable --checkpoint-remote github:myorg/checkpoints-private

Entire 는 푸시 원격 저장소와 동일한 프로토콜 (SSH 또는 HTTPS) 을 사용하여 git URL 을 자동으로 유도합니다. 다음 작업을 수행합니다:

• 원격에 있지만 로컬에는 없는 체크포인트 브랜치를 로컬에서 가져옵니다 (일회성)
• entire/checkpoints/v1 을 체크포인트 저장소에 푸시하고, 기본 푸시 원격 저장소 대신 푸시합니다 - 포크가 감지되면 푸시를スキップ합니다 (푸시 원격 저장소 소유자와 체크포인트 저장소 소유자가 다름)
• 원격에 도달할 수 없는 경우 경고 후 메인 푸시를 차단하지 않고 계속 진행

ENTIRE_CHECKPOINT_TOKEN 환경 변수를 설정하면 주 저장소에 대한 자격 증명 없이도 체크포인트 저장소 운영을 위한 전용 토큰을 제공할 수 있습니다.

이 환경 변수가 설정되면 Entire 는 다음과 같이 동작합니다:

• 체크포인트 가져오기와 푸시용 HTTPS Git 작업에 토큰을 주입합니다
• checkpoint_remote 가 구성되었을 경우:- 토큰이 있으면 저장소의 origin 이 SSH 를 사용하더라도 체크포인트 원격 저장소에 HTTPS URL 을 선호합니다
• checkpoint_remote 가 구성되었을 경우:- 토큰이 있으면 저장소의 - checkpoint_remote 가 구성되지 않은 경우:- 기본 origin 원격 저장소를 사용합니다
• checkpoint_remote 구성을 로드할 수 없는 경우:- 기본 origin 을 사용합니다
• origin