> ## Documentation Index
> Fetch the complete documentation index at: https://docs.entire.io/llms.txt
> Use this file to discover all available pages before exploring further.

# enable

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

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

```bash theme={null}
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](/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-remote PROVIDER:OWNER/REPO` | Push checkpoint branches to a separate repository (e.g., `github:org/checkpoints-private`). See [Checkpoint Remote](/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:

```bash theme={null}
# 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.

<Note>
  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`).
</Note>