Docs: opencode.ai/docs/agents lists a built-in `scout` subagent that doesn't exist in v1.18.31 (latest stable)
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 78/100
- Issue type
- Documentation
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- typescript
- Domain
- documentation
Research direction
Start by reviewing the v1 agents documentation at https://opencode.ai/docs/agents and compare its built-in agent list with packages/opencode/src/agent/agent.ts and packages/opencode/src/agent/prompt/. Done means the v1 page no longer claims that scout exists, either by removing the reference or redirecting to the accurate v2 documentation.
Written by the indexing model from the issue text.
Description
Summary
The v1 docs page at https://opencode.ai/docs/agents states:
OpenCode comes with three built-in subagents, General, Explore, and Scout.
On the latest stable v1 release (opencode-ai@1.18.31, npm latest tag), opencode agent list returns only build, plan, explore, general — no scout. The v2 docs page at https://v2.opencode.ai/agents correctly notes "There is no built-in scout agent in V2."
Evidence
Source of truth on dev
packages/opencode/src/agent/agent.ts registers exactly these native agents:
build(primary)plan(primary)general(subagent)explore(subagent)compaction(hidden primary)title(hidden primary)summary(hidden primary)
packages/opencode/src/agent/prompt/ contains: compaction.txt, explore.txt, summary.txt, title.txt — no scout.txt (404 on the canonical URL).
Timeline (from dev git history on packages/opencode/src/agent/prompt)
- 2026-05-08 —
feat(core): add scout agent for repo research (#24149)—scout.txtadded and registered inagent.ts. - 2026-06-02 —
chore(opencode): remove scout agent (#30435)—scout.txtdeleted and unregistered. - Post-2026-06-02 —
opencode-ai@1.18.31released as npmlatest. Never shipped scout. - 2026-09-20 (today) — v1 docs page at
opencode.ai/docs/agentsstill describes scout as built-in. Never updated after the June 2 removal.
Repro
$ npm view opencode-ai version
1.18.31
$ opencode --version
1.18.31
$ opencode agent list | grep -E "^\w+ \("
build (primary)
plan (primary)
explore (subagent)
general (subagent)
# Note: no "scout" entry
Expected
The v1 docs page should not list scout as a built-in subagent, OR the v1 docs URL should redirect to v2 (which has accurate content).
Suggested fix
Either:
- Remove the scout references from https://opencode.ai/docs/agents so it matches v1.18.31 reality, or
- Redirect
opencode.ai/docs/agents→opencode.ai/v2/docs/agentsif v1 docs are no longer being maintained (the v2 page already has the correct statement).
Environment
- opencode-ai@1.18.31 (npm
latest) - Linux
- Found by an opencode user verifying whether
@scoutexists in their install.
- Dominant language
- TypeScript
- Stars
- 209k
- Forks
- 27.5k
- Avg merge
- 7h 20m
- Merged PRs (30d)
- 358
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from anomalyco/opencode
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
-
[FEATURE]: Bump gitlab-ai-provider to 6.15.1 on v2 (Fable 5.1, GPT-6 Astra, workflow reconnect fix) Open
Difficulty 1/5 Under an hour Newbie friendliness 90/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
-
Difficulty 1/5 Under an hour Newbie friendliness 88/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
All issues in anomalyco/opencode
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
Eynzof/Hermes-CN-Desktop#610 ·
-
bug clawsweeper:linked-pr-open clawsweeper:needs-live-repro clawsweeper:no-new-fix-pr impact:message-loss issue-rating: 🐚 platinum hermit P2 regression
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
calcite-components needs triage refactor
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
Esri/calcite-design-system#15203 ·
-
Difficulty 1/5 Under an hour Newbie friendliness 78/100
fullcalendar/fullcalendar#8106 ·