Installation

Local path plugin

During development, load the plugin from a local checkout:

{
  "plugin": ["/absolute/path/to/opencode-squad"]
}

Restart OpenCode after changing plugin code or bundled assets.

Package plugin

Once the package is published, load it by package name:

{
  "plugin": ["opencode-squad"]
}

Inline options

OpenCode plugin tuple options can override squad.json values for a specific OpenCode configuration file:

{
  "plugin": [
    [
      "opencode-squad",
      {
        "models": {
          "handlers": {
            "primary": "@provider/gpt"
          }
        }
      }
    ]
  ]
}

Use tuple options sparingly. Prefer squad.json for settings that should be shared across sessions or projects.

Next step

Continue with Configuration to set model handlers, primary-agent behavior, and local paths.