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

> List and run agents.

List and run agents.

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

## `tai agents authored-run`

Stream a run of an authored agent (a preset baked over a spec-runnable agent).

Example: `tai agents authored-run my_researcher --input '{"query":"weather"}'`

```console theme={null}
$ tai agents authored-run [OPTIONS] NAME
```

| Argument | Description                                |
| -------- | ------------------------------------------ |
| `NAME`   | Authored-agent (preset) name. *(required)* |

| Option                 | Description                                 |
| ---------------------- | ------------------------------------------- |
| `--input` `TEXT`       | The non-baked agent input as a JSON object. |
| `--json` / `--no-json` | Emit raw JSON instead of human tables.      |

## `tai agents list`

List every registered agent.

Example: `tai agents list`

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

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

## `tai agents run`

Stream a run of an agent, one event frame at a time.

Example: `tai agents run researcher --input '{"query":"weather"}'`

```console theme={null}
$ tai agents run [OPTIONS] NAME
```

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

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--input` `TEXT`       | The agent input as a JSON object.      |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |

## `tai agents spec-runnable`

List the spec-runnable (authorable) agents.

Example: `tai agents spec-runnable`

```console theme={null}
$ tai agents spec-runnable [OPTIONS]
```

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