Skip to content
OpenCode
Esc
navigateopen⌘Jpreview

Plugins

Add plugins to cli.json:

{
  "plugins": ["opencode.example", "./plugins/status.ts"]
}

Entries are processed in order. Prefix an ID or wildcard with - to disable matching plugins:

{
  "plugins": ["*", "-opencode.notifications", "-team.*"]
}

Pass plugin options with the object form:

{
  "plugins": [
    {
      "package": "@example/opencode-tui",
      "options": {
        "compact": true
      }
    }
  ]
}

package accepts a package name, an absolute path, a file:// URL, or a path relative to cli.json.

OpenCode also discovers JavaScript and TypeScript plugins from plugins/tui under the global config directory and project .opencode directories.

Was this page helpful?