You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
plugins: all user plugins fail to load with SchemaError after V1→V2 upgrade #39345
After upgrading to V2 (@opencode-ai/cli@next), all configured user plugins fail to load with SchemaError. The plugins export V1-style async functions instead of V2's Plugin.define() objects.
Environment
opencode version: 0.0.0-next-16381
OS: Darwin 24.6.0 (darwin arm64)
Terminal: Ghostty (xterm-ghostty, truecolor)
Shell: /bin/zsh
Install/channel: npm next tag
Active plugins: None (all 3 configured plugins failed)
The /api/plugin endpoint returns only built-in plugins; none of the user plugins appear.
Additional Context
Config uses V1 format ("plugin" singular, "provider" with npm/options). V2 translates the config entry automatically, but plugin implementation code must also be ported.
These are third-party npm packages — end users cannot port them. Plugin authors need to update for V2.
Could V2 provide backward-compatible loading for V1-style plugin exports during the beta? The migration guide mentions "OpenCode should be able to migrate the majority of V1 plugins while keeping related local modules and dependencies together" once the API is finalized.
Activity
kitlangton commentedon Aug 11, 2026
V2 intentionally has a new plugin API, so V1 async-function plugin exports do not satisfy the V2 plugin schema. The migration guide now documents this breaking change and the required porting work: https://opencode.ai/v2/docs/migrate-v1#plugins
Closing as expected V2 behavior rather than a config-loading bug.