diff --git a/src/oss/deepagents/code/approval-modes.mdx b/src/oss/deepagents/code/approval-modes.mdx index 6a8f2d95d8..1833e738f1 100644 --- a/src/oss/deepagents/code/approval-modes.mdx +++ b/src/oss/deepagents/code/approval-modes.mdx @@ -137,6 +137,59 @@ flowchart TD ``` +### Select a classifier model + +By default, the Auto classifier uses the same model as the main agent. You can point it at a different (typically cheaper and faster) model to reduce cost and latency during Auto review. + +Set the classifier model through any of these source: + + + + Run `/auto model` to open the interactive model picker and select a classifier model for the current session. To specify a model directly, pass it as an argument: + + ```txt + /auto model openai:gpt-5.6-luna + /auto model clear + ``` + + Use `/auto model clear` to go back to inheriting the main model. + + + ```bash + dcode -y --auto-classifier-model openai:gpt-5.6-luna + ``` + + `--auto-classifier-model` is only accepted in interactive TUI sessions. + + + ```bash + export DEEPAGENTS_CODE_AUTO_CLASSIFIER_MODEL="openai:gpt-5.6-luna" + ``` + + + A **project `.env`** cannot set `DEEPAGENTS_CODE_AUTO_CLASSIFIER_MODEL`. Only shell exports, `~/.deepagents/.env`, the CLI flag, and `/auto model` work. + + + + ```toml title="~/.deepagents/config.toml" + [models] + auto_classifier = "openai:gpt-5.6-luna" + ``` + + +
+ + 1. **`/auto model` TUI command**: takes effect immediately for the current session. + 2. **`--auto-classifier-model` flag**: sets the classifier on launch (interactive TUI sessions only). + 3. **`DEEPAGENTS_CODE_AUTO_CLASSIFIER_MODEL` environment variable**: applies at startup. + 4. **`[models].auto_classifier` in `config.toml`**: your persistent default. + 5. **Inherit**: uses the main agent model (the default when nothing is configured). + + A blank value at any level means "inherit from the next source". For example, an unset env var falls through to `config.toml`. + + +The TUI displays which model is reviewing when Auto turns on and inside `/auto model` output. + ### Revalidate before side effects The decision plan is bound to the thread, mode, batch, and exact gated calls. Missing or invalid state, a mode race, or a replay falls back to human review. For example, if you switch to Manual while classifier review is in progress, an earlier Auto decision cannot execute silently; the normal approval UI opens instead. diff --git a/src/oss/deepagents/code/cli-reference.mdx b/src/oss/deepagents/code/cli-reference.mdx index bf37e257ae..7579f03605 100644 --- a/src/oss/deepagents/code/cli-reference.mdx +++ b/src/oss/deepagents/code/cli-reference.mdx @@ -318,6 +318,7 @@ Run OAuth login for MCP servers marked `auth: "oauth"` with `dcode mcp login