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

Scan for stuck or problematic sessions and offer to fix them.

```
entire doctor [flags]
```

A session is considered stuck if:

- It is in ACTIVE 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 issues without prompting (condense if possible, otherwise discard) |

For each stuck session, you can choose to:

- **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

## doctor logs

Show recent operational logs.

```
entire doctor logs [flags]
```

| Flag | Description |
| --- | --- |
| `-f, --follow` | Stream new log lines as they are written |
| `--tail N` | Show the last N lines. Use `0` for all. Defaults to `100`. |

## doctor bundle

Produce a diagnostic bundle for bug reports.

```
entire doctor bundle [flags]
```

| Flag | Description |
| --- | --- |
| `-o, --out PATH` | Path to write the bundle archive. Defaults to the OS temp directory. |
| `--raw` | Skip secret redaction. Use only when support has asked for an unredacted bundle. |

## doctor trace

Show hook performance traces for debugging slow Git operations.

```
entire doctor trace [flags]
```

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