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

# doctor

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

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

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

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

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

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

<Note>
  Traces are only logged at DEBUG level. Enable with `ENTIRE_LOG_LEVEL=DEBUG` or set `"log_level": "DEBUG"` in `.entire/settings.json`.
</Note>