Automation CLI reference

Create and operate reusable manual or scheduled work.

Use this page to inspect every public atoi automation command, its accepted flags, and one runnable example. In the web app the same Automations live in the panel's Automations tab.

atoi automationCreate and operate reusable manual or scheduled work.

Command	What it does
`atoi automation list`	List Automations in the Workspace the terminal is standing in, optionally for one Project or only active entries.
`atoi automation get`	Read one Automation and what it recently ran.
`atoi automation create`	Create a manual or scheduled Automation.
`atoi automation update`	Change an Automation definition or schedule.
`atoi automation toggle`	Toggle an Automation between active and paused.
`atoi automation trigger`	Run an Automation now.
`atoi automation remove`	Remove one exact Automation.

#`automation list`

List Automations, optionally for one Project or only active entries.

atoi automation list [--workspace <id>] [--personal] [--project <project-id>] [--enabled-only]

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.
`--project`	`string`			Select a Project by id.
`--enabled-only`	`boolean`			Return only enabled Automations.
`--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 `automation list`

atoi automation list --project prj_8k2v --json

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

#`automation get`

Read one Automation and what it recently ran.

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

Flag	Type	Default	Values	What it does
`--automation`	`string`			Select an Automation by id instead of a positional id.
`--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 `automation get`

atoi automation get aut_5k1m --json

{
  "tool": "atoi_automations",
  "arguments": {
    "action": "get",
    "automation_id": "aut_5k1m"
  }
}

#`automation create`

Create a manual or scheduled Automation.

Flag	Type	Default	Values	What it does
`--name` required	`string`			Set the Automation name.
`--prompt` required	`string`			Set the Automation prompt.
`--description`	`string`			Describe the Automation.
`--project`	`string`			Select a Project by id.
`--model`	`string`			Select a model id.
`--thread`	`string`			Deliver each run into one Thread by id.
`--schedule`	`string`	`manual`	`manual`, `daily`, `interval`, `monthly`, `once`	Choose the schedule type. A once schedule runs one time and then the Automation retires.
`--hour`	`number`			Set the hour from 0 through 23 on the local clock of the Automation time zone, never UTC.
`--minute`	`number`			Set the minute from 0 through 59 on that same local clock.
`--date`	`string`			Set the calendar date a once schedule runs on, as YYYY-MM-DD.
`--hour-utc`	`number`			Older name for --hour. The same local clock.
`--minute-utc`	`number`			Older name for --minute. The same local clock.
`--hours`	`number`			Set the interval from 1 through 8760 hours.
`--days`	`string`			Set unique comma-separated weekdays from 0 through 6.
`--day-of-month`	`number`			Set the calendar day from 1 through 31.
`--enabled`	`boolean`			Create the Automation enabled or disabled. Pass --no-enabled for false.
`--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 `automation create`

atoi automation create --project prj_8k2v --name "Release audit" --prompt "Audit main and return evidence." --schedule daily --hour 14 --minute 30 --json

{
  "tool": "atoi_automations",
  "arguments": {
    "action": "create",
    "project_id": "prj_8k2v",
    "name": "Release audit",
    "prompt": "Audit main and return evidence.",
    "schedule": {
      "type": "daily",
      "hour": 14,
      "minute": 30
    }
  }
}

--hour and --minute are the clock of the Automation's time zone, never UTC. --hour-utc and --minute-utc are the older names for the same local clock and still work.

#Run it once

A once schedule names one moment on that clock: it runs one time, then the Automation retires. It stays in the list, off, and every list says ran once on <date>. A moment that has already passed is refused.

atoi automation create --name "Nudge the crew" --prompt "Nudge the crew about the launch checklist." --schedule once --date 2026-09-17 --hour 16 --json

{
  "tool": "atoi_automations",
  "arguments": {
    "action": "create",
    "name": "Nudge the crew",
    "prompt": "Nudge the crew about the launch checklist.",
    "schedule": {
      "type": "once",
      "date": "2026-09-17",
      "hour": 16,
      "minute": 0
    }
  }
}

#`automation update`

Change an Automation definition or schedule.

Flag	Type	Default	Values	What it does
`--automation`	`string`			Select an Automation by id instead of a positional id.
`--name`	`string`			Replace the Automation name.
`--prompt`	`string`			Replace the Automation prompt.
`--description`	`string`			Replace the Automation description.
`--project`	`string`			Select a Project, or pass all or none to clear Project scope.
`--model`	`string`			Select a model id.
`--thread`	`string`			Deliver each run into one Thread by id.
`--schedule`	`string`		`manual`, `daily`, `interval`, `monthly`, `once`	Choose the schedule type. A once schedule runs one time and then the Automation retires.
`--hour`	`number`			Set the hour from 0 through 23 on the local clock of the Automation time zone, never UTC.
`--minute`	`number`			Set the minute from 0 through 59 on that same local clock.
`--date`	`string`			Set the calendar date a once schedule runs on, as YYYY-MM-DD.
`--hour-utc`	`number`			Older name for --hour. The same local clock.
`--minute-utc`	`number`			Older name for --minute. The same local clock.
`--hours`	`number`			Set the interval from 1 through 8760 hours.
`--days`	`string`			Set unique comma-separated weekdays from 0 through 6.
`--day-of-month`	`number`			Set the calendar day from 1 through 31.
`--enabled`	`boolean`			Enable or disable the Automation. Pass --no-enabled for false.
`--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 `automation update`

atoi automation update aut_5k1m --description "Audit the candidate release." --json

{
  "tool": "atoi_automations",
  "arguments": {
    "action": "update",
    "automation_id": "aut_5k1m",
    "description": "Audit the candidate release."
  }
}

#`automation toggle`

Toggle an Automation between active and paused.

atoi automation toggle <automation-id> [--automation <automation-id>]

Flag	Type	Default	Values	What it does
`--automation`	`string`			Select an Automation 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 `automation toggle`

atoi automation toggle aut_5k1m --json

{
  "tool": "atoi_automations",
  "arguments": {
    "action": "toggle",
    "automation_id": "aut_5k1m",
    "enabled": true
  }
}

#`automation trigger`

Run an Automation now.

atoi automation trigger <automation-id> [--automation <automation-id>] [--input <message>] [--idempotency-key <key>]

Flag	Type	Default	Values	What it does
`--automation`	`string`			Select an Automation by id instead of a positional id.
`--input`	`string`			Add an input message for this run.
`--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 `automation trigger`

atoi automation trigger aut_5k1m --input "Check the candidate tag." --json

{
  "tool": "atoi_automations",
  "arguments": {
    "action": "trigger",
    "automation_id": "aut_5k1m",
    "input_message": "Check the candidate tag."
  }
}

#`automation remove`

Remove one exact Automation.

atoi automation remove <automation-id> [--automation <automation-id>] --confirm

Flag	Type	Default	Values	What it does
`--automation`	`string`			Select an Automation by id instead of a positional 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 `automation remove`

atoi automation remove aut_5k1m --confirm --json

{
  "tool": "atoi_automations",
  "arguments": {
    "action": "remove",
    "automation_id": "aut_5k1m",
    "confirmation": true
  }
}

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

Was this useful?

#automation list

#Run automation list

#automation get

#Run automation get

#automation create

#Run automation create

#Run it once

#automation update

#Run automation update

#automation toggle

#Run automation toggle

#automation trigger

#Run automation trigger

#automation remove

#Run automation remove