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

# tai plugins

> Browse and install marketplace plugins.

Browse and install marketplace plugins.

```console theme={null}
$ tai plugins [OPTIONS] COMMAND [ARGS]...
```

## `tai plugins advisories`

Show the cached advisory snapshot for the installed plugins.

Example: `tai plugins advisories`

```console theme={null}
$ tai plugins advisories [OPTIONS]
```

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai plugins categories`

List the marketplace's controlled category vocabulary.

Example: `tai plugins categories`

```console theme={null}
$ tai plugins categories [OPTIONS]
```

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai plugins info`

Show one listing's detail and its published versions.

Example: `tai plugins info tai42/toolbox`

```console theme={null}
$ tai plugins info [OPTIONS] REF
```

| Argument | Description                               |
| -------- | ----------------------------------------- |
| `REF`    | Plugin ref 'namespace/name'. *(required)* |

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai plugins install`

Install a marketplace plugin by ref, optionally pinning a version.

Example: `tai plugins install tai42/toolbox`

```console theme={null}
$ tai plugins install [OPTIONS] REF
```

| Argument | Description                               |
| -------- | ----------------------------------------- |
| `REF`    | Plugin ref 'namespace/name'. *(required)* |

| Option                 | Description                              |
| ---------------------- | ---------------------------------------- |
| `--version` `TEXT`     | Pin a specific version; omit for latest. |
| `--json` / `--no-json` | Emit raw JSON instead of human tables.   |

## `tai plugins installed`

List the installed marketplace plugins and their update availability.

Example: `tai plugins installed`

```console theme={null}
$ tai plugins installed [OPTIONS]
```

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai plugins search`

Search the marketplace registry, optionally filtered by facets.

Example: `tai plugins search uuid --kind tool`

```console theme={null}
$ tai plugins search [OPTIONS] [QUERY]
```

| Argument  | Description                                              |
| --------- | -------------------------------------------------------- |
| `[QUERY]` | Free-text search query; omit to browse all. *(optional)* |

| Option                  | Description                                 |
| ----------------------- | ------------------------------------------- |
| `--kind` `TEXT`         | Filter by provides kind (tool, agent, ...). |
| `--category` `TEXT`     | Filter by category.                         |
| `--tag` `TEXT`          | Filter by tag (repeatable).                 |
| `--namespace` `TEXT`    | Filter by publisher namespace.              |
| `--tier` `TEXT`         | Filter by trust tier.                       |
| `--contract` `TEXT`     | Filter by compatible contract version.      |
| `--sort` `TEXT`         | Sort order (downloads, updated, name).      |
| `--page` `INTEGER`      | Result page (1-based).                      |
| `--page-size` `INTEGER` | Results per page.                           |
| `--json` / `--no-json`  | Emit raw JSON instead of human tables.      |

## `tai plugins uninstall`

Uninstall a marketplace-installed plugin by ref.

Example: `tai plugins uninstall tai42/toolbox`

```console theme={null}
$ tai plugins uninstall [OPTIONS] REF
```

| Argument | Description                               |
| -------- | ----------------------------------------- |
| `REF`    | Plugin ref 'namespace/name'. *(required)* |

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai plugins update`

Update an installed plugin to a newer (or named) version.

Example: `tai plugins update tai42/toolbox`

```console theme={null}
$ tai plugins update [OPTIONS] REF
```

| Argument | Description                               |
| -------- | ----------------------------------------- |
| `REF`    | Plugin ref 'namespace/name'. *(required)* |

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--version` `TEXT`     | Target version; omit for latest.       |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |