From 42f7f29ad1cf15d6ec7eb5f41749b2e6ab291eb2 Mon Sep 17 00:00:00 2001 From: Cristina Poncela Cubeiro <140309543+cristinaponcela@users.noreply.github.com> Date: Wed, 26 Aug 2026 16:25:30 +0200 Subject: [PATCH] docs(settings): default model and thinking --- packages/coding-agent/README.md | 7 ++++--- packages/coding-agent/docs/quickstart.md | 2 +- packages/coding-agent/docs/settings.md | 12 ++++++++---- packages/coding-agent/docs/usage.md | 5 +++-- 4 files changed, 16 insertions(+), 10 deletions(-) diff --git a/packages/coding-agent/README.md b/packages/coding-agent/README.md index 0a6c1e14f..9f1bb560c 100644 --- a/packages/coding-agent/README.md +++ b/packages/coding-agent/README.md @@ -96,7 +96,7 @@ Then just talk to pi. By default, pi gives the model four tools: `read`, `write` ## Providers & Models -For each built-in provider, pi maintains a list of tool-capable models. Configured provider catalogs refresh automatically; run `pi update --models` to force an immediate refresh. Authenticate via subscription (`/login`) or API key, then select any model from that provider via `/model` (or Ctrl+L). +For each built-in provider, pi maintains a list of tool-capable models. Configured provider catalogs refresh automatically; run `pi update --models` to force an immediate refresh. Authenticate via subscription (`/login`) or API key, then select any model from that provider via `/model` (or Ctrl+L). Press Ctrl+S in the model picker to save the highlighted model as the startup default. **Subscriptions:** - Anthropic Claude Pro/Max @@ -178,9 +178,10 @@ Type `/` in the editor to trigger commands. [Extensions](#extensions) can regist |---------|-------------| | `/login`, `/logout` | Manage provider credentials | | [`/llama`](docs/llama-cpp.md) | Download, load, and unload llama.cpp router models | -| `/model` | Switch models | +| `/model` | Switch models; Ctrl+S in the picker saves the startup default | +| `/thinking` | Switch thinking level; Ctrl+S in the picker saves the startup default | | `/scoped-models` | Enable/disable models for Ctrl+P cycling | -| `/settings` | Thinking level, theme, message delivery, transport | +| `/settings` | Theme, message delivery, transport, and other preferences | | `/resume` | Pick from previous sessions | | `/new` | Start a new session | | `/name ` | Set session display name | diff --git a/packages/coding-agent/docs/quickstart.md b/packages/coding-agent/docs/quickstart.md index a8b63c21c..1b84fe4df 100644 --- a/packages/coding-agent/docs/quickstart.md +++ b/packages/coding-agent/docs/quickstart.md @@ -129,7 +129,7 @@ The command output is sent to the model. Use `!!command` to run a command withou ### Switch models -Use `/model` or Ctrl+L to choose a model. Use Shift+Tab to cycle thinking level. Use Ctrl+P / Shift+Ctrl+P to cycle through scoped models. +Use `/model` or Ctrl+L to choose a model for the current session. Press Ctrl+S in the model picker to save the highlighted model as the startup default. Use `/thinking` to choose a thinking level for the current session, or Ctrl+S in that picker to save the startup default thinking level. Use Shift+Tab to cycle thinking level. Use Ctrl+P / Shift+Ctrl+P to cycle through scoped models. ### Continue later diff --git a/packages/coding-agent/docs/settings.md b/packages/coding-agent/docs/settings.md index d0ded5f68..dfae162ba 100644 --- a/packages/coding-agent/docs/settings.md +++ b/packages/coding-agent/docs/settings.md @@ -7,7 +7,7 @@ Pi uses JSON settings files with project settings overriding global settings. | `~/.pi/agent/settings.json` | Global (all projects) | | `.pi/settings.json` | Project (current directory) | -Edit directly or use `/settings` for common options. +Edit directly or use `/settings` for common options. To save startup model defaults interactively, use `/model` and press Ctrl+S on the desired model. To save the startup thinking level, use `/thinking` and press Ctrl+S. ## Project Trust @@ -27,9 +27,10 @@ Use `/trust` in interactive mode to save a project trust decision for future ses | Setting | Type | Default | Description | |---------|------|---------|-------------| -| `defaultProvider` | string | - | Default provider (e.g., `"anthropic"`, `"openai"`) | -| `defaultModel` | string | - | Default model ID | -| `defaultThinkingLevel` | string | - | `"off"`, `"minimal"`, `"low"`, `"medium"`, `"high"`, `"xhigh"`, `"max"` | +| `defaultProvider` | string | - | Startup provider (e.g., `"anthropic"`, `"openai"`; saved with Ctrl+S in `/model`, or edited manually) | +| `defaultModel` | string | - | Startup model ID (saved with Ctrl+S in `/model`, or edited manually) | +| `defaultThinkingLevel` | string | - | Startup thinking level (saved with Ctrl+S in `/thinking`, or edited manually): `"off"`, `"minimal"`, `"low"`, `"medium"`, `"high"`, `"xhigh"`, `"max"` | +| `modelThinkingLevels` | object | - | Per-model startup thinking levels keyed by `"provider/modelId"`; configure from `/settings` → Default thinking level per model or edit manually | | `hideThinkingBlock` | boolean | `false` | Hide thinking blocks in output | | `showCacheMissNotices` | boolean | `false` | Show transcript notices for significant prompt-cache misses and compaction or branch-summary usage | | `thinkingBudgets` | object | - | Custom token budgets per thinking level. Anthropic, Google, and Bedrock use these natively. OpenAI-compatible models use them when `compat.thinkingTokenBudgetField` (or `supportsThinkingTokenBudget`) is set. | @@ -319,6 +320,9 @@ See [packages.md](packages.md) for package management details. "defaultProvider": "anthropic", "defaultModel": "claude-sonnet-4-20250514", "defaultThinkingLevel": "medium", + "modelThinkingLevels": { + "anthropic/claude-sonnet-4-20250514": "high" + }, "theme": "dark", "compaction": { "enabled": true, diff --git a/packages/coding-agent/docs/usage.md b/packages/coding-agent/docs/usage.md index 4db22b8c5..85ee15044 100644 --- a/packages/coding-agent/docs/usage.md +++ b/packages/coding-agent/docs/usage.md @@ -38,9 +38,10 @@ Type `/` in the editor to open command completion. Extensions can register custo |---------|-------------| | `/login`, `/logout` | Manage OAuth or API-key credentials | | [`/llama`](llama-cpp.md) | Download, load, and unload llama.cpp router models | -| `/model` | Switch models | +| `/model` | Switch models; Ctrl+S in the picker saves the startup default | +| `/thinking` | Switch thinking level; Ctrl+S in the picker saves the startup default | | `/scoped-models` | Enable/disable models for Ctrl+P cycling | -| `/settings` | Thinking level, theme, message delivery, transport | +| `/settings` | Theme, message delivery, transport, and other preferences | | `/resume` | Pick from previous sessions | | `/new` | Start a new session | | `/name ` | Set session display name |