Automations

Turn automations on and off, trigger them, reload them, and read and change their configs.

automation has turn-on (on), turn-off (off) and toggle (t):

ha-bridge automation turn-on hallway_motion
ha-bridge automation turn-off hallway_motion
ha-bridge automation toggle hallway_motion

turn-off stops any running actions. --no-stop-actions lets them finish:

ha-bridge automation turn-off hallway_motion --no-stop-actions

Triggering

trigger runs an automation’s actions now. It skips the conditions unless you pass --no-skip-condition:

ha-bridge automation trigger hallway_motion
ha-bridge automation trigger hallway_motion --no-skip-condition

automation reload reloads automations from YAML.

Reading and changing configs

automation config reads and writes automations as Home Assistant’s automation editor does. It needs a token that belongs to an admin.

config get prints the config an automation was loaded from as YAML, with its triggers, offsets, conditions and actions. This is where to look when you need to know why an automation ran when it did:

ha-bridge automation config get office_curtains_sunrise

id: "1700000000000"
alias: Office curtains at sunrise
triggers:
  - trigger: sun
    event: sunrise
    offset: 00:30:00
conditions: []
actions:
  - action: cover.set_cover_position
    target:
      entity_id: cover.office_curtains
    data:
      position: 90
mode: single

--json prints { "domain", "entity_id", "id", "editable", "config" }. editable says whether the automation is in automations.yaml. Automations defined in configuration.yaml or a package can be read but not changed.

create, update and delete change automations.yaml. create and update read the config from a YAML or JSON file with --file (-f), or from stdin with -f -. Home Assistant validates it first and refuses a config with mistakes, saying why. update replaces all of the automation’s config, so start from config get:

ha-bridge automation config get office_curtains_sunrise > curtains.yaml
# edit curtains.yaml
ha-bridge automation config update office_curtains_sunrise -f curtains.yaml
ha-bridge automation config create -f new-automation.yaml
ha-bridge automation config delete office_curtains_sunrise

create prints the new automation’s ID, and makes one up unless you pass --id. Home Assistant reloads the automation after saving, so its entity appears shortly after.

validate checks a config without saving it. It runs Home Assistant’s own checks on the triggers, conditions and actions, then lists any entity, action, device, area, floor or label the config names that Home Assistant doesn’t have, much as Spook would after saving. It doesn’t read templates. It prints each problem and exits 1, or prints valid. --json prints { "valid", "errors", "unknown" }:

ha-bridge automation config validate -f new-automation.yaml
ha-bridge automation config get office_curtains_sunrise | ha-bridge automation config validate -f -

actions: offset not-a-duration should be format 'HH:MM', 'HH:MM:SS' or 'HH:MM:SS.F' at '[2].delay'
unknown action: light.turn_onn
unknown entity: light.office_lamp_old
ha-bridge: the automation has problems

See ha-bridge automation for every argument and flag.