Thread CLI reference

List, inspect, message, retry, stop, pin, and unpin governed chat Threads.

On this page

Use this page to inspect every public atoi thread command, its accepted flags, and one runnable example. Return to the CLI reference index to choose another command group.

atoi threadList, inspect, message, retry, stop, pin, and unpin governed chat Threads.

Command	What it does
`atoi thread list`	List governed Threads, optionally within one Project.
`atoi thread get`	Read one Thread and a bounded message page.
`atoi thread send`	Send a message and wait for its receipt-backed result.
`atoi thread retry`	Retry the last failed or stopped reply in a Thread.
`atoi thread stop`	Stop the active reply in a Thread.
`atoi thread pin`	Pin a Thread and read back the app-visible state.
`atoi thread unpin`	Unpin a Thread and read back the app-visible state.

#`thread list`

List governed Threads, optionally within one Project.

atoi thread list [--project <project-id>] [--limit <n>]

Flag	Type	Default	Values	What it does
`--project`	`string`			Select a Project by id.
`--limit`	`number`			Return between 1 and 200 Threads.
`--json`	`boolean`	`false`		Emit the canonical JSON envelope.
`--ndjson`	`boolean`	`false`		Emit one canonical JSON envelope per line.
`--format`	`string`	`text`	`text`, `json`	Choose human text or the JSON envelope.
`--help` `-h`	`boolean`			Show command help.

#Run `thread list`

atoi thread list --project prj_8k2v --json

{
  "tool": "atoi_threads",
  "arguments": {
    "action": "list",
    "project_id": "prj_8k2v",
    "limit": 10
  }
}

#`thread get`

Read one Thread and a bounded message page.

atoi thread get <thread-id> [--thread <thread-id>] [--limit <n>]

Flag	Type	Default	Values	What it does
`--thread`	`string`			Select a Thread by id instead of a positional id.
`--limit`	`number`			Return between 1 and 200 messages.
`--json`	`boolean`	`false`		Emit the canonical JSON envelope.
`--ndjson`	`boolean`	`false`		Emit one canonical JSON envelope per line.
`--format`	`string`	`text`	`text`, `json`	Choose human text or the JSON envelope.
`--help` `-h`	`boolean`			Show command help.

#Run `thread get`

atoi thread get thr_9c4k --json

{
  "tool": "atoi_threads",
  "arguments": {
    "action": "get",
    "thread_id": "thr_9c4k"
  }
}

#`thread send`

Send a message and wait for its receipt-backed result.

atoi thread send <thread-id> --prompt <text> [--thread <thread-id>] [--model <model-id>] [--reasoning <strength>] [--context-ref <json> ...] [--context-refs <json-array>] [--delivery-id <key>] [--idempotency-key <key>]

Flag	Type	Default	Values	What it does
`--thread`	`string`			Select a Thread by id instead of a positional id.
`--prompt` required	`string`			Set the message text.
`--model`	`string`			Select a model id.
`--reasoning`	`string`		`default`, `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, `max`	Select the model reasoning strength.
`--context-ref`	`json`			Attach one context reference as JSON. Repeat the flag for more.
`--context-refs`	`json`			Attach an array of context references as JSON.
`--delivery-id`	`string`			Set the exact delivery identity.
`--idempotency-key`	`string`			Reuse a mutation identity when you safely retry the same action.
`--json`	`boolean`	`false`		Emit the canonical JSON envelope.
`--ndjson`	`boolean`	`false`		Emit one canonical JSON envelope per line.
`--format`	`string`	`text`	`text`, `json`	Choose human text or the JSON envelope.
`--help` `-h`	`boolean`			Show command help.

#Run `thread send`

atoi thread send thr_9c4k --prompt "Summarize the release blockers." --delivery-id msg_release_1 --json

{
  "tool": "atoi_threads",
  "arguments": {
    "action": "send",
    "thread_id": "thr_9c4k",
    "prompt": "Summarize the release blockers.",
    "delivery_id": "msg_release_1"
  }
}

#`thread retry`

Retry the last failed or stopped reply in a Thread.

atoi thread retry <thread-id> [--thread <thread-id>] [--model <model-id>] [--reasoning <strength>]

Flag	Type	Default	Values	What it does
`--thread`	`string`			Select a Thread by id instead of a positional id.
`--model`	`string`			Select a model id.
`--reasoning`	`string`		`default`, `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, `max`	Select the model reasoning strength.
`--json`	`boolean`	`false`		Emit the canonical JSON envelope.
`--ndjson`	`boolean`	`false`		Emit one canonical JSON envelope per line.
`--format`	`string`	`text`	`text`, `json`	Choose human text or the JSON envelope.
`--help` `-h`	`boolean`			Show command help.

