## Documentation Index

Fetch the complete documentation index at: [/llms.txt](https://docs.entire.io/llms.txt)

Use this file to discover all available pages before exploring further.

Initialize Entire in a Git repository. This installs the necessary Git hooks to capture AI coding sessions.

```
entire enable [flags]
```

| 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](https://docs.entire.io/guides/configuration/git-hooks#gui-git-clients). |
| `--agent NAME` | Agent to setup hooks for: `claude-code`, `codex`, `gemini`, `opencode`, `cursor`, `copilot-cli`, `factoryai-droid`, or `pi`. Enables non-interactive mode. |
| `--checkpoint-backend BACKEND` | Set checkpoint storage to `branch` (default) or `refs` (one Git ref per checkpoint). |
| `--checkpoint-remote PROVIDER:OWNER/REPO` | Push checkpoint branches to a separate repository (e.g., `github:org/checkpoints-private`). See [Checkpoint Remote](https://docs.entire.io/guides/configuration/checkpoint-storage#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) |
| `-y, --yes` | Accept defaults without prompting. Useful for automation, CI, and bootstrap flows. |

Use `--yes` for non-interactive setup flows:

```
# Non-interactive setup for a specific agent
entire enable --yes --agent claude-code

# Non-interactive setup using default choices
entire enable --yes
```

`--yes` is not just a confirmation bypass. It runs `entire enable` non-interactively with default choices. On a fresh repository, it enables the default setup without prompts. On an already configured repository, it follows the setup-management path. Outside a Git repository, it also accepts the bootstrap defaults to initialize Git, create a private GitHub repository through `gh`, and create the initial commit. Important behavior:

- If you also pass `--agent NAME`, that explicit agent selection takes precedence over the default multi-agent behavior.
- If you pass `--telemetry=false`, or set `ENTIRE_TELEMETRY_OPTOUT`, that explicit telemetry opt-out still overrides the `--yes` default.

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`, `.factory/settings.json`, or `.pi/extensions/entire/index.ts`).
