From 2ba7cb5326ddcfb6080e36b9fc98e5aa0e46b3b2 Mon Sep 17 00:00:00 2001 From: Abhi Date: Mon, 13 Apr 2026 14:56:18 -0400 Subject: [PATCH 1/2] docs(core): update generalist agent documentation --- docs/core/subagents.md | 21 ++++++++++++++++----- 1 file changed, 16 insertions(+), 5 deletions(-) diff --git a/docs/core/subagents.md b/docs/core/subagents.md index a31cdfd324e..20e69dcd3c0 100644 --- a/docs/core/subagents.md +++ b/docs/core/subagents.md @@ -87,11 +87,22 @@ Gemini CLI comes with the following built-in subagents: ### Generalist Agent -- **Name:** `generalist_agent` -- **Purpose:** Route tasks to the appropriate specialized subagent. -- **When to use:** Implicitly used by the main agent for routing. Not directly - invoked by the user. -- **Configuration:** Enabled by default. No specific configuration options. +- **Name:** `generalist` +- **Purpose:** Executes broad, resource-heavy tasks using inherited tool access + and configurations from the main agent, while keeping the session history + optimized. +- **When to use:** Use this agent when a task requires many steps, handles large + volumes of information, or requires the same full capabilities as the main + agent. It is ideal for: + - **Multi-file modifications:** Applying refactors or fixing errors across + several files at once. + - **High-volume execution:** Running commands or tests that produce extensive + terminal output. + - **Action-oriented research:** Investigations where the agent needs to both + search code and run commands or make edits to find a solution. By delegating + these tasks, you prevent your main conversation from becoming cluttered or + slow. You can invoke it explicitly using `@generalist`. +- **Configuration:** Enabled by default. ### Browser Agent (experimental) From 6d0d457cb8ef16ad22009d1ab1cca81bc7e705c3 Mon Sep 17 00:00:00 2001 From: Abhi Date: Mon, 13 Apr 2026 16:14:40 -0400 Subject: [PATCH 2/2] docs(core): refine generalist agent purpose for context optimization --- docs/core/subagents.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/core/subagents.md b/docs/core/subagents.md index 20e69dcd3c0..d2069b5b12b 100644 --- a/docs/core/subagents.md +++ b/docs/core/subagents.md @@ -88,9 +88,10 @@ Gemini CLI comes with the following built-in subagents: ### Generalist Agent - **Name:** `generalist` -- **Purpose:** Executes broad, resource-heavy tasks using inherited tool access - and configurations from the main agent, while keeping the session history - optimized. +- **Purpose:** A general, all-purpose subagent that uses the inherited tool + access and configurations from the main agent. Useful for executing broad, + resource-heavy subtasks in an isolated conversation, optimizing your main + agent's context by returning only the final result of that given task. - **When to use:** Use this agent when a task requires many steps, handles large volumes of information, or requires the same full capabilities as the main agent. It is ideal for: