Repository navigation
docs(cli): drop the attach command from the translated CLI docs - #58207
Closed
LuisAlbertoMK wants to merge 1 commit into
Closed
LuisAlbertoMK wants to merge 1 commit into
LuisAlbertoMK wants to merge 1 commit into
Conversation
opencode attach is not a v2 command: it exits 1 and prints the root usage, because the word is read as the project directory. The English page is handled in anomalyco#58016, so this carries the same removal to the 17 translated cli.mdx files, using the cleanup of the removed agent command in anomalyco#57419 as the precedent. Also fixes the run example and flag row, which still passed --attach instead of the root --server flag. Part of anomalyco#57957.
This was referenced Oct 22, 2026
Contributor
There was a problem hiding this comment.
The translated attach removals are clean: each of the 17 locale diffs drops exactly the ### attach block and ends before ### auth. The English run change is correct: run takes --server in packages/cli/src/commands/commands.ts, and the new table text matches the description there. Docs only, so there was nothing to run.
Public API: unchanged (docs only).
Concerns:
- The translated
runsections still use--attach. All 17 translatedcli.mdxfiles still containopencode run --attach http://localhost:4096 …and an--attachrow in therunflag table (e.g.de/cli.mdxlines 274 and 290). This PR fixes that only in English, so English and the translations now disagree. Since these files are already being edited here, please apply the same--attach→--serverchange to them. - A follow-up, not needed here:
web.mdxin English and the locales still showsopencode attach http://localhost:4096(line 120).
Related: #57957
This was referenced Oct 22, 2026
Member
|
Thanks for the PR! The — from 𝕺𝖕𝖊𝖓𝕮𝖔𝖉𝖊 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Issue for this PR
Part of #57957. It does not depend on #58016, but that PR does the same removal on the English page, so land it first if you want every locale to agree in a single step.
Type of change
What does this PR do?
opencode attachis not a v2 command. It exits 1 and prints the root usage, because the word is read as the project directory.#58016already removes the section from the Englishcli.mdx, so this PR leaves that file alone and removes it from the 17 translatedcli.mdxfiles, the same way the removedagentcommand was cleaned up in #57419.It also fixes the
runsection, which #58016 does not cover: its example and flag row still passed--attach. Connecting to a server is the root--serverflag now, and the description in the table is the one frompackages/cli/src/commands/commands.ts.Only the
attachrow of #57957 is covered here. The other translated sections (web,db,export,import,github,pr) are still there, and their wording is a maintainer's call.How did you verify your code works?
Against a source build of
dev(cdf1c200a6), frompackages/cli:bun run src/index.ts --helplists--serverand noattachsubcommand.bun run src/index.ts run --helphas--serverand no--attach.bun run src/index.ts attach http://localhost:4096exits 1 with the root usage.cli.mdxdiff is deletions only (0 insertions), so there is no encoding or line-ending churn, and code fences stay balanced in all 18 files.### auth.prettieroutput forcli.mdxis byte-identical to the file.Screenshots / recordings
Not a UI change.
Checklist
Added by the opencode bot (AI-generated).
Related: #57957