> ## 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 storage

> Inspect and manage the storage provider's resources.

Inspect and manage the storage provider's resources.

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

## `tai storage delete`

Delete a storage resource.

Example: `tai storage delete notes/todo.txt`

```console theme={null}
$ tai storage delete [OPTIONS] RESOURCE_ID
```

| Argument      | Description               |
| ------------- | ------------------------- |
| `RESOURCE_ID` | Resource id. *(required)* |

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

## `tai storage delete-dir`

Delete a storage directory subtree.

Example: `tai storage delete-dir notes`

```console theme={null}
$ tai storage delete-dir [OPTIONS] DIR_PATH
```

| Argument   | Description                  |
| ---------- | ---------------------------- |
| `DIR_PATH` | Directory path. *(required)* |

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

## `tai storage download`

Download a resource's raw content to stdout.

Example: `tai storage download notes/todo.txt`

```console theme={null}
$ tai storage download [OPTIONS] RESOURCE_ID
```

| Argument      | Description               |
| ------------- | ------------------------- |
| `RESOURCE_ID` | Resource id. *(required)* |

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

## `tai storage info`

Show the registered storage provider's identity (or the empty state).

Example: `tai storage info`

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

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

## `tai storage list`

List the storage resource ids.

Example: `tai storage list`

```console theme={null}
$ tai storage list [OPTIONS]
```

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

## `tai storage stat`

Show a resource's inferred content type.

Example: `tai storage stat images/logo.png`

```console theme={null}
$ tai storage stat [OPTIONS] RESOURCE_ID
```

| Argument      | Description               |
| ------------- | ------------------------- |
| `RESOURCE_ID` | Resource id. *(required)* |

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

## `tai storage upload`

Upload a resource — exactly one of `--text` or `--base64`. An existing id
is overwritten.

Example: `tai storage upload notes/todo.txt --text 'buy milk'`

```console theme={null}
$ tai storage upload [OPTIONS] RESOURCE_ID
```

| Argument      | Description               |
| ------------- | ------------------------- |
| `RESOURCE_ID` | Resource id. *(required)* |

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--text` `TEXT`        | Store this text verbatim.              |
| `--base64` `TEXT`      | Store these base64-encoded bytes.      |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |