The entire CLI comes with powerful commands to manage your local development experience. All commands are called on the entire CLI path.
clean
Remove orphaned Entire data from the repository.
| Flag | Description |
|---|
--dry-run | Show what would be cleaned without actually deleting |
- Orphaned shadow branches
- Incomplete session data
- Stale checkpoint references
disable
Remove Entire hooks from a repository. This stops session capture but preserves existing session data.
| Flag | Description |
|---|
--force | Skip confirmation prompt (use with --uninstall) |
--project | Update settings.json instead of settings.local.json |
--uninstall | Completely remove Entire from this repository |
Disabling Entire does not delete your session history. You can re-enable at any time with entire enable. Use --uninstall to completely remove Entire from the repository.
doctor
Scan for stuck or problematic sessions and offer to fix them.
A session is considered stuck if:
- It is in ACTIVE or ACTIVE_COMMITTED phase with no interaction for over 1 hour
- It is in ENDED phase with uncondensed checkpoint data on a shadow branch
| Flag | Description |
|---|
-f, --force | Fix all stuck sessions without prompting (condense if possible, otherwise discard) |
- Condense: Save session data to permanent storage (
entire/checkpoints/v1 branch)
- Discard: Remove the session state and shadow branch data
- Skip: Leave the session as-is
enable
Initialize Entire in a Git repository. This installs the necessary Git hooks to capture AI coding sessions.
| Flag | Description |
|---|
--agent <name> | Agent to setup hooks for (e.g., claude-code). Enables non-interactive mode. |
-f, --force | 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 |
--strategy <name> | Strategy to use: manual-commit (default) or auto-commit |
--telemetry | Enable anonymous usage analytics (default: true) |
explain
Generate an AI-powered explanation of a session or commit.
| Flag | Description |
|---|
-c, --checkpoint <id> | Explain a specific checkpoint (ID or prefix) |
--commit <sha> | Explain a specific commit (SHA or ref, “commit-ish”) |
--force | Regenerate summary even if one already exists (requires --generate) |
--full | Show full parsed transcript (all prompts/responses) |
--generate | Generate an AI summary for the checkpoint |
--no-pager | Disable pager output |
--raw-transcript | Show raw transcript file (JSONL format) |
--search-all | Search all commits (no branch/depth limit, may be slow) |
--session <id> | Filter checkpoints by session ID (or prefix) |
-s, --short | Show summary only (omit prompts and files) |
The --generate flag requires Claude CLI (claude) to be installed and authenticated.
help
Display help information about any command.
| Argument | Description |
|---|
command | Optional. The command to get help for. |
# Show general help
entire help
# Get help for a specific command
entire help enable
entire enable --help
reset
Delete the shadow branch and session state for the current commit. Use this to start fresh.
| Flag | Description |
|---|
--force | Skip confirmation prompt |
This deletes session data for the current commit. The data cannot be recovered.
resume
Switch to a local branch and resume the agent session from its last commit.
entire resume <branch> [flags]
- Checks out the specified branch
- Finds the session ID from commits unique to this branch (not on main)
- Restores the session log if it doesn’t exist locally
- Shows the command to resume the session
| Argument | Description |
|---|
branch | The branch to resume the agent session from |
| Flag | Description |
|---|
-f, --force | Resume from older checkpoint without confirmation |
If the branch doesn’t exist locally but exists on origin, you’ll be prompted to fetch it.
If newer commits without checkpoints exist on the branch (e.g., after merging main or cherry-picking), this operation will reset your Git status to the most recent commit with a checkpoint. You’ll be prompted to confirm.
rewind
Rewind to a previous checkpoint within the current session.
| 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 (for logs-only points) |
--reset | Reset branch to commit (destructive, for logs-only points) |
Rewinding discards changes made after the selected checkpoint. Make sure to commit any changes you want to keep before rewinding. The --reset flag is destructive and will reset your branch.
status
Show the current Entire status for this repository.
| Flag | Description |
|---|
--detailed | Show detailed status for each settings file |
version
Show build information.
Global Flags
These flags are available for all commands:
| Flag | Description |
|---|
--help, -h | Show help for a command |
--detailed, -v | Enable verbose output |
--quiet, -q | Suppress non-essential output |
