Browse Source

docs: fix agent name casing in documentation (#117)

* docs: fix agent name casing in documentation

- Update all instances of 'openagent' to 'OpenAgent'
- Update all instances of 'opencoder' to 'OpenCoder'
- Fixes #115: --agent flag is case-sensitive

The --agent flag requires capitalized agent names (OpenAgent, OpenCoder)
but documentation showed lowercase versions, causing confusion for users.
Updated README.md and all docs/ files to use correct casing.

* refactor: migrate from grok-code to big-pickle model

- Remove model specification from contextscout.md subagent
- Update eval YAML files to use opencode/big-pickle
- Update documentation to reference big-pickle as default
- Fixes compatibility as grok-code-fast is no longer available

Files updated:
- .opencode/agent/subagents/core/contextscout.md
- evals/agents/shared/tests/golden/00-smoke-test.yaml
- evals/agents/shared/tests/golden/02-delegation-test.yaml
- evals/README.md
- evals/EVAL_FRAMEWORK_GUIDE.md
Darren Hinde 2 months ago
parent
commit
041e3238bc

+ 0 - 1
.opencode/agent/subagents/core/contextscout.md

@@ -7,7 +7,6 @@ category: subagents/core
 type: subagent
 version: 4.0.0
 author: darrenhinde
-model: "opencode/grok-code"
 
 # Agent Configuration£
 mode: subagent

+ 7 - 7
README.md

@@ -165,7 +165,7 @@ cp -r .opencode/context ~/.opencode/
 ### Step 3: Start Building
 ```bash
 # Start the universal agent (recommended for new users)
-opencode --agent openagent
+opencode --agent OpenAgent
 
 # Ask questions or request tasks
 > "Create a React todo list with TypeScript"
@@ -265,7 +265,7 @@ User Request
 
 ### Build a Feature
 ```bash
-opencode --agent openagent
+opencode --agent OpenAgent
 > "Create a user authentication system with email/password"
 
 # OpenAgent will:
@@ -476,7 +476,7 @@ cd /path/to/opencode-agents/integrations/claude-code
 ## Common Questions
 
 **Q: What's the main way to use this?**  
-A: Use `opencode --agent openagent` as your default for general tasks and questions. For complex multi-file coding work, use `opencode --agent opencoder`. Both coordinate with specialists as needed.
+A: Use `opencode --agent OpenAgent` as your default for general tasks and questions. For complex multi-file coding work, use `opencode --agent OpenCoder`. Both coordinate with specialists as needed.
 
 **Q: Does this work on Windows?**  
 A: Yes! Use Git Bash (recommended) or WSL. See [Platform Compatibility Guide](docs/getting-started/platform-compatibility.md) for details.
@@ -646,10 +646,10 @@ This project is licensed under the MIT License.
 
 ## Recommended for New Users
 
-**Start with `openagent`** - your universal coordinator for general tasks, questions, and workflows. It follows a systematic 6-stage workflow (Analyze → Approve → Execute → Validate → Summarize → Confirm) and automatically delegates to specialized subagents when needed.
+**Start with `OpenAgent`** - your universal coordinator for general tasks, questions, and workflows. It follows a systematic 6-stage workflow (Analyze → Approve → Execute → Validate → Summarize → Confirm) and automatically delegates to specialized subagents when needed.
 
 ```bash
-opencode --agent openagent
+opencode --agent OpenAgent
 > "How do I implement authentication in Next.js?"  # Questions
 > "Create a user authentication system"            # Simple tasks
 > "Create a README for this project"               # Documentation
@@ -657,10 +657,10 @@ opencode --agent openagent
 
 OpenAgent will guide you through with a plan-first, approval-based approach. For questions, you get direct answers. For tasks, you see the plan before execution.
 
-**For complex coding work**, use `opencoder`:
+**For complex coding work**, use `OpenCoder`:
 
 ```bash
-opencode --agent opencoder
+opencode --agent OpenCoder
 > "Refactor this codebase to use dependency injection"  # Multi-file refactoring
 > "Analyze the architecture and suggest improvements"   # Architecture analysis
 ```

+ 1 - 1
docs/README.md

@@ -30,7 +30,7 @@ Welcome to the OpenAgents Control documentation! This directory contains all doc
 ### For New Users
 - Start with the main [README](../README.md) in the repository root
 - Follow the [Installation Guide](getting-started/installation.md)
-- Use `opencode --agent openagent` to start building
+- Use `opencode --agent OpenAgent` to start building
 - Read the [OpenAgent Guide](agents/openagent.md) to understand the workflow
 
 ### For Contributors

+ 5 - 5
docs/agents/opencoder.md

@@ -264,7 +264,7 @@ OpenCoder coordinates with specialized subagents:
 ### Example 1: Multi-File Refactoring
 
 ```bash
-opencode --agent opencoder
+opencode --agent OpenCoder
 > "Refactor the authentication module to use dependency injection across all 8 files"
 
 # OpenCoder will:
@@ -282,7 +282,7 @@ opencode --agent opencoder
 ### Example 2: Architecture Analysis
 
 ```bash
-opencode --agent opencoder
+opencode --agent OpenCoder
 > "Analyze the architecture of this codebase and suggest improvements"
 
 # OpenCoder will:
@@ -299,7 +299,7 @@ opencode --agent opencoder
 ### Example 3: Pattern Implementation
 
 ```bash
-opencode --agent opencoder
+opencode --agent OpenCoder
 > "Implement the repository pattern for all database access across the data layer"
 
 # OpenCoder will:
@@ -319,7 +319,7 @@ opencode --agent opencoder
 ### Example 4: Complex Feature
 
 ```bash
-opencode --agent opencoder
+opencode --agent OpenCoder
 > "Implement user authentication with JWT, refresh tokens, and role-based access control"
 
 # OpenCoder will:
@@ -429,7 +429,7 @@ OpenCoder is your **specialized development partner** for:
 
 **Start here:**
 ```bash
-opencode --agent opencoder
+opencode --agent OpenCoder
 > "Your complex coding task..."
 ```
 

+ 1 - 1
docs/features/agent-system-blueprint.md

@@ -21,7 +21,7 @@ _Build Intelligent Workflow Systems with Context-Aware AI_
 ## ⚡ TL;DR - Quick Reference
 
 **For New Users:**
-- Start with `opencode --agent openagent` for all questions and tasks
+- Start with `opencode --agent OpenAgent` for all questions and tasks
 - The agent handles planning, implementation, testing, and review automatically
 - Add your coding patterns to `.opencode/context/project/project-context.md`
 - Let the agent delegate to specialized subagents when needed

+ 1 - 1
evals/EVAL_FRAMEWORK_GUIDE.md

@@ -147,7 +147,7 @@ description: What this test validates
 
 category: developer  # developer, business, creative, edge-case
 agent: openagent     # openagent, opencoder
-model: opencode/grok-code  # Optional, defaults to free tier
+model: opencode/big-pickle  # Optional, defaults to free tier
 
 # Single prompt (simple tests)
 prompt: |

+ 1 - 1
evals/README.md

@@ -159,7 +159,7 @@ Options:
   --debug                Enable debug output, keep sessions for inspection
   --verbose              Show full conversation (prompts + responses) after each test
                          (automatically enables --debug)
-  --model=PROVIDER/MODEL Override model (default: opencode/grok-code-fast)
+  --model=PROVIDER/MODEL Override model (default: opencode/big-pickle)
   --timeout=MS           Test timeout (default: 60000)
   --prompt-variant=NAME  Use specific prompt variant (gpt, gemini, grok, llama)
                          Auto-detects recommended model from prompt metadata

+ 1 - 1
evals/agents/shared/tests/golden/00-smoke-test.yaml

@@ -34,7 +34,7 @@ behavior:
   maxToolCalls: 0
   requiresApproval: false
   expectedAgent: "openagent"
-  expectedModel: "opencode/grok-code"
+  expectedModel: "opencode/big-pickle"
   expectedResponse:
     contains:
       - "Test infrastructure is working correctly"

+ 1 - 1
evals/agents/shared/tests/golden/02-delegation-test.yaml

@@ -35,7 +35,7 @@ behavior:
   maxToolCalls: 10
   requiresApproval: false  # This is a simple test, no approval ceremony needed
   expectedAgent: "openagent"  # Validate correct agent is loaded
-  expectedModel: "opencode/grok-code"  # Validate correct model is used
+  expectedModel: "opencode/big-pickle"  # Validate correct model is used
   expectedResponse:
     contains:
       - "AWESOME TESTING"