[oke3]

Issue for this PR

No issue.

Type of change

• Documentation

What does this PR do?

The opencode debug section of the CLI reference listed the command and nothing else, while the CLI defines three subcommands under it: agents, config and paths. This documents each one, using the wording the CLI itself uses, including the optional name argument for paths and the paths it accepts.

How did you verify your code works?

Checked against the command definitions in packages/cli/src/commands/commands.ts on this branch, and built the docs site.

Screenshots / recordings

Not a UI change.

Checklist

• I have tested my changes locally
• I have not included unrelated changes in this PR

[opencode-agent]

Thanks for filling in this section. As written, though, it documents the wrong CLI. This page is on dev, where the CLI is v2, and recent docs work has been bringing this page in line with v2 (#56922, and #57419, which removes the v1-only opencode agent section). In v2, packages/cli/src/commands/commands.ts defines only three debug subcommands:

• agents: List all agents
• config: List configuration sources
• paths [name]: Show global paths; the optional name prints a single path (db, home, data, config, cache, state, tmp, bin, log, repos)

skill, info, startup, scrap, lsp, rg, file, snapshot, v2 and wait don't exist in v2, and agent is agents there. Running them gives users an error. Could you narrow the section to these three, using v2's own wording, and include the paths argument?

I checked this by comparing the docs with the command definitions on this branch and on the latest dev. It's a docs-only change, so there was nothing to run. Public API: unchanged (documentation only).

[opencode-agent]

These sections come from the v1 (1.19.3) binary, but the CLI on dev is v2, and its debug command (packages/cli/src/commands/commands.ts) only has agents, config ("List configuration sources") and paths [name]. Please drop skill, info, startup, agent, scrap, lsp, rg, file, snapshot, v2 and wait, add agents, and document the optional name argument of paths (db, home, data, config, cache, state, tmp, bin, log, repos).

[oke3]

Narrowed to the three v2 subcommands, as you suggested — you are right that this page is being brought in line with v2, and the v1-only subcommands (skill, info, startup, scrap, lsp, rg, file, snapshot, v2, wait) would error for a v2 user.

The section now documents agents, config and paths [name] with the CLI's own wording, including the optional name argument and the paths it accepts (db, home, data, config, cache, state, tmp, bin, log, repos).

For the record on where the v1 list came from: those thirteen subcommands are the v1.19.3 CLI's opencode debug set, which I read from the released binary and the v1 tag. That was the wrong product line for this page — thanks for the correction.