#Run `thread retry`

atoi thread retry thr_9c4k --reasoning high --json

{
  "tool": "atoi_threads",
  "arguments": {
    "action": "retry",
    "thread_id": "thr_9c4k",
    "delivery_id": "msg_release_2"
  }
}

#`thread stop`

Stop the active reply in a Thread.

atoi thread stop <thread-id> [--thread <thread-id>]

Flag	Type	Default	Values	What it does
`--thread`	`string`			Select a Thread by id instead of a positional id.
`--json`	`boolean`	`false`		Emit the canonical JSON envelope.
`--ndjson`	`boolean`	`false`		Emit one canonical JSON envelope per line.
`--format`	`string`	`text`	`text`, `json`	Choose human text or the JSON envelope.
`--help` `-h`	`boolean`			Show command help.

#Run `thread stop`

atoi thread stop thr_9c4k --json

{
  "tool": "atoi_threads",
  "arguments": {
    "action": "stop",
    "thread_id": "thr_9c4k"
  }
}

#`thread pin`

Pin a Thread and read back the app-visible state.

atoi thread pin <thread-id> [--thread <thread-id>] [--idempotency-key <key>]

Flag	Type	Default	Values	What it does
`--thread`	`string`			Select a Thread by id instead of a positional id.
`--idempotency-key`	`string`			Reuse a mutation identity when you safely retry the same action.
`--json`	`boolean`	`false`		Emit the canonical JSON envelope.
`--ndjson`	`boolean`	`false`		Emit one canonical JSON envelope per line.
`--format`	`string`	`text`	`text`, `json`	Choose human text or the JSON envelope.
`--help` `-h`	`boolean`			Show command help.

#Run `thread pin`

atoi thread pin thr_9c4k --json

{
  "tool": "atoi_threads",
  "arguments": {
    "action": "pin",
    "thread_id": "thr_9c4k",
    "idempotency_key": "thread_pin_1"
  }
}

#`thread unpin`

Unpin a Thread and read back the app-visible state.

atoi thread unpin <thread-id> [--thread <thread-id>] [--idempotency-key <key>]

Flag	Type	Default	Values	What it does
`--thread`	`string`			Select a Thread by id instead of a positional id.
`--idempotency-key`	`string`			Reuse a mutation identity when you safely retry the same action.
`--json`	`boolean`	`false`		Emit the canonical JSON envelope.
`--ndjson`	`boolean`	`false`		Emit one canonical JSON envelope per line.
`--format`	`string`	`text`	`text`, `json`	Choose human text or the JSON envelope.
`--help` `-h`	`boolean`			Show command help.

#Run `thread unpin`

atoi thread unpin thr_9c4k --json

{
  "tool": "atoi_threads",
  "arguments": {
    "action": "unpin",
    "thread_id": "thr_9c4k",
    "idempotency_key": "thread_unpin_1"
  }
}

Was this useful?

#thread list

#Run thread list

#thread get

#Run thread get

#thread send

#Run thread send

#thread retry

#Run thread retry

#thread stop

#Run thread stop

#thread pin

#Run thread pin

#thread unpin

#Run thread unpin