# Settings reference

Every key in the desktop and runner settings file, its type and its default, from the code.

The runner keeps its settings in `runner-settings.json` in its cache folder, and keeps any key it doesn't know. Each key below is generated from the runner's settings schema; `<id>` stands for a harness id.

| Key | Type | Default |
| --- | --- | --- |
| `version` | number | `1` |
| `harnesses.<id>.driver` | "auto" \| "native" \| "acp" \| "headless" | `"auto"` |
| `harnesses.<id>.defaultAccount` | string | `"default"` |
| `harnesses.<id>.accounts` | object[] | `[]` |
| `harnesses.<id>.removedAccounts` | unknown[] | `[]` |
| `harnesses.<id>.dismissedFolders` | string[] | `[]` |
| `harnesses.<id>.connected` | Record<string, string> | `{}` |
| `handoff.budgetTokens` | integer, 4000–64000 | `16000` |
| `handoff.summary` | boolean | `true` |
| `idleMinutes` | integer, at least 1 | `30` |
| `isolation.depDirs` | Record<string, string[]> | `{"*":["node_modules"]}` |
| `repos.cloneRoot` | string or null | `null` |
| `repos.searchRoots` | string[] | `[]` |
| `knowledge.autoRefresh` | boolean | `false` |
| `knowledge.harness` | "claude" \| "codex" | `"claude"` |
| `knowledge.scan` | boolean | `true` |
