Ideas CLI reference

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.

#ideas list

Read the Ideas the agent wrote for this account: sections, tiles, and the current ask.

#Run ideas list

atoi ideas list --workspace wsp_7m4c --json

{
  "tool": "atoi_ideas",
  "arguments": { "action": "list", "workspace_id": "wsp_7m4c" }
}

Ideas are written for the account. A read inside a Workspace answers that Workspace's own projects, threads and Automations, plus the tiles that name no object at all; Personal answers Personal. Every answer carries its scope, and the terminal prints it first, as In Launch or In Personal (add --workspace <id> for another Workspace).

Without --workspace, the CLI reads its saved Workspace, or Personal if none is saved

Use --personal to read Personal for one call

atoi ideas list --personal --json

For MCP, omitting workspace_id reads Personal regardless of the CLI's saved Workspace

#ideas refresh

Ask the agent to write Ideas now. The same rate limit as the dialog's Refresh applies.

#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.

#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 idea so it stops appearing in Ideas.

#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.