> ## 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 tool-meta

> Manage the tool-metadata overlay (folders, display names, tags, visibility).

Manage the tool-metadata overlay (folders, display names, tags, visibility).

```console theme={null}
$ tai tool-meta [OPTIONS] COMMAND [ARGS]...
```

## `tai tool-meta delete`

Delete a tool's whole overlay row (idempotent).

Example: `tai tool-meta delete web_search`

```console theme={null}
$ tai tool-meta delete [OPTIONS] TOOL_NAME
```

| Argument    | Description                                      |
| ----------- | ------------------------------------------------ |
| `TOOL_NAME` | The tool whose overlay row to drop. *(required)* |

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

## `tai tool-meta folder-create`

Create a folder (root, or under `--parent`).

Example: `tai tool-meta folder-create Research`

```console theme={null}
$ tai tool-meta folder-create [OPTIONS] NAME
```

| Argument | Description               |
| -------- | ------------------------- |
| `NAME`   | Folder name. *(required)* |

| Option                 | Description                               |
| ---------------------- | ----------------------------------------- |
| `--parent` `TEXT`      | Parent folder id; omit for a root folder. |
| `--json` / `--no-json` | Emit raw JSON instead of human tables.    |

## `tai tool-meta folder-delete`

Delete an empty folder.

Example: `tai tool-meta folder-delete <id>`

```console theme={null}
$ tai tool-meta folder-delete [OPTIONS] FOLDER_ID
```

| Argument    | Description                             |
| ----------- | --------------------------------------- |
| `FOLDER_ID` | Folder id (must be empty). *(required)* |

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

## `tai tool-meta folder-move`

Re-parent a folder (omit `--parent` to move it to the root).

Example: `tai tool-meta folder-move <id> --parent <parent-id>`

```console theme={null}
$ tai tool-meta folder-move [OPTIONS] FOLDER_ID
```

| Argument    | Description             |
| ----------- | ----------------------- |
| `FOLDER_ID` | Folder id. *(required)* |

| Option                 | Description                                     |
| ---------------------- | ----------------------------------------------- |
| `--parent` `TEXT`      | New parent folder id; omit to move to the root. |
| `--json` / `--no-json` | Emit raw JSON instead of human tables.          |

## `tai tool-meta folder-rename`

Rename a folder.

Example: `tai tool-meta folder-rename <id> Archive`

```console theme={null}
$ tai tool-meta folder-rename [OPTIONS] FOLDER_ID NAME
```

| Argument    | Description                   |
| ----------- | ----------------------------- |
| `FOLDER_ID` | Folder id. *(required)*       |
| `NAME`      | New folder name. *(required)* |

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

## `tai tool-meta list`

Show the whole overlay — every folder and every per-tool row.

Example: `tai tool-meta list`

```console theme={null}
$ tai tool-meta list [OPTIONS]
```

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

## `tai tool-meta set`

Merge-patch a tool's overlay. Only the flags you pass are sent; omit a field
to leave it unchanged.

Example: `tai tool-meta set web_search --display-name 'Web Search' --tag research`

```console theme={null}
$ tai tool-meta set [OPTIONS] TOOL_NAME
```

| Argument    | Description                                  |
| ----------- | -------------------------------------------- |
| `TOOL_NAME` | The tool whose overlay to edit. *(required)* |

| Option                  | Description                                                            |
| ----------------------- | ---------------------------------------------------------------------- |
| `--display-name` `TEXT` | Set the display label (non-empty).                                     |
| `--clear-display-name`  | Clear the display label (defer to the tool name). *(default: `False`)* |
| `--folder` `TEXT`       | Place the tool in this folder id.                                      |
| `--clear-folder`        | Remove the tool from its folder. *(default: `False`)*                  |
| `--tag` `TEXT`          | A user tag (repeatable); replaces the whole set when given.            |
| `--clear-tags`          | Clear all user tags (send an empty set). *(default: `False`)*          |
| `--visibility` `TEXT`   | Visibility override: default (defer) \| shown \| hidden.               |
| `--json` / `--no-json`  | Emit raw JSON instead of human tables.                                 |