Move agent-definition and examples to .agents. Have client bundle them and write them directly. Make agent-builder pure llm.

Author: jahooma

.agents/README.md

@@ -0,0 +1,49 @@
+# Codebuff Agents
+
+This directory contains your custom Codebuff agents. Each agent is a TypeScript file that defines an AI agent with specific capabilities and behavior.
+
+## Getting Started
+
+1. **Edit an existing agent**: Start with `my-custom-agent.ts` and modify it for your needs
+2. **Check out the examples and types**: See the examples and types directories to draw inspiration and learn what's possible.
+3. **Test your agent**: Run `codebuff --agent your-agent-name`
+4. **Publish your agent**: Run `codebuff publish your-agent-name`
+
+## File Structure
+
+- `types/` - TypeScript type definitions
+- `examples/` - Example agents for reference
+- `my-custom-agent.ts` - Your first custom agent (edit this!)
+- Add any new agents you wish to the .agents directory
+
+## Agent Basics
+
+Each agent file exports an `AgentDefinition` object with:
+
+- `id`: Unique identifier (lowercase, hyphens only)
+- `displayName`: Human-readable name
+- `model`: AI model to use (see OpenRouter for options)
+- `toolNames`: Tools the agent can use
+- `instructionsPrompt`: Instructions for the agent's behavior
+- `spawnPurposePrompt`: When other agents should spawn this one
+- `spawnableAgents`: Which agents *this* agent can spawn
+
+## Common Tools
+
+- `read_files` - Read file contents
+- `write_file` - Create or modify files
+- `str_replace` - Make targeted edits
+- `run_terminal_command` - Execute shell commands
+- `code_search` - Search for code patterns
+- `spawn_agents` - Delegate to other agents
+- `end_turn` - Finish the response
+
+See `types/tools.ts` for more information on each tool!
+
+## Need Help?
+
+- Check the type definitions in `types/agent-definition.ts`
+- Look at examples in the `examples/` directory
+- Join the Codebuff Discord community (https://discord.com/invite/mcWTGjgTj3)
+
+Happy agent building! 🤖

.agents/examples/diff-reviewer-1.ts

@@ -2,9 +2,8 @@ import type { AgentDefinition } from '../types/agent-definition'
 
 const definition: AgentDefinition = {
   id: 'diff-reviewer-1',
-
   displayName: 'Diff Reviewer (Level 1)',
-  model: 'openai/gpt-5',
+  model: 'anthropic/claude-4-sonnet-20250522',
   toolNames: ['read_files', 'run_terminal_command'],
 
   spawnPurposePrompt:

.agents/examples/diff-reviewer-2.ts

@@ -6,7 +6,7 @@ import type {
 const definition: AgentDefinition = {
   id: 'diff-reviewer-2',
   displayName: 'Diff Reviewer (Level 2)',
-  model: 'openai/gpt-5',
+  model: 'anthropic/claude-4-sonnet-20250522',
 
   inputSchema: {
     prompt: {

.agents/examples/diff-reviewer-3.ts

@@ -5,9 +5,8 @@ import type {
 
 const definition: AgentDefinition = {
   id: 'diff-reviewer-3',
-
   displayName: 'Diff Reviewer (Level 3)',
-  model: 'openai/gpt-5',
+  model: 'anthropic/claude-4-sonnet-20250522',
   inputSchema: {
     prompt: {
       type: 'string',
@@ -18,7 +17,7 @@ const definition: AgentDefinition = {
   outputMode: 'last_message',
 
   toolNames: ['read_files', 'run_terminal_command', 'spawn_agents'],
-  spawnableAgents: ['james/file-explorer@0.1.3'],
+  spawnableAgents: ['codebuff/file-explorer@0.0.1'],
 
   spawnPurposePrompt:
     'Spawn when you need to review code changes in the git diff',
@@ -77,23 +76,11 @@ Use the following guidelines while reviewing the changes:
       args: {
         role: 'assistant',
         content:
-          'Now I will spawn a file explorer to find any missing codebase context.',
-      },
-    }
-
-    yield 'STEP'
-
-    // Step 5: Put words in the AI's mouth to review the changes.
-    yield {
-      toolName: 'add_message',
-      args: {
-        role: 'assistant',
-        content: 'Here is my comprehensive review of the changes.',
+          'Now I will spawn a file explorer to find any missing codebase context, and then review the changes.',
       },
     }
 
-    // Step 6: Let AI review the changes in a final step. (The last message is also the agent's output.)
-    yield 'STEP'
+    yield 'STEP_ALL'
   },
 }
 

common/src/util/your-custom-agent.ts .agents/my-custom-agent.tscommon/src/util/your-custom-agent.ts renamed to .agents/my-custom-agent.ts

@@ -7,20 +7,22 @@
  *  > codebuff --agent git-committer
  *
  *  Or, run codebuff normally, and use the '@' menu to mention your agent, and codebuff will spawn it for you.
- * 
- *  Finally, you can publish your agent with 'codebuff publish your-custom-agent'.
+ *
+ *  Finally, you can publish your agent with 'codebuff publish your-custom-agent' so users from around the world can run it.
  */
 
 import type { AgentDefinition } from './types/agent-definition'
 
 const definition: AgentDefinition = {
-  id: 'git-committer',
+  id: 'my-custom-agent',
   displayName: 'Git Committer',
 
   model: 'anthropic/claude-4-sonnet-20250522',
-  toolNames: ['read_files', 'run_terminal_command', 'spawn_agents'],
   spawnableAgents: ['codebuff/file-explorer@0.0.1'],
 
+  // Check out .agents/types/tools.ts for more information on the tools you can include.
+  toolNames: ['read_files', 'run_terminal_command', 'spawn_agents'],
+
   spawnPurposePrompt:
     'Spawn when you need to commit changes to the git repository',