Repository navigation
Description
Feature hasn't been suggested before.
- I have verified this feature I'm about to request hasn't been suggested before.
Describe the enhancement you want to request
The problem
Since 2.0, OpenCode ships features faster than its docs and release notes describe them, so after an update I cannot find out what is new or how to use it. The only way to discover post-2.0 behaviour is to read PRs, source, and git log.
I'm scoping this to the two concrete, cheap items underneath that. The rest of the symptoms are already tracked elsewhere.
Ask 1 — re-enable the docs automation (fixes #57623)
docs-update.yml gates its job on if: github.repository == 'sst/opencode'. The repo moved to anomalyco/opencode, so the condition can never be true: the last successful run was 2026-01-02, and ~582 runs since then are conclusion: skipped. docs-locale-sync.yml is if: false, and the v2 tree has no locale directories at all while v1 has 17.
This was reported in #57623 and confirmed by the triage bot on latest dev. As of today it is still open and unfixed. This is the highest-leverage item here: it is a one-line if: change plus a decision about which docs tree the workflow owns (#57623 notes both workflows write packages/web/src/content/docs/, the v1 tree that serves /docs, while the v2 tree is services/www/src/docs/content/).
Ask 2 — publish release notes for every 2.x release
There is no changelog a user can read for 2.x:
- changelog: v2 releases have no published release notes #52184 and No offical release notes for 2.x.x #50345 — v2 releases have no published release notes
- desktop: What's New popup never appears after updates (changelog.json has no highlights) #60134 — the desktop "What's New" popup never appears, because
changelog.jsonhas no highlights - The
/highlightscommand returns "No matching commands" after upgrading to v2.1.1 #57608 —/highlightsreturns "No matching commands" on v2.1.1 - [FEATURE]: RSS feed for changelogs #58525 — users are asking for an RSS feed, i.e. building their own change feed
So the in-app surfaces for release notes already exist and are wired to data that is simply never populated. Publishing a short highlights list per release into changelog.json and GitHub Releases would light up the popup and /highlights for free, without new UI work.
For context on pace: since 2026-09-01 the repo has ~3296 commits (commits API, per_page=1, read from the Link header), against 103 commits touching packages/web/src/content/docs and 236 touching services/www/src/docs/content — about 1 in 7. Meanwhile v2.2.0 and v2.2.1 shipped on 2026-10-27 and 2026-10-29.
Why these two and not "write more docs"
Features that exist today but have no documented path to adoption — OTEL support (#47195), opencode mcp add --url/--header from #31054 (#55285), V2 keyless websearch (#54311), V2 service API auth (#51724), subagent_depth defaulting to 1 so subagents silently cannot delegate (#59826) — are a docs-velocity problem, not a docs-effort problem. Fixing the automation that has been dead since January, and telling users what each release changed, addresses the cause rather than the ~25 individual symptoms filed since.
Activity
opencodejr commentedon Oct 29, 2026
Thanks for pulling all of this together, @lhpaoletti. I think this is a duplicate: each of the two asks is already tracked in its own open issue, and both of those have been reproduced. Ask 1 is #57623 and ask 2 is #60134.
Possible duplicates and related issues, ordered by likelihood:
dev,docs-update.ymlhas since been removed by ci: remove docs-update workflow #58161 for a security reason, so changing theif:line alone would no longer bring it back.changelog.jsonhas emptyhighlights. The v2.2.1 GitHub release body does have a### Highlightslist, but the feed generator only understands the older<highlight>blocks and##headings, so it drops them. This is the main cause behind your Ask 2./highlightscommand returns "No matching commands" after upgrading to v2.1.1 #57608:/highlightsis missing on v2.x. It is registered only when a build has release highlights embedded, so it comes from the same missing highlight data.The bot will close this issue as a duplicate in 1 day unless you reply explaining how it differs from these. If you have more details, adding them to #57623 or #60134 is the best way to make sure they're seen.
lhpaoletti commentedon Oct 29, 2026
Oh, my bad 😅 You're right, both of those already exist. Checked and you're correct on both counts — the workflow is gone, and the notes are published, I just never found the feed. Close this as a dup, no hard feelings. I left the state-of-the-workflows update over on #57623 since its suggested fix is now impossible to apply.
opencodejr commentedon Oct 30, 2026
We haven't heard back in the last day, so I'm closing this as a duplicate. Both of your asks are already tracked in open, reproduced issues:
docs-update.ymlhas since been removed ondevby ci: remove docs-update workflow #58161.changelog.json, which stops the What's New popup and/highlightsfrom working (Ask 2, together with The/highlightscommand returns "No matching commands" after upgrading to v2.1.1 #57608).Please follow those issues for updates, or add any new details there. If this issue covers something they don't, reply here and it can be reopened. Thanks again for the thorough write-up, @lhpaoletti.