Reference
Settings reference
Every key in the desktop and runner settings file, its type and its default, from the code.
Generated from the codeView as Markdown
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 |
Something wrong or missing? Suggest a change