Answer: Rename the "plugin" key to "plugins" and replace each package-and-options tuple with an object using "package" and "options" fields. Configured local paths must name directories, so move the ported implementation to ./plugin/local/index.ts. Status: Confirmed Entry: tool/opencode/settings/migrate-plugin-configuration Revision: 1 Digest: sha256:d917c1782cc5def4 (changes whenever the content changes) Timeline: Created: 2026-11-13T03:55:52Z Last changed: 2026-11-13T03:55:52Z Last verified: 2026-11-20T13:44:39Z Next check: 2026-11-21T13:44:39Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of key rename | Rename plugin to plugins | [1] | 2026-11-20 V2 format | { "plugins" : [ "opencode-example-plugin" , { "package" : "./plugin/local" , "options" : { "enabled" : true } } ] } | [1] | 2026-11-20 local path requirement | Configured local paths must name directories. | [1] | 2026-11-20 example target file | ./plugin/local/index.ts | [1] | 2026-11-20 V2 plugin directories | .opencode/plugin/ and .opencode/plugins/ | [1] | 2026-11-20 Sources: [1] opencode. "Migrate plugins from V1 | OpenCode". https://opencode.ai/docs/build/plugins/migrate-v1/ Role: primary. Accessed: 2026-11-20T13:44:39Z Quote: "Rename plugin to plugins" (Supports: key rename) Quote: "{ "plugins" : [ "opencode-example-plugin" , { "package" : "./plugin/local" , "options" : { "enabled" : true } } ] }" (Supports: V2 format) Quote: "Configured local paths must name directories." (Supports: local path requirement) Quote: "move the ported implementation to ./plugin/local/index.ts" (Supports: example target file) Quote: "V2 discovers local plugins from both .opencode/plugin/ and .opencode/plugins/" (Supports: V2 plugin directories) Snapshot SHA-256: db1439aa8b57731696e9ec9c27b28c80bc13d20443cbb0a07a179685f7003acc (captured 2026-11-13T03:55:52Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. On this check the text of [1] was unchanged since 2026-11-13T03:55:52Z, so the values verified then were kept. Cross-check: not-available at 2026-11-20T13:44:39Z. No independent second source is configured for this entry Last successful check: 2026-11-20T13:44:39Z Last attempt: 2026-11-20T13:44:39Z Notes and limitations: Extracted automatically from a single official source (section "Migrate plugin configuration"). Related: https://latestn.com/tool/opencode/settings/migrate-v1-config-to-v2 How do I migrate my opencode V1 configuration to V2? https://latestn.com/tool/opencode/settings/persist-proxy-for-service How do I make proxy environment variables persist for the opencode background service? https://latestn.com/tool/opencode/settings/plugin-discovery-locations Where does opencode discover plugins from, and do I need to add them to cli.json? https://latestn.com/tool/opencode/settings/inline-cli-config How do I apply opencode CLI settings from inline JSON? https://latestn.com/tool/opencode/settings/jsonc-format-support Does opencode config support comments and trailing commas? https://latestn.com/tool/opencode/settings/local-directory-reference How do I use a local directory as a reference in opencode? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-13T03:55:52Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/opencode/settings/migrate-plugin-configuration/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/opencode/settings/migrate-plugin-configuration POST: https://latestn.com/dispute/tool/opencode/settings/migrate-plugin-configuration with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/opencode/settings/migrate-plugin-configuration?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). How do I migrate an opencode plugin's configuration from V1 to V2? Revision 1, last verified 2026-11-20T13:44:39Z. https://latestn.com/tool/opencode/settings/migrate-plugin-configuration (accessed 2026-11-21T09:50:40Z). @misc{LatestN_tool_opencode_settings_migrate_plugin_configuration_r1, title = {How do I migrate an opencode plugin's configuration from V1 to V2?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/opencode/settings/migrate-plugin-configuration}}, note = {Revision 1; digest sha256:d917c1782cc5def4; last verified 2026-11-20T13:44:39Z; accessed 2026-11-21T09:50:40Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/opencode/settings/migrate-plugin-configuration