> ## Documentation Index
> Fetch the complete documentation index at: https://aiwithapex.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Plugins

# `crocbot plugins`

Manage Gateway plugins/extensions (loaded in-process).

Related:

* Plugin system: [Plugins](/plugins)
* Plugin manifest + schema: [Plugin manifest](/plugins/manifest)
* Security hardening: [Security](/gateway/security)

## Commands

```bash theme={null}
crocbot plugins list
crocbot plugins info <id>
crocbot plugins enable <id>
crocbot plugins disable <id>
crocbot plugins doctor
crocbot plugins update <id>
crocbot plugins update --all
```

Bundled plugins ship with crocbot but start disabled. Use `plugins enable` to
activate them.

All plugins must ship a `crocbot.plugin.json` file with an inline JSON Schema
(`configSchema`, even if empty). Missing/invalid manifests or schemas prevent
the plugin from loading and fail config validation.

### Install

```bash theme={null}
crocbot plugins install <path-or-spec>
```

Security note: treat plugin installs like running code. Prefer pinned versions.

Supported archives: `.zip`, `.tgz`, `.tar.gz`, `.tar`.

Use `--link` to avoid copying a local directory (adds to `plugins.load.paths`):

```bash theme={null}
crocbot plugins install -l ./my-plugin
```

### Update

```bash theme={null}
crocbot plugins update <id>
crocbot plugins update --all
crocbot plugins update <id> --dry-run
```

Updates only apply to plugins installed from npm (tracked in `plugins.installs`).