Skip to content

The agent that grows with you

docs(desktop): document the Subagents page in the delegation guide

Tekniumfbb91a318c55
diff --git a/apps/desktop/src/app/settings/config-settings.tsx b/apps/desktop/src/app/settings/config-settings.tsx
index b48a15225f5..d64b709cdea 100644
--- a/apps/desktop/src/app/settings/config-settings.tsx
+++ b/apps/desktop/src/app/settings/config-settings.tsx
@@ -509,12 +509,7 @@ function ConfigSettingsInner({
{visibleFields.map(([key, field]) => (
<div className="scroll-mt-6 rounded-lg" id={`setting-field-${key}`} key={key}>
{key === 'delegation.model' ? (
- <DelegationRouteRow
- config={config}
- onConfigChange={updateConfig}
- schema={field}
- scope={writeScope ?? scopeProfile}
- />
+ <DelegationRouteRow config={config} onConfigChange={updateConfig} scope={writeScope ?? scopeProfile} />
) : (
<ConfigField
descriptionExtra={
diff --git a/apps/desktop/src/app/settings/delegation-route-row.tsx b/apps/desktop/src/app/settings/delegation-route-row.tsx
index 660036a7aa9..05d8c92172f 100644
--- a/apps/desktop/src/app/settings/delegation-route-row.tsx
+++ b/apps/desktop/src/app/settings/delegation-route-row.tsx
@@ -1,6 +1,6 @@
import type { ProfileScope } from '@/hermes'
import { useI18n } from '@/i18n'
-import type { ConfigFieldSchema, HermesConfigRecord } from '@/types/hermes'
+import type { HermesConfigRecord } from '@/types/hermes'
import { FIELD_DESCRIPTIONS } from './constants'
import { DelegationModelProviderField, type DelegationModelProviderValue } from './delegation-model-provider-field'
@@ -31,12 +31,10 @@ export function applyDelegationRoute(
/** One provider + model route draft for subagents, read from and written back to the owner's config. */
export function DelegationRouteRow({
config,
- schema,
scope,
onConfigChange
}: {
config: HermesConfigRecord
- schema: ConfigFieldSchema
scope?: ProfileScope
onConfigChange: (next: HermesConfigRecord) => void
}) {
@@ -44,8 +42,7 @@ export function DelegationRouteRow({
const description =
fieldCopyForSchemaKey(t.settings.fieldDescriptions, 'delegation.model') ??
- fieldCopyForSchemaKey(FIELD_DESCRIPTIONS, 'delegation.model') ??
- schema.description
+ fieldCopyForSchemaKey(FIELD_DESCRIPTIONS, 'delegation.model')
return (
<div data-tour="field-delegation.model">
diff --git a/website/docs/user-guide/desktop.md b/website/docs/user-guide/desktop.md
index 366d8c7edc6..2021ee43feb 100644
--- a/website/docs/user-guide/desktop.md
+++ b/website/docs/user-guide/desktop.md
@@ -115,7 +115,7 @@ Open **Settings → Model → Subagents** to choose a delegated agent's provider
Provider and model changes remain a local draft until you click **Apply**. **Cancel**, leaving the page, or changing the settings profile discards an unapplied route. A provider switch requires a model; select **Use parent model** explicitly for a provider-only override, and make sure that provider supports the parent's model.
-**Inherit from main agent** uses the parent's model and credentials. **Custom model (use parent credentials)** overrides only the model. Existing direct endpoints are shown as **Direct endpoint override**. Applying a different route clears the superseded delegation endpoint and its stored key together, without removing other request settings. If the catalog is unavailable, use **Custom provider...** and **Custom model…** to enter a route manually, or click **Retry** without losing your draft.
+**Inherit from main agent** uses the parent's model and credentials. **Custom model (use parent credentials)** overrides only the model. Existing direct endpoints are shown as **Direct endpoint override**. Applying a different route clears the superseded delegation endpoint, its stored key and its wire protocol together, without removing other request settings. If the catalog is unavailable, use **Custom provider...** and **Custom model…** to enter a route manually, or click **Retry** without losing your draft.
### File browser
diff --git a/website/docs/user-guide/features/delegation.md b/website/docs/user-guide/features/delegation.md
index 1efe1662a81..2dc4175ba35 100644
--- a/website/docs/user-guide/features/delegation.md
+++ b/website/docs/user-guide/features/delegation.md
@@ -274,6 +274,8 @@ delegation:
If omitted, subagents use the same model as the parent.
+In Desktop, set the same keys under **Settings → Model → Subagents** (see [Desktop](../desktop.md#subagent-models-and-limits)). The page edits the profile chosen under **Applies to**, affects subagents launched after you click **Apply**, and never changes the main model or a child that is already running.
+
### Cost strategy: frontier planner, inexpensive workers
Decomposing a problem into well-specified subtasks takes frontier-level judgment; executing a subtask that already comes with a clear goal, full context, and an output contract usually doesn't. Meanwhile the children are where the tokens go — a parallel batch of subagents typically burns the large majority of a run's total tokens, so the worker model is where the cost actually lives. Pinning `delegation.model` to an inexpensive model while your main session stays on a frontier model keeps the planning quality where it matters and cuts spend where the volume is: