Skip to content

Automations ​

An automation runs a prompt on its own: on a schedule, or when a trigger the host supports fires. Each run is a session, and the host keeps the history.

Screen ​

The palette (ctrl+p) has Show automations. In the list:

Key
nNew automation
eEdit
rRun now
oTurn on or off
dDelete
right / leftShow or hide details

Commands ​

CommandFlags
automation listEvery automation--json
automation show <uri>One of them--json
automation triggersThe triggers this host supports--json
automation runs <uri>Its run history, every page--json
automation run <uri>Run it now
automation enable <uri>Turn it on
automation disable <uri>Turn it off
automation rm <uri>Delete it

MCP tools ​

list_automations is always served:

ToolWhat it doesArguments
list_automations
core, read only
What the host runs on a schedule, whether each is on, and when it next fires.

Running and changing an automation needs --mcp-tools automations:

ToolWhat it doesArguments
run_automation
automations
Fire an automation now, without waiting for its schedule. Answers once the host has taken it, not once it has finished.
automationstring, required
An automation URI from list_automations.
set_automation_enabled
automations
Stop an automation firing, or start it again. The definition stays either way.
automationstring, required
enabledboolean, required
remove_automation
automations
Delete an automation from the host. Use set_automation_enabled to stop one without losing it.
automationstring, required

Host support ​

Automations are AHP's automation channel. automation triggers shows what this host can trigger on.