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

# selftune doctor

> Health check for your selftune installation

## Usage

```bash theme={null}
selftune doctor
```

Runs a comprehensive health check and reports any issues.

## What it checks

* **Configuration** — valid `config.json` with required fields
* **Hooks** — Claude Code hooks are installed and functional
* **Database** — SQLite database exists and has valid schema
* **Permissions** — can read session logs and write to selftune directories
* **Version** — warns if a newer version is available
* **Log access** — can read agent session logs

## Output

Each check reports one of:

| Status | Meaning                                                               |
| ------ | --------------------------------------------------------------------- |
| `PASS` | Check succeeded                                                       |
| `WARN` | Non-critical issue, selftune will work but with reduced functionality |
| `FAIL` | Critical issue that must be fixed                                     |

## Common fixes

**Hooks not installed:**

```bash theme={null}
selftune init
```

**Database missing or corrupted:**

```bash theme={null}
selftune recover
```

**Outdated version:**

```bash theme={null}
npx skills add selftune-dev/selftune
```