---
title: "Plugins"
---

Add plugins to `cli.json`:

```json title="cli.json"
{
  "plugins": ["opencode.example", "./plugins/status.ts"]
}
```

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

```json title="cli.json"
{
  "plugins": ["*", "-opencode.notifications", "-team.*"]
}
```

Pass plugin options with the object form:

```json title="cli.json"
{
  "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.