Skip to content

A self-improving RLM agent for coding workflows and long-running autonomous tasks.

Rust

docs(coding-agent): correct wrong setting defaults and drop removed collapseChangelog (#2380)

Seth Karten1437e4bcc55f
diff --git a/packages/coding-agent/.changes/settings-docs-defaults.md b/packages/coding-agent/.changes/settings-docs-defaults.md
new file mode 100644
index 0000000000..afe2681960
--- /dev/null
+++ b/packages/coding-agent/.changes/settings-docs-defaults.md
@@ -0,0 +1 @@
+- Corrected the documented defaults in `docs/settings.md` and `docs/themes.md`: unset thinking starts at `medium` (not `xhigh`), the default theme is `prime`/`light` (not `dark`), `transport` defaults to `auto` (not `sse`, and `websocket-cached` is a valid value), and the removed `collapseChangelog` setting is no longer documented.
diff --git a/packages/coding-agent/docs/settings.md b/packages/coding-agent/docs/settings.md
index 04c10714d3..2a71b6f01d 100644
--- a/packages/coding-agent/docs/settings.md
+++ b/packages/coding-agent/docs/settings.md
@@ -18,11 +18,13 @@ Edit directly or use `/settings` for common options.
| `defaultProvider` | string | - | Default provider (e.g., `"anthropic"`, `"openai"`) |
| `defaultModel` | string | - | Default model ID |
| `subagentDefaultModel` | string | - | Model selector (`"provider/id"`) used when `rlm.spawn` does not pin a model; unset inherits the parent model |
-| `defaultThinkingLevel` | string | `"xhigh"` | `"off"`, `"minimal"`, `"low"`, `"medium"`, `"high"`, `"xhigh"`, `"max"` |
+| `defaultThinkingLevel` | string | `"medium"` | `"off"`, `"minimal"`, `"low"`, `"medium"`, `"high"`, `"xhigh"`, `"max"` |
| `thinkingBudgets` | object | - | Custom token budgets per thinking level |
`subagentDefaultModel` applies only to spawned subagents whose `rlm.spawn` call omits `model=`. An explicit `model=` per spawn always wins, and an unset setting keeps the inherit-parent behavior. If the configured default is unavailable, unauthenticated, or expired, the spawn fails with that error instead of silently falling back.
+When `defaultThinkingLevel` is unset, new sessions start at `"medium"` reasoning, clamped to the levels each model supports.
+
### Autonomous Runs
| Setting | Type | Default | Description |
@@ -62,9 +64,8 @@ Conversation output starts in overview. Ctrl+O cycles through details and all ou
| Setting | Type | Default | Description |
|---------|------|---------|-------------|
-| `theme` | string | `"dark"` | Theme name (`"dark"`, `"light"`, or custom) |
+| `theme` | string | detected | Theme name (built-ins: `"prime"`, `"dark"`, `"light"`; or custom). Unset uses `"prime"` on dark terminals and `"light"` on light terminals |
| `quietStartup` | boolean | `false` | Hide startup header |
-| `collapseChangelog` | boolean | `false` | Show condensed changelog after updates |
| `treeFilterMode` | string | `"user-only"` | Default filter for `/tree`: `"default"`, `"no-tools"`, `"user-only"`, `"labeled-only"`, `"all"` |
| `editorPaddingX` | number | `0` | Horizontal padding for input editor (0-3) |
| `autocompleteMaxVisible` | number | `5` | Max visible items in autocomplete dropdown (3-20) |
@@ -248,7 +249,7 @@ available, authenticated model, the bounded wait runs instead.
|---------|------|---------|-------------|
| `steeringMode` | string | `"one-at-a-time"` | How steering messages are sent: `"all"` or `"one-at-a-time"` |
| `followUpMode` | string | `"one-at-a-time"` | How follow-up messages are sent: `"all"` or `"one-at-a-time"` |
-| `transport` | string | `"sse"` | Preferred transport for providers that support multiple transports: `"sse"`, `"websocket"`, or `"auto"` |
+| `transport` | string | `"auto"` | Preferred transport for providers that support multiple transports: `"sse"`, `"websocket"`, `"websocket-cached"`, or `"auto"` |
### Terminal & Images
diff --git a/packages/coding-agent/docs/themes.md b/packages/coding-agent/docs/themes.md
index 251bd3a2f0..714c2609b3 100644
--- a/packages/coding-agent/docs/themes.md
+++ b/packages/coding-agent/docs/themes.md
@@ -18,7 +18,7 @@ Themes are JSON files that define colors for the TUI.
Prime Agent loads themes from:
-- Built-in: `dark`, `light`
+- Built-in: `prime`, `dark`, `light`
- Global: `~/.prime/agent/themes/*.json`
- Project: `.prime/agent/themes/*.json`
- Packages: `themes/` directories or `pi.themes` entries in `package.json`
@@ -37,7 +37,7 @@ Select a theme via `/settings` or in `settings.json`:
}
```
-On first run, Prime Agent detects your terminal background and defaults to `dark` or `light`.
+On first run, Prime Agent detects your terminal background and defaults to `prime` or `light`.
## Creating a Custom Theme