The Archive · CLI reference · Commands

talos automation

Tasks that run by themselves: add, schedule daily, run now, history, and the Windows runner.

Reference for TALOS CLI 0.3.3 generated from the npm package · released Sep 30, 2026

TALOS CLI 0.5.2 is out; this page still describes 0.3.3 and updates with the next build.

An automation runs a task of the board at an interval (with a daily limit) or at a daily time. It runs while talos automation serve is running, or through the Windows runner. <id> is the automation id talos automation list shows.

Operation	What it does
`list`default	Lists the automations with their schedule and state.
`add`	Creates an automation for a task, run every few minutes with a daily limit.
`schedule`	Runs the automation every day at a time, with a policy for runs that were missed.
`dry-run`	Says what the automation would do next, without running it.
`history`	Prints the runs of an automation, with their outcome.
`run`	Runs the automation now and prints the id of the session started.
`enable`	Enables an automation.
`disable`	Disables an automation.
`delete`	Deletes an automation with its schedule and history.
`serve`	Runs the automations that are due, checking every 30 seconds until you press Ctrl+C.
`install-runner`	Installs the Windows runner, which runs your automations in the background.
`uninstall-runner`	Removes the Windows runner.
`health`	Says whether the Windows runner is installed and working.

Without an operation, talos automation runs list.

`list`

Lists the automations with their schedule and state.

talos automation list

`add`

Creates an automation for a task, run every few minutes with a daily limit.

talos automation add <task-id> [--interval <minutes>] [--limit <runs>] [--name <text>]

Arguments

task-id: The task to run (see `talos tasks`).

Options

--interval <value> default 5: Minutes between runs, at least 5. Default 5.
--limit <value> default 3: Runs per day, at least 1. Default 3.
--name <value>: A name for the automation.

`schedule`

Runs the automation every day at a time, with a policy for runs that were missed.

talos automation schedule <id> --at <HH:MM> --timezone <tz> --missed skip|latest [--grace-minutes <n>] [--catchup-minutes <n>] [--backoff-base-seconds <n>] [--backoff-max-seconds <n>]

Arguments

id: The id talos automation list shows.

Options

--at <value> required: Time of day, 24-hour HH:MM (required).
--timezone <value> required: IANA time zone, e.g. Europe/Rome (required).
--missed <value> required: skip missed runs, or run the latest one (required). Valuesskiplatest
--grace-minutes <value> default 5: How late a run may still start. Default 5.
--catchup-minutes <value>: How far back a missed run is caught up. Default 180 with latest, 0 with skip.
--backoff-base-seconds <value> default 30: First wait after a failure. Default 30.
--backoff-max-seconds <value> default 900: Longest wait after repeated failures, not less than the base. Default 900.

Exit codes and errors2

Code	Exit	Meaning
`AUTOMATION_MISSED_POLICY_INVALID`	`2`	The command or the configuration is not valid. Check the command, its options and the configuration.
`AUTOMATION_BACKOFF_INVALID`	`2`	The command or the configuration is not valid. Check the command, its options and the configuration.

`dry-run`

Says what the automation would do next, without running it.

talos automation dry-run <id>

Arguments

id: The id talos automation list shows.

`history`

Prints the runs of an automation, with their outcome.

talos automation history <id>

Arguments

id: The id talos automation list shows.

`run`

Runs the automation now and prints the id of the session started.

talos automation run <id>

Arguments

id: The id talos automation list shows.

It uses the model given with the global --model option, otherwise openai:gpt-5-mini.

Exit codes and errors2

Code	Exit	Meaning
`AUTOMATION_NOT_FOUND`	`15`	The session could not be used. Pick a session from the list.
`AUTOMATION_SESSION_ID_MISSING`	`15`	The session could not be used. Pick a session from the list.

`enable`

Enables an automation.

talos automation enable <id>

Arguments

id: The id talos automation list shows.

`disable`

Disables an automation.

talos automation disable <id>

Arguments

id: The id talos automation list shows.

`delete`

Deletes an automation with its schedule and history.

talos automation delete <id>

Arguments

id: The id talos automation list shows.

`serve`

Runs the automations that are due, checking every 30 seconds until you press Ctrl+C.

talos automation serve [--once]

Options

--once: Check once and exit.

`install-runner`

Installs the Windows runner, which runs your automations in the background.

talos automation install-runner --yes

Options

--yes: Confirms the installation (required).

Windows only.

Exit codes and errors2

Code	Exit	Meaning
`AUTOMATION_CONFIRM_REQUIRED`	`2`	The command or the configuration is not valid. Check the command, its options and the configuration.
`WINDOWS_REQUIRED`	`2`	The command or the configuration is not valid. Check the command, its options and the configuration.

`uninstall-runner`

Removes the Windows runner.

talos automation uninstall-runner --yes

Options

--yes: Confirms the removal (required).

Windows only.

Exit codes and errors2

Code	Exit	Meaning
`AUTOMATION_CONFIRM_REQUIRED`	`2`	The command or the configuration is not valid. Check the command, its options and the configuration.
`WINDOWS_REQUIRED`	`2`	The command or the configuration is not valid. Check the command, its options and the configuration.

`health`

Says whether the Windows runner is installed and working.

talos automation health