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

# ankra agents

> Inspect and control AI agent runs

## ankra agents

Inspect and control the organisation's AI agent runs.

Every time an AI agent is dispatched (a board ticket, a schedule, an
alert, or run-now) the platform records a run with a linked session.
These commands list those runs, show one in full, read its transcript,
and cancel a live run — the platform interrupts the in-flight turn
within seconds.

## ankra agents cancel

Cancel a live AI agent run. The run and its session flip to
'cancelled' and the platform interrupts the in-flight turn within
seconds, without pausing the agent itself. Organisation admins only.

```bash theme={null}
ankra agents cancel <run_id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |
| `-y`, `--yes`    | `false` | Skip the confirmation prompt                          |

## ankra agents run

Show one AI agent run in full

```bash theme={null}
ankra agents run <run_id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra agents runs

List the organisation's AI agent runs, newest first

```bash theme={null}
ankra agents runs [flags]
```

**Flags**

| Flag             | Default | Description                                                                                                         |
| ---------------- | ------- | ------------------------------------------------------------------------------------------------------------------- |
| `--limit`        | `20`    | Maximum runs to return (max 100)                                                                                    |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable)                                                               |
| `--status`       | `[]`    | Filter by run status (pending, running, awaiting\_user, completed, failed, cancelled, expired, skipped); repeatable |
| `--task`         |         | Filter to one agent task id (UUID)                                                                                  |

## ankra agents transcript

Read an AI agent run's session transcript

```bash theme={null}
ankra agents transcript <run_id> [flags]
```

**Flags**

| Flag             | Default | Description                                            |
| ---------------- | ------- | ------------------------------------------------------ |
| `--limit`        | `200`   | Maximum events to return (max 1000)                    |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable)  |
| `--since`        | `0`     | Return events with a sequence number greater than this |