Ideas CLI reference
Read, refresh, and answer the Ideas the agent writes.
Use this page to inspect every public atoi ideas command, its accepted flags, and one runnable example. Ideas are the tiles the agent writes for you in the Ideas dialog; the same sections, tiles, and current ask read here as JSON, and the same answer and dismiss verbs act on them.
atoi ideasRead, refresh, and answer the Ideas the agent writes.
| Command | What it does |
|---|---|
atoi ideas list | Read the Ideas the agent wrote for this account: sections, tiles, and the current ask. |
atoi ideas refresh | Ask the agent to write Ideas now (rate limited like the dialog). |
atoi ideas answer | Answer the current Ideas ask with one of its options. |
atoi ideas dismiss | Dismiss a connection suggestion (github, slack, linear, google-workspace). |
#ideas list
Read the Ideas the agent wrote for this account: sections, tiles, and the current ask.
atoi ideas list
| Flag | Type | Default | Values | What it does |
|---|---|---|---|---|
--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 ideas list
atoi ideas list --json{
"tool": "atoi_ideas",
"arguments": { "action": "list" }
}#ideas refresh
Ask the agent to write Ideas now. The same rate limit as the dialog's Refresh applies.
atoi ideas refresh
| Flag | Type | Default | Values | What it does |
|---|---|---|---|---|
--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 ideas refresh
atoi ideas refresh --json{
"tool": "atoi_ideas",
"arguments": { "action": "refresh" }
}#ideas answer
Answer the current Ideas ask with one of its options. The delivery id and the option ids come from ideas list.
atoi ideas answer <delivery-id> [--delivery <delivery-id>] --pick <option-id>
| Flag | Type | Default | Values | What it does |
|---|---|---|---|---|
--delivery | string | Select the ask by delivery id instead of a positional id. | ||
--pick | string | The option id to choose. | ||
--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 ideas answer
atoi ideas answer gal_9x2 --pick keep --json{
"tool": "atoi_ideas",
"arguments": { "action": "answer", "delivery_id": "gal_9x2", "option_id": "keep" }
}#ideas dismiss
Dismiss a connection suggestion so it stops appearing in Ideas.
atoi ideas dismiss <connection-id> [--connection <connection-id>]
| Flag | Type | Default | Values | What it does |
|---|---|---|---|---|
--connection | string | Select the connection 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 ideas dismiss
atoi ideas dismiss slack --json{
"tool": "atoi_ideas",
"arguments": { "action": "dismiss", "connection_id": "slack" }
}Read Atoi 101 for what Ideas are in the app, or the CLI reference index for every command.
Was this useful?