Docs: opencode.ai/docs/agents lists a built-in `scout` subagent that doesn't exist in v1.18.31 (latest stable)

Open Beginner friendly
#50,242 0 comments 0 reactions 0 assignees View on GitHub

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-08feat(core): add scout agent for repo research (#24149)scout.txt added and registered in agent.ts.
  • 2026-06-02chore(opencode): remove scout agent (#30435)scout.txt deleted and unregistered.
  • Post-2026-06-02opencode-ai@1.18.31 released as npm latest. Never shipped scout.
  • 2026-09-20 (today) — v1 docs page at opencode.ai/docs/agents still 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:

  1. Remove the scout references from https://opencode.ai/docs/agents so it matches v1.18.31 reality, or
  2. Redirect opencode.ai/docs/agentsopencode.ai/v2/docs/agents if 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 @scout exists in their install.
Dominant language
TypeScript
Stars
209k
Forks
27.5k
Avg merge
7h 20m
Merged PRs (30d)
358

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from anomalyco/opencode

All issues in anomalyco/opencode

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.