docs: /docs/plugins and /docs/ecosystem still describe the v1 plugin API; /v2/docs/ecosystem is 404 #56800

Activity

1. opencode-agent commented on Oct 18, 2026

   

   opencode-agentBot

   on Oct 18, 2026 – with OpenCode Agent

   Contributor

   More actions

   Thanks for checking this so carefully, and for offering to help with the table.

   In short, you're asking for:

   • a clear v1 banner (or a redirect) on /docs/plugins and /docs/ecosystem, which still show the v1 plugin API and are what search engines and READMEs link to
   • a v2-compatibility column in the ecosystem table, with archived or superseded projects marked
   • a published /v2/docs/ecosystem page, or a link to the v1 page with a caveat

   The v1 pages in this repo (packages/web/src/content/docs/plugins.mdx and ecosystem.mdx) don't say anywhere which version they cover, so this gap is real. Maintainers will consider it. Please wait for them to confirm the structure before opening the PR, so it doesn't go in the wrong direction.

   Related issues and PRs:

   • v2 Docs vs v1 Docs: v2's are outdated, miss information and nav is way worse #50683: v2 docs are behind the v1 docs and harder to navigate
   • fix(console): point marketing docs links to the v2 docs #56530: PR that moves the site's marketing links from /docs to /v2/docs
   • Plugins: v2 definition API exposes no tool/event registration - v1 hook-map plugins fail every load, docs still show the v1 shape #56630 and beta: V1 plugins unloadable with no migration path, custom commands unreachable headless, no V2 plugin/API docs for agents #48365: v1-style plugins fail to load in v2, and the docs still show the v1 shape
   • [FEATURE]: backward compatibility for v1 plugins in v2 #48138: request for v1 plugin compatibility in v2
   • docs: add Agent Relay to V2 ecosystem #54249, docs(web): list Splash plugin in V2 ecosystem #54285, docs: add opencode-model-aliases to the V2 ecosystem #54470: ecosystem PRs that say "V2 ecosystem"
   • Unmatched /v2 URLs show Astro's default 404 page instead of the branded one #46348: unmatched /v2 URLs show the default 404 page
2. Tarquinen commented on Nov 2, 2026

   

   Tarquinen

   on Nov 2, 2026

   Member

   More actions

   Thanks for the report! The /docs pages are the legacy docs for OpenCode 1 users, so /docs/plugins describes the 1.x plugin API, and like the rest of those pages it links to V2 from the banner at the top. The OpenCode 2 plugin docs are at https://opencode.ai/v2/docs/plugins. The ecosystem page is being replaced soon, so we aren't changing the current one. Closing this issue.

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

   closed this as not plannedon Nov 2, 2026