Reference
Go Automate is a command-line tool built on urfave/cli. It talks to Home Assistant over the WebSocket API and runs a local bridge that shares a single connection with every watcher on your machine.
Sections
Section titled “Sections”- Commands: every command, alias and flag.
- Bridge Protocol: the Unix socket JSON protocol the bridge speaks.
Commands The full command tree with flags and aliases.
Bridge Protocol The socket actions and responses behind the bridge.
How it connects
Section titled “How it connects”When you run a command that needs Home Assistant, Go Automate:
- Loads your configuration (URL and token).
- Opens a WebSocket to
/<scheme>://<host>/api/websocketand authenticates with the token. - Sends the request (a service call, a state read, or an event subscription).
The bridge does the same upstream connection once and keeps it open, then serves cached state and live updates to local clients over a Unix socket. This keeps many watchers cheap: they connect to the socket instead of each opening their own WebSocket to Home Assistant.