The entire CLI comes with powerful commands to manage your local development experience. All commands are called on the entire CLI path.
Configure Entire and manage agent hooks. On first run, this configures Entire and installs agent hooks. On subsequent runs, it lets you enable more agents.
| Flag | Description |
|---|
--absolute-git-hook-path | Embed full binary path in Git hooks. Required for GUI Git clients that don’t source shell profiles. See GUI Git Clients. |
--agent <name> | Enable a specific agent (e.g., claude-code, gemini, opencode, factoryai-droid). |
-f, --force | Force reinstall hooks (removes existing Entire hooks first) |
--local | Write settings to .entire/settings.local.json instead of .entire/settings.json |
--project | Write settings to .entire/settings.json even if it already exists |
--remove <name> | Remove a specific agent’s hooks (e.g., claude-code, gemini) |
--skip-push-sessions | Disable automatic pushing of session logs on Git push |
--telemetry | Enable anonymous usage analytics (default: true) |
--remove to uninstall hooks for a specific agent:
entire configure --remove claude-code
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 .entire/settings.json instead of .entire/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 |
|---|
--absolute-git-hook-path | Embed full binary path in Git hooks. Required for GUI Git clients that don’t source shell profiles. See GUI Git Clients. |
--agent <name> | Agent to setup hooks for: claude-code, gemini, opencode, or factoryai-droid. Enables non-interactive mode. |
--checkpoint-remote <provider:owner/repo> | Push checkpoint branches to a separate repository (e.g., github:org/checkpoints-private). See Checkpoint Remote. |
-f, --force | Force reinstall hooks (removes existing Entire hooks first) |
--local | Write settings to .entire/settings.local.json instead of .entire/settings.json. |
--project | Write settings to .entire/settings.json even if it already exists |
--skip-push-sessions | Disable automatic pushing of session logs on Git push |
--telemetry | Enable anonymous usage analytics (default: true) |
The --local and --project flags control which Entire settings file is modified. Entire always modifies the agent’s project settings (e.g., .claude/settings.json, .gemini/settings.json, .opencode/plugins/entire.ts, or .factory/settings.json).
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 |
trace
Show hook performance traces for debugging slow Git operations.
| Flag | Description |
|---|
--last <N> | Show last N hook invocations (default: 1) |
--hook <type> | Filter by hook type (e.g., post-commit, prepare-commit-msg, pre-push) |
Traces are only logged at DEBUG level. Enable with ENTIRE_LOG_LEVEL=DEBUG or set "log_level": "DEBUG" in .entire/settings.json.
version
Show build information including the CLI version, Git commit, Go version, and OS/architecture.
You can also use the --version flag on the root command:
Both produce identical output:
Entire CLI v1.2.3 (abc1234)
Go version: go1.21.0
OS/Arch: darwin/arm64
Global Flags
These flags are available on the root command:
| Flag | Description |
|---|
--help, -h | Show help for entire or any subcommand |
--version, -v | Show build information (same as entire version) |
