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.mdnew file mode 100644index 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.mdindex 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 & Imagesdiff --git a/packages/coding-agent/docs/themes.md b/packages/coding-agent/docs/themes.mdindex 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