Inbox CLI reference

List and resolve durable approvals and decisions.

Use this page to inspect every public atoi inbox command, its accepted flags, and one runnable example.

atoi inboxList and resolve durable approvals and decisions.

Command	What it does
`atoi inbox list`	List decisions that need attention, in the Workspace the terminal is standing in.
`atoi inbox keep`	Keep the fact a memory card proposes. The card resolves.
`atoi inbox edit`	Change the words a memory card proposes. The card waits for keep or dismiss.
`atoi inbox dismiss`	Dismiss the fact a memory card proposes. The card resolves.
`atoi inbox approve`	Approve one exact Inbox request. On a memory card it keeps the fact.
`atoi inbox deny`	Deny one exact Inbox request. On a memory card it dismisses the fact.
`atoi inbox snooze`	Hide an Inbox item until a future time.

#`inbox list`

List decisions that need attention.

atoi inbox list [--workspace <id>] [--personal] [--status <status>] [--limit <n>]

Flag	Type	Default	Values	What it does
`--workspace`	`string`			Answer one Workspace by id for this call; without it, the Workspace the terminal is standing in.
`--personal`	`boolean`			Answer Personal for this call, whatever the terminal is standing in.
`--status`	`string`			Filter by Inbox status.
`--limit`	`number`			Limit the number of returned records.
`--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 `inbox list`

atoi inbox list --status unread --json

{
  "tool": "atoi_inbox",
  "arguments": {
    "action": "list",
    "status": "unread",
    "limit": 10
  }
}

#`inbox approve`

Approve one exact Inbox request.

atoi inbox approve <item-id> [--item <item-id>] [--request <request-id>] --confirm

Flag	Type	Default	Values	What it does
`--item`	`string`			Select an Inbox item by id instead of a positional id.
`--request`	`string`			Bind the decision to an exact approval request id.
`--confirm` required	`boolean`			Confirm the exact consequential action after you inspect its target.
`--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 `inbox approve`

atoi inbox approve inb_4d6p --request req_2n8s --confirm --json

{
  "tool": "atoi_inbox",
  "arguments": {
    "action": "approve",
    "item_id": "inb_3r7d",
    "request_id": "req_6p2n",
    "confirmation": true
  }
}

#`inbox deny`

Deny one exact Inbox request.

atoi inbox deny <item-id> [--item <item-id>] [--request <request-id>] --confirm

Flag	Type	Default	Values	What it does
`--item`	`string`			Select an Inbox item by id instead of a positional id.
`--request`	`string`			Bind the decision to an exact approval request id.
`--confirm` required	`boolean`			Confirm the exact consequential action after you inspect its target.
`--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 `inbox deny`

atoi inbox deny inb_4d6p --request req_2n8s --confirm --json

{
  "tool": "atoi_inbox",
  "arguments": {
    "action": "deny",
    "item_id": "inb_3r7d",
    "request_id": "req_6p2n",
    "confirmation": true
  }
}

#`inbox snooze`

Hide an Inbox item until a future time.

atoi inbox snooze <item-id> [--item <item-id>] [--until <timestamp-ms> | --hours <hours>]

Flag	Type	Default	Values	What it does
`--item`	`string`			Select an Inbox item by id instead of a positional id.
`--until`	`number`			Set the future Unix timestamp in milliseconds.
`--hours`	`number`	`3`		Snooze for this many hours.
`--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 `inbox snooze`

atoi inbox snooze inb_4d6p --hours 4 --json

{
  "tool": "atoi_inbox",
  "arguments": {
    "action": "snooze",
    "item_id": "inb_3r7d",
    "request_id": "req_6p2n",
    "snoozed_until": 1798718400000
  }
}

#`inbox keep`

Keep the fact a memory card proposes. The card resolves.

atoi inbox keep <item-id> [--item <item-id>]

Flag	Type	Default	Values	What it does
`--item`	`string`			Select an Inbox item 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 `inbox keep`

atoi inbox keep inb_7r2k --json

{
  "tool": "atoi_inbox",
  "arguments": {
    "action": "keep",
    "item_id": "inb_7r2k"
  }
}

#`inbox edit`

Change the words a memory card proposes. The card waits for keep or dismiss.

atoi inbox edit <item-id> [--item <item-id>] --text <words>

Flag	Type	Default	Values	What it does
`--item`	`string`			Select an Inbox item by id instead of a positional id.
`--text` required	`string`			The new words for the memory.
`--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 `inbox edit`

atoi inbox edit inb_7r2k --text "Wren opens the truck at 11 on weekdays" --json

{
  "tool": "atoi_inbox",
  "arguments": {
    "action": "edit",
    "item_id": "inb_7r2k",
    "text": "Wren opens the truck at 11 on weekdays"
  }
}

#`inbox dismiss`

Dismiss the fact a memory card proposes. The card resolves.

atoi inbox dismiss <item-id> [--item <item-id>]

Flag	Type	Default	Values	What it does
`--item`	`string`			Select an Inbox item 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 `inbox dismiss`

atoi inbox dismiss inb_7r2k --json

{
  "tool": "atoi_inbox",
  "arguments": {
    "action": "dismiss",
    "item_id": "inb_7r2k"
  }
}

Read Run work from the terminal for the rest of this group, or the CLI reference index for every command.

Was this useful?

#inbox list

#Run inbox list

#inbox approve

#Run inbox approve

#inbox deny

#Run inbox deny

#inbox snooze

#Run inbox snooze

#inbox keep

#Run inbox keep

#inbox edit

#Run inbox edit

#inbox dismiss

#Run inbox dismiss