Let base2 invoke an agent to run read-only terminal commands

Author: jahooma

.agents/base2/base2-factory.ts

@@ -30,7 +30,14 @@ export const base2 = (model: ModelName): Omit<SecretAgentDefinition, 'id'> => ({
   outputMode: 'last_message',
   includeMessageHistory: true,
   toolNames: ['spawn_agent_inline', 'spawn_agents', 'add_message', 'end_turn'],
-  spawnableAgents: ['scout', 'planner', 'editor', 'reviewer', 'context-pruner'],
+  spawnableAgents: [
+    'read-only-commander',
+    'scout',
+    'planner',
+    'editor',
+    'reviewer',
+    'context-pruner',
+  ],
 
   systemPrompt: `You are Buffy, a strategic coding assistant that orchestrates complex coding tasks through specialized sub-agents.
 

.agents/base2/read-only-commander.ts

@@ -0,0 +1,36 @@
+import { publisher } from '../constants'
+import {
+  PLACEHOLDER,
+  type SecretAgentDefinition,
+} from '../types/secret-agent-definition'
+
+const readOnlyCommander: SecretAgentDefinition = {
+  id: 'read-only-commander',
+  publisher,
+  model: 'x-ai/grok-code-fast-1',
+  reasoningOptions: {
+    enabled: true,
+    effort: 'low',
+    exclude: true,
+  },
+  displayName: 'ReadOnly Commander',
+  spawnerPrompt:
+    'Can run quick read-only terminal commands and report back on the results. Has a basic understanding of the codebase.',
+  inputSchema: {
+    prompt: {
+      type: 'string',
+      description:
+        'The question to answer about the codebase or with use of the terminal.',
+    },
+  },
+  outputMode: 'last_message',
+  includeMessageHistory: true,
+  toolNames: ['run_terminal_command', 'code_search', 'read_files'],
+  systemPrompt: `You are an expert software engineer, however you only execute READ ONLY commands to answer the user's question.
+  
+${PLACEHOLDER.FILE_TREE_PROMPT}
+${PLACEHOLDER.KNOWLEDGE_FILES_CONTENTS}`,
+  instructionsPrompt: `Use the tools to answer the user's question. But do not invoke any terminal commands that could have any permanent effects -- no editing files, no running scripts, no git commits, no installing packages, etc.`,
+}
+
+export default readOnlyCommander

.agents/base2/scout.ts

@@ -10,7 +10,7 @@ const definition: SecretAgentDefinition = {
   model: 'openai/gpt-5-chat',
   displayName: 'Lewis & Clark',
   spawnableAgents: ['file-explorer', 'web-researcher', 'docs-researcher'],
-  toolNames: ['spawn_agents', 'read_files', 'end_turn'],
+  toolNames: ['spawn_agents', 'read_files', 'code_search', 'end_turn'],
 
   inputSchema: {
     prompt: {
@@ -21,7 +21,7 @@ const definition: SecretAgentDefinition = {
   outputMode: 'last_message',
   includeMessageHistory: true,
 
-  spawnerPrompt: `Spawn this agent when you need a quick answer to a question. Can search the codebase and the web.`,
+  spawnerPrompt: `Spawn this agent when you need a quick answer to a question. Can search the codebase and the web. Has a good understanding of the codebase.`,
   systemPrompt: `You are an expert architect and researcher. You are quick to search the codebase and web, but you only operate in a read-only capacity. (You should not offer to write code or make changes to the codebase.)
 
 You spawn agents to help you gather information and answer the user's question. If you need to spawn multiple agents, it's good to spawn multiple agents in parallel to quickly answer the question.
@@ -30,7 +30,6 @@ Then answer the question to the best of your ability.
 
 You cannot use any other tools beyond the ones provided to you. (No abiltity to read files, write files, or run terminal commands, etc.)
 
-Note: when you spawn the file-explorer, it takes a params field, which is an object with a prompts field, which is an array of strings.
 Note: No need to spawn multiple file-explorer agents, but you can spawn multiple web-researcher or docs-researcher agents.
 
 ${PLACEHOLDER.FILE_TREE_PROMPT}
@@ -39,6 +38,7 @@ ${PLACEHOLDER.KNOWLEDGE_FILES_CONTENTS}`,
   instructionsPrompt: `Instructions:
 In your thinking, consider which agent(s) to spawn.
 - Spawn the file-explorer, web-researcher, docs-researcher, or any combination of the above at the same time with the spawn_agents tool. Do not spawn any more agents after this step. You only get one spawn_agents tool call (which can include multiple agents). Don't narrate what prompts/params you will use for the agents, just use the tool to spawn them.
+- (Optional) Use the code_search or read_files tool to search the codebase for relevant information.
 - Answer the user question to the best of your ability from the information gathered from the agents focusing on the relevant information. Be concise. Never include any of the following in your response:
   - Irrelevant information.
   - A summary of the situation at the end.

common/src/templates/initial-agents-dir/types/agent-definition.ts

@@ -324,6 +324,7 @@ export type ModelName =
 
   // X-AI
   | 'x-ai/grok-4-07-09'
+  | 'x-ai/grok-code-fast-1'
 
   // Qwen
   | 'qwen/qwen3-coder'