From 041e3238bc9409016ead08dcd6c3bc35198c0b2b Mon Sep 17 00:00:00 2001 From: Darren Hinde <107584450+darrenhinde@users.noreply.github.com> Date: Sun, 25 Jan 2026 03:40:21 +0000 Subject: [PATCH] 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 --- .opencode/agent/subagents/core/contextscout.md | 1 - README.md | 14 +++++++------- docs/README.md | 2 +- docs/agents/opencoder.md | 10 +++++----- docs/features/agent-system-blueprint.md | 2 +- evals/EVAL_FRAMEWORK_GUIDE.md | 2 +- evals/README.md | 2 +- .../agents/shared/tests/golden/00-smoke-test.yaml | 2 +- .../shared/tests/golden/02-delegation-test.yaml | 2 +- 9 files changed, 18 insertions(+), 19 deletions(-) diff --git a/.opencode/agent/subagents/core/contextscout.md b/.opencode/agent/subagents/core/contextscout.md index ff50e63..b8fd107 100644 --- a/.opencode/agent/subagents/core/contextscout.md +++ b/.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 diff --git a/README.md b/README.md index 3638213..c0ab8d9 100644 --- a/README.md +++ b/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 ``` diff --git a/docs/README.md b/docs/README.md index 73e5c04..ceec1ea 100644 --- a/docs/README.md +++ b/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 diff --git a/docs/agents/opencoder.md b/docs/agents/opencoder.md index 6a8f58a..605619f 100644 --- a/docs/agents/opencoder.md +++ b/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..." ``` diff --git a/docs/features/agent-system-blueprint.md b/docs/features/agent-system-blueprint.md index 9aeed65..1842a20 100644 --- a/docs/features/agent-system-blueprint.md +++ b/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 diff --git a/evals/EVAL_FRAMEWORK_GUIDE.md b/evals/EVAL_FRAMEWORK_GUIDE.md index 365b6ea..005bf9e 100644 --- a/evals/EVAL_FRAMEWORK_GUIDE.md +++ b/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: | diff --git a/evals/README.md b/evals/README.md index a4032b2..e0a4a4d 100644 --- a/evals/README.md +++ b/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 diff --git a/evals/agents/shared/tests/golden/00-smoke-test.yaml b/evals/agents/shared/tests/golden/00-smoke-test.yaml index 7e11780..0bdacc9 100644 --- a/evals/agents/shared/tests/golden/00-smoke-test.yaml +++ b/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" diff --git a/evals/agents/shared/tests/golden/02-delegation-test.yaml b/evals/agents/shared/tests/golden/02-delegation-test.yaml index c2cc237..e6e097e 100644 --- a/evals/agents/shared/tests/golden/02-delegation-test.yaml +++ b/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"