# Plugins & connectors



Beyond your own [custom skills](/docs/build/interactive#slash-commands),
Cluster Build can use plugins and connections that your organization
administers centrally.

* **Plugins** are verified, versioned skill packages an organization installs
  once and members can then activate per turn.
* **Connectors** are existing authenticated [Agents](/docs/agents/agents)
  connections — for example Gmail — that a turn can use without you signing in
  again.

## Manage plugin installations [#manage-plugin-installations]

`cluster plugins` manages your organization's installed plugins. It requires a
trusted workspace, since it runs headlessly like `cluster exec`.

```bash
cluster plugins list
cluster plugins install <plugin> <revision> --generation <n>
cluster plugins enable <plugin> --generation <n>
cluster plugins disable <plugin> --generation <n>
cluster plugins inspect <plugin>
```

| Subcommand                                     | Effect                                                                                  |
| ---------------------------------------------- | --------------------------------------------------------------------------------------- |
| `list`                                         | List the organization's installed plugins, their revisions, and whether each is enabled |
| `install <plugin> <revision> --generation <n>` | Select an admitted, immutable revision; `--generation 0` creates a new installation     |
| `enable <plugin> --generation <n>`             | Enable an installation at its current generation                                        |
| `disable <plugin> --generation <n>`            | Disable an installation at its current generation                                       |
| `inspect <plugin>`                             | Download and verify the complete installed package without activating it                |

Pass `--organization <id>` to act on an organization other than your signed-in
account's default:

```bash
cluster plugins list --organization <org-id>
```

The global `--plugin-organization <id>` flag sets the same organization for a
whole run, including an interactive session's `/plugins` view.

## Use a plugin or connector in a session [#use-a-plugin-or-connector-in-a-session]

Installed and enabled plugins, and your connected accounts, are resolved for
each turn of an interactive session — there are no per-run `--plugin` or
`--connector` flags. Manage them from the session itself:

| Command       | Effect                                                                                                  |
| ------------- | ------------------------------------------------------------------------------------------------------- |
| `/plugins`    | Browse the organization plugin catalog and install, update, enable, or disable plugins inline           |
| `/connectors` | Manage your connected accounts — opens the account page in your browser and refreshes status in the TUI |

Because selection is refreshed per turn, a plugin disabled mid-session stops
being available on the next turn.

## List your connections [#list-your-connections]

`cluster connectors` lists your existing Agents connections and whether each
is currently connected, without starting a new sign-in flow:

```bash
cluster connectors
```

## Next steps [#next-steps]

* **[Interactive sessions](/docs/build/interactive)** — the full slash-command
  reference, including `/plugins`, `/connectors`, `/skills`, and `/mcp`.
* **[Exec & sessions](/docs/build/exec)** — run one-shot prompts
  non-interactively.