Skip to content

simstim host alerts set

Choose where a host sends alerts, and which ones

Synopsis

Writes the host’s alerts file (mode 0600). A destination flag replaces the file’s destinations, unless you add –add. With no destination flag, only the settings you give change. –token-cmd runs a command here, such as a keychain read, and sends what it prints as the ntfy token.

simstim host alerts set <host> [flags]

Examples 

  simstim host alerts set my-vps --ntfy https://ntfy.sh/<your-topic>
  simstim host alerts set my-vps --ntfy https://ntfy.example.com/agents --token-cmd 'security find-generic-password -s ntfy -w'
  simstim host alerts set my-vps --add --webhook https://hooks.slack.com/services/… --format slack --events failed,oom
  simstim host alerts set my-vps --add --command 'notify-send "$SIMSTIM_SUMMARY"'
  simstim host alerts set my-vps --delay 30s --min-turn 5m

Options 

      --add                 keep the host's destinations, and add this one
      --command string      run this command line on the host, with the event on stdin and in the environment
      --delay duration      how long needs_input waits before it is sent (default 10s)
      --detail              add the agent's question to needs_input (it can hold code)
      --events strings      the events to send: needs_input, turn_done, exited, failed, oom, started, restored
      --format string       the webhook's body: json (the event), slack or discord
  -h, --help                help for set
      --min-turn duration   the shortest turn that sends turn_done (default 1m)
      --ntfy string         send to this ntfy topic (https://ntfy.sh/<topic> or your own server)
      --token-cmd string    run this here and use its output as the ntfy token (it is never printed)
      --webhook string      POST to this web address

SEE ALSO

  • simstim host alerts - Show where a host sends alerts about its sessions, and the last deliveries