> ## 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.

# Configuration

> Find the right place to configure Entire.

Use configuration docs when you need to change how Entire behaves in a repository, on your machine, or during Git and agent workflows.

Use the table below to find the guide for the part of Entire you want to configure.

## What are you configuring?

| If you want to configure...                                                   | Go to                                                                        |
| ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| Local, project, or global settings files                                      | [Local, Project, and Global Settings](/guides/configuration/settings-layers) |
| Which Entire-generated files should be committed or kept local                | [Entire-Generated Files](/guides/configuration/entire-files)                 |
| Where checkpoint data is stored or pushed                                     | [Checkpoint Storage](/guides/configuration/checkpoint-storage)               |
| Git commit and push hooks, including GUI Git clients                          | [Git Hooks](/guides/configuration/git-hooks)                                 |
| Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Pi, or external agent hooks | [Agent Hooks](/guides/configuration/agent-hooks)                             |
| Redaction rules, PII, telemetry, or checkpoint commit signing                 | [Privacy and Redaction](/guides/configuration/privacy-and-redaction)         |
| Debug logs, diagnostics, or effective settings                                | [Logging and Diagnostics](/guides/configuration/logging-and-diagnostics)     |
| Saved review profiles for `entire review`                                     | [Review Profiles](/guides/configuration/review-profiles)                     |

## How configuration is layered

Entire merges settings from multiple places. More specific settings win:

1. Local settings: `.entire/settings.local.json`
2. Project settings: `.entire/settings.json`
3. Global settings: `~/.config/entire/settings.json`
4. Defaults

Use project settings for behavior the whole team should share. Use local settings for personal preferences, machine-specific setup, debug logging, or private redaction rules.

## Common paths

<CardGroup cols={2}>
  <Card title="Local, project, and global settings" icon="gear" href="/guides/configuration/settings-layers">
    Choose local, project, or global settings for a configuration change.
  </Card>

  <Card title="Entire-generated files" icon="folder" href="/guides/configuration/entire-files">
    Decide which Entire-generated files belong in Git and which should stay local.
  </Card>

  <Card title="Store checkpoints elsewhere" icon="database" href="/guides/configuration/checkpoint-storage">
    Configure checkpoint remotes, local-only checkpoint data, and push behavior.
  </Card>

  <Card title="Fix GUI Git commits" icon="git-commit" href="/guides/configuration/git-hooks">
    Use absolute Git hook paths when GUI clients cannot find the Entire binary.
  </Card>

  <Card title="Control privacy settings" icon="shield" href="/guides/configuration/privacy-and-redaction">
    Configure redaction, telemetry, and checkpoint commit signing.
  </Card>
</CardGroup>