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

# Entire-Generated Files

> Decide which Entire-generated files belong in Git and which should stay on your machine.

Entire creates a small set of repository files for configuration, redaction rules, diagnostics, and local runtime state.

Commit files that define shared project behavior. Keep personal overrides, logs, temporary files, and machine-local state out of Git.

## Commit or Keep Local

| Path | Commit? | Use for |
| - | - | - |
| `.entire/settings.json` | Yes, when Entire is part of the project | Shared project settings, such as checkpoint storage, team redaction rules, and default repository behavior |
| `.entire/.gitignore` | Yes | Keeping local Entire files out of normal commits |
| `.entire/redactors/` | Yes, for shared rule packs | Team redaction rules that should apply to everyone working in the repository |
| `.entire/settings.local.json` | No | Personal overrides, debug logging, private rules, and machine-specific settings |
| `.entire/redactors/local/` | No | Personal redaction rule packs |
| `.entire/logs/` | No | Local diagnostic logs |
| `.entire/tmp/` | No | Temporary runtime files |
| `.entire/metadata/` | No | Local metadata generated while Entire runs |
| `.entire/current_session` | No | Pointer to your current local session |

If you are trying Entire locally before adopting it for the project, keep `.entire/settings.json` local until the team decides to share Entire configuration.

## Files Stored Elsewhere

Checkpoint data is not committed from your working tree. Entire stores checkpoint metadata in Git refs under `refs/entire/checkpoints/`, or on the `entire/checkpoints/v1` branch for repositories on the branch backend, in your code repository or in a configured checkpoint remote. See [Where your data lives](/security#where-your-data-lives).

Global settings live at `~/.config/entire/settings.json`.

Agent hook files live in agent-specific folders, such as `.agents/`, `.claude/`, `.codex/`, and `.cursor/`.