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

# sazabi agent-dispatches

> Command reference for sazabi agent-dispatches.

`sazabi agent-dispatches` — Follow and steer coding agent attempts. Subcommands: `list`, `get`, `reply`, `cancel`.

## `sazabi agent-dispatches`

Follow and steer coding agent attempts

An attempt (a dispatch) starts from `sazabi issues fix <issue-id> --agent <agent>`, which hands the issue's fix to a connected coding agent in the issue thread: cursor (Cursor), devin (Devin), capy (Capy), replicas (Replicas), hoplite (Hoplite), warp (Warp Oz), claude (Claude Agent), codex (Codex), tembo (Tembo). These commands read the attempt that queued, answer the agent's question, and stop it.

Needs a signed-in person (`sazabi auth sign-in`): an attempt records who asked, so an organization secret key is refused with that reason, not as invalid.

```txt theme={"system"}
sazabi agent-dispatches <subcommand>
```

### `sazabi agent-dispatches list`

List existing coding agent attempts

```txt theme={"system"}
sazabi agent-dispatches list [options]
```

| Flag | Type | Required | Description |
| - | - | - | - |
| `--token` | string | No | Override token (prefer SAZABI\_TOKEN; arguments are visible to other local users) |
| `--api-base-url` | string | No | Override API base URL |
| `--json` | boolean | No | Output as JSON |
| `--organization-id` | string | No | Override active organization ID |
| `--project-id` | string | No | Override active project ID |
| `--issue-id` | string | No | Filter by issue ID |
| `--connection-id` | string | No | Filter by connection ID |
| `--status` | string | No | Filter by dispatch status |
| `--limit` | string | No | Maximum attempts, from 1 to 100 |

### `sazabi agent-dispatches get`

Read an attempt and its linked pull requests

```txt theme={"system"}
sazabi agent-dispatches get <dispatch-id> [options]
```

| Flag | Type | Required | Description |
| - | - | - | - |
| `--token` | string | No | Override token (prefer SAZABI\_TOKEN; arguments are visible to other local users) |
| `--api-base-url` | string | No | Override API base URL |
| `--json` | boolean | No | Output as JSON |
| `--organization-id` | string | No | Override active organization ID |
| `--project-id` | string | No | Override active project ID |

### `sazabi agent-dispatches reply`

Send an explicit follow-up to the coding agent

```txt theme={"system"}
sazabi agent-dispatches reply <dispatch-id> [options]
```

| Flag | Type | Required | Description |
| - | - | - | - |
| `--token` | string | No | Override token (prefer SAZABI\_TOKEN; arguments are visible to other local users) |
| `--api-base-url` | string | No | Override API base URL |
| `--json` | boolean | No | Output as JSON |
| `--organization-id` | string | No | Override active organization ID |
| `--project-id` | string | No | Override active project ID |
| `--client-request-id` | string | No | Stable request ID, generated when omitted; pass the same one only when retrying the same reply |
| `--text` | string | No | The reply to the coding agent, inline |
| `--text-file` | string | No | UTF-8 file holding the reply, for a long or multi-line one; exactly one of --text and --text-file |

```bash theme={"system"}
sazabi agent-dispatches reply <dispatch-id> --text "Use the retry helper in lib/http.ts"
sazabi agent-dispatches reply <dispatch-id> --text-file answer.md
```

### `sazabi agent-dispatches cancel`

Request cancellation of an existing attempt

```txt theme={"system"}
sazabi agent-dispatches cancel <dispatch-id> [options]
```

| Flag | Type | Required | Description |
| - | - | - | - |
| `--token` | string | No | Override token (prefer SAZABI\_TOKEN; arguments are visible to other local users) |
| `--api-base-url` | string | No | Override API base URL |
| `--json` | boolean | No | Output as JSON |
| `--organization-id` | string | No | Override active organization ID |
| `--project-id` | string | No | Override active project ID |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.