macOS
Homebrewverified · 100%
brew install go-hass-agentlocal Homebrew formula metadata
brew / rank 9554
Install go-hass-agent with Homebrew, Nix
Native Home Assistant agent for desktop/laptop devices. Version 14.15.0 via Homebrew; verified 2026-07-27. Also installable with nix: nix profile install nixpkgs#go-hass-agent.
install
Additional install commands
Linux
Nixverified · 92%
nix profile install nixpkgs#go-hass-agentnixpkgs package indexes · pkgs/by-name/go/go-hass-agent/package.nix · source: api.github.com
overview
Package summary
Native Home Assistant agent for desktop/laptop devices
Project links
Commands and aliases
- go-hass-agent
history
Project history and usage
Go Hass Agent is a native Home Assistant companion-style agent for desktop and laptop devices. It exposes local sensors, controls, and events from a machine to Home Assistant so they can be used in dashboards and automations.
Project history
The repository was created in April 2023, and the author introduced the project to the Home Assistant community the same month as a native app integration for desktop and laptop devices. The README frames it as analogous to the Home Assistant mobile companion app, but aimed at desktops, servers, Raspberry Pi devices, and other systems that can run Go.
Adoption history
The tool serves a focused Home Assistant niche: users who want desktop or server state inside automations without depending on a mobile companion app. Its Homebrew and Nix packaging broaden installation beyond manual Go builds, while the README's platform tables document a Linux-heavy sensor set plus cross-platform script and MQTT extension points.
How it is used
Practitioners run Go Hass Agent on a device they want Home Assistant to observe or control. The agent reports sensors such as battery, CPU, memory, disk, network, media, screen lock, user sessions, and hardware information where the operating system supports them; it can also expose custom script sensors, MQTT sensors and controls, D-Bus controls, notifications, and Home Assistant events.
Why package nerds care
For package catalogs, Go Hass Agent is a useful example of a desktop-adjacent automation agent packaged as a Go binary. Its value comes from bridging local OS APIs, MQTT, and Home Assistant's native app integration model rather than from being a general-purpose developer tool.
Timeline
- 2023: The GitHub repository was created.
- 2023: The author shared the project on the Home Assistant community forum.
- 2023: v5.0.x releases appeared on GitHub.
- 2026: v14.x releases showed ongoing packaging and sensor work.
Related projects
- Home Assistant
- Home Assistant Companion App
- HASS.Agent
- MQTT
Sources
security posture
Risk level: orange
formula declares a Homebrew service.
Risk classifier
orange risk · medium confidence · infrastructure
Why
- formula declares a Homebrew service
Signals
- metadata:service
Install behavior
- No Homebrew bottle metadata was recorded.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
Configuration and credential file locations
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Configuration files
Config paths the tool may read or write during local use.
- Linux
~/.config/go-hass-agent/preferences.toml~/.config/go-hass-agent/commands.toml- macOS
~/Library/Application Support/go-hass-agent/preferences.toml~/Library/Application Support/go-hass-agent/commands.toml- Windows
%LocalAppData%\go-hass-agent\preferences.toml%LocalAppData%\go-hass-agent\commands.toml
Credential files
Credential-bearing paths to review before unattended agent runs.
- Linux
~/.config/go-hass-agent/preferences.toml- macOS
~/Library/Application Support/go-hass-agent/preferences.toml- Windows
%LocalAppData%\go-hass-agent\preferences.toml
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
go-hass-agent | executable | indexed executable | Discovered from the local executable index. |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-08-03
manager version14.15.0
manager updated2026-07-27
local dataunknown
upstreamnot available
latest detectednot detected
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:go-hass-agent |
|---|---|
| Version | 14.15.0 |
| Package manager | Homebrew |
| Homepage | https://github.com/joshuar/go-hass-agent |
| Repository | https://github.com/joshuar/go-hass-agent |
| Last updated | 2026-07-27T14:57:50+02:00 |
| Pulse | updated |
| Bottle | not recorded |
| Service | none declared |
source database matches
Other package-manager records
Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.
Nix95%
go-hass-agent
nix profile install nixpkgs#go-hass-agent- normalized package name match
- Matched by: Go Hass Agent
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- external package-manager database matches
- pkg.so package database
- pkgdb category and tag curation