Install

Go Automate is a Linux-first command-line tool. You can install it from the AUR on Arch, or build it from source on any platform with a Go toolchain.

Prerequisites

• Go 1.23 or newer to build from source.
• notify-send (from libnotify) for the notify command.
• Optionally, a terminal emulator (foot, alacritty, kitty, ghostty or xterm) so the TUI can open in its own window.
• For building the Arch package locally: base-devel and an AUR helper such as yay.

Install

Arch Linux

Install the latest development build from the AUR package go-automate-git. It builds and installs from the latest main branch, which is updated on every commit.

yay -S go-automate-git

Alternatively, build a local package from a checkout and install it:

make create_arch
yay -U dist/go-automate-<version>-1-x86_64.pkg.tar.zst

Build from source

1. Clone the repository:

   git clone https://github.com/timmo001/go-automate.git
   cd go-automate

2. Build the binary:

   go build

   Or use the Makefile to build the app and the TUI together:

   make build_all

3. Move the binary somewhere on your PATH, for example:

   install -Dm755 go-automate ~/.local/bin/go-automate

What the Arch package installs

The Arch package installs:

• /usr/bin/go-automate — the main binary.
• /usr/lib/systemd/user/go-automate-home-assistant-bridge.service — the bridge user service.

The post-install script enables the bridge service globally for future logins and tries to start it for the installing user when they have an active systemd user session. See Running the Bridge to finish setup.

Next steps

• Configure your Home Assistant URL and token.
• Run the bridge as a user service.
• Explore the CLI and the TUI.