docs: the /docs page still documents seven v1 commands that do not exist in v2 #57957

Activity

1. opencode-agent commented on Oct 21, 2026

   

   opencode-agentBot

   on Oct 21, 2026 – with OpenCode Agent

   Contributor

   More actions

   Thanks for the careful mapping. I can confirm this.

   I ran each of the seven commands the CLI page documents from an empty directory on v2.1.2 and on the latest dev (f0200df8e, run from source):

   • opencode web, opencode db, opencode export and opencode github fail with Error: ENOENT: no such file or directory, chdir '<cwd>' -> '<word>', because the word is read as the project directory.
   • opencode attach <url>, opencode import <file> and opencode pr <number> just print the root usage text.

   On that commit, packages/web/src/content/docs/cli.mdx still has the attach, github, export, import, web, pr and db sections. None of them are registered in packages/cli/src/commands/commands.ts. The script below runs all seven commands and lists the matching sections in the docs.

   Whether each section should be replaced or dropped is up to the maintainers. Related:

   • [FEATURE]:Content related to opencode web needs to be added to the opencode V2 doc #51574: opencode web is missing from the v2 docs (same chdir error)
   • [Bug / Docs]: CLI command "opencode agent create" returns "Unexpected positional argument: create" #57406 / docs: describe agent creation without the removed CLI command #57419: the same kind of cleanup for the removed agent command
   • docs(cli): document the opencode service commands #57909: open PR adding the service section
   • docs: /docs/plugins and /docs/ecosystem still describe the v1 plugin API; /v2/docs/ecosystem is 404 #56800: other docs pages that still describe v1

   Reproduction script (repro.sh)

   #!/usr/bin/env bash
   # Runs each v1 command documented on packages/web/src/content/docs/cli.mdx against the v2 CLI.
   # OC defaults to `opencode`; set OC="bun ... packages/cli/src/index.ts" to run from source.
   OC=${OC:-opencode}
   DIR=$(mktemp -d); cd "$DIR"
   $OC --version
   for cmd in "attach http://localhost:4096" "web" "db" "export" "import x.json" "github" "pr 1"; do
     echo "=== opencode $cmd"
     timeout 20 $OC $cmd </dev/null 2>&1 | grep -v '^\s*$' | head -4
   done
   # The docs page (in a checkout given by REPO) still has these sections:
   if [ -n "$REPO" ]; then grep -nE '^### (attach|web|db|export|import|github|pr)$' "$REPO/packages/web/src/content/docs/cli.mdx"; fi

   Run it: bash repro.sh
2. opencode-agent

   added

   reproduced

   on Oct 21, 2026
3. LuisAlbertoMK commented on Oct 22, 2026

   

   LuisAlbertoMK

   on Oct 22, 2026

   More actions

   Taking the attach row: #58204. The section is gone from every locale, and the root --server / --standalone flags are in the flag table now, which is what that section was really about.

   One mapping in the checklist is out of date as of dev (cdf1c200a6): export and import are no longer API-only. Both are subcommands now — opencode session export and opencode session import, confirmed with session --help. Those two rows only need to point at the new home instead of the experimental endpoints.

   Left out of that PR, if anyone wants to pick them up: the run flag table also lists --command, --dir, --port, --variant, --password and --username, none of which exist on dev, and web.mdx still has an "Attaching a Terminal" section that runs opencode attach.
4. Tarquinen commented on Nov 2, 2026

   

   Tarquinen

   on Nov 2, 2026

   Member

   More actions

   Thanks for the careful mapping! The /docs pages are the legacy docs for OpenCode 1 users, so they describe the 1.x CLI, where these commands still exist. The OpenCode 2 CLI is documented at https://opencode.ai/v2/docs/cli. Closing this issue.

   — from 𝕺𝖕𝖊𝖓𝕮𝖔𝖉𝖊
5. Tarquinen

   closed this as not plannedon Nov 2, 2026