Skip to main content
Claude Code is Anthropic’s official CLI for Claude, designed for software engineering tasks. Entire has first-class integration with Claude Code, automatically capturing sessions and checkpoints.

Prerequisites

How It Works

Entire automatically detects when Claude Code is active and begins capturing the session. Entire integrates with Claude Code via Git hooks:
  1. Session Detection - When Claude Code starts, Entire detects the process
  2. Hook Triggers - Git hooks fire on file changes and commits
  3. Checkpoint Creation - Checkpoints are created based on your strategy
  4. Metadata Capture - Session data is on the entire/checkpoints/v1 branch

Captured Data

Entire captures the following from Claude Code sessions:
DataDescription
ConversationFull transcript of prompts and responses
File changesAll files modified during the session
Tool callsCommands executed, files read, etc.
Token usageInput, output, and cache tokens
TimestampsStart time, checkpoints, end time

Features

Nested Session Support

When Claude Code spawns sub-agents via the Task tool, Entire captures these as nested sessions:
Main Session
├── Checkpoint 1
├── Sub-agent Session (Task: "Run tests")
│   ├── Sub-checkpoint 1
│   └── Sub-checkpoint 2
└── Checkpoint 2
Nested sessions preserve the full context of complex multi-agent workflows.

Rewind During Sessions

Use entire rewind while Claude Code is running to restore to a previous checkpoint:
# In another terminal - interactive mode
entire rewind

# Or rewind to a specific checkpoint
entire rewind --to <checkpoint-id>

# List available rewind points
entire rewind --list
FlagDescription
--to <commit>Rewind to specific commit ID (non-interactive)
--listList available rewind points (JSON output)
--logs-onlyOnly restore logs, don’t modify working directory
--resetReset branch to commit (destructive)
Select a checkpoint and your code will be restored. Continue with Claude Code from that point.

Resume Previous Sessions

Resume a previous Claude Code session by switching to its branch:
entire resume <branch>
This command:
  1. Checks out the specified branch
  2. Finds the session ID from commits unique to this branch
  3. Restores the session log if it doesn’t exist locally
  4. Shows the command to resume the session
FlagDescription
-f, --forceResume from older checkpoint without confirmation

Explain Commits

View or generate explanations of how code was written:
# Explain a specific commit
entire explain --commit abc1234

# Explain a specific checkpoint
entire explain --checkpoint a3b2c4d5

# Generate an AI summary
entire explain --checkpoint a3b2c4d5 --generate

# Show full transcript
entire explain --full
FlagDescription
-c, --checkpoint <id>Explain a specific checkpoint (ID or prefix)
--commit <sha>Explain a specific commit (SHA or ref)
--generateGenerate an AI summary for the checkpoint
--fullShow full parsed transcript (all prompts/responses)
-s, --shortShow summary only (omit prompts and files)
The --generate flag requires Claude CLI to be installed and authenticated.

Best Practices

Commit at Logical Points

Create checkpoints at natural stopping points:
  • After implementing a feature
  • Before making major changes
  • When you’d want to rewind later

Review Sessions in PRs

Share session context in pull request reviews:
  1. Create a PR
  2. Commits include Entire-Checkpoint trailers
  3. Reviewers can click to view session details
  4. Understanding why code was written helps with review

Troubleshooting

  1. Verify Entire is enabled: entire status
  2. Check that Git hooks are installed: ls .git/hooks
  3. Ensure Claude Code is running from within the repository
Rewind requires an active session with checkpoints. Check:
entire status
If no session is active, checkpoints may only exist on the sessions branch.

Example Workflow

A typical workflow with Claude Code and Entire:
# 1. Enable Entire
cd my-project
entire enable

# 2. Start Claude Code
claude

# 3. Work with Claude (in Claude Code)
> Add user authentication with JWT tokens

# 4. Check status (in another terminal)
entire status

# 5. Made a mistake? Rewind
entire rewind

# 6. Commit when ready
git add .
git commit -m "Add JWT authentication"

# 7. Push to see on entire.io
git push
Your session is now visible on entire.io with full context for code review.