Prerequisites
- Entire CLI installed
- Claude Code installed
- A Git repository with Entire enabled
How It Works
Entire automatically detects when Claude Code is active and begins capturing the session. Entire integrates with Claude Code via Git hooks:- Session Detection - When Claude Code starts, Entire detects the process
- Hook Triggers - Git hooks fire on file changes and commits
- Checkpoint Creation - Checkpoints are created based on your strategy
- Metadata Capture - Session data is on the
entire/checkpoints/v1branch
Captured Data
Entire captures the following from Claude Code sessions:| Data | Description |
|---|---|
| Conversation | Full transcript of prompts and responses |
| File changes | All files modified during the session |
| Tool calls | Commands executed, files read, etc. |
| Token usage | Input, output, and cache tokens |
| Timestamps | Start time, checkpoints, end time |
Features
Nested Session Support
When Claude Code spawns sub-agents via the Task tool, Entire captures these as nested sessions:Rewind During Sessions
Useentire rewind while Claude Code is running to restore to a previous checkpoint:
| Flag | Description |
|---|---|
--to <commit> | Rewind to specific commit ID (non-interactive) |
--list | List available rewind points (JSON output) |
--logs-only | Only restore logs, don’t modify working directory |
--reset | Reset branch to commit (destructive) |
Resume Previous Sessions
Resume a previous Claude Code session by switching to its branch:- Checks out the specified branch
- Finds the session ID from commits unique to this branch
- Restores the session log if it doesn’t exist locally
- Shows the command to resume the session
| Flag | Description |
|---|---|
-f, --force | Resume from older checkpoint without confirmation |
Explain Commits
View or generate explanations of how code was written:| Flag | Description |
|---|---|
-c, --checkpoint <id> | Explain a specific checkpoint (ID or prefix) |
--commit <sha> | Explain a specific commit (SHA or ref) |
--generate | Generate an AI summary for the checkpoint |
--full | Show full parsed transcript (all prompts/responses) |
-s, --short | Show 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:- Create a PR
- Commits include
Entire-Checkpointtrailers - Reviewers can click to view session details
- Understanding why code was written helps with review
Troubleshooting
Session not being captured
Session not being captured
- Verify Entire is enabled:
entire status - Check that Git hooks are installed:
ls .git/hooks - Ensure Claude Code is running from within the repository
Rewind not working
Rewind not working
Rewind requires an active session with checkpoints. Check:If no session is active, checkpoints may only exist on the sessions branch.