HASS.Agent .NET10 — a modern Windows companion for Home Assistant

What it does

Observe and control your Windows PCs from Home Assistant — split between an interactive tray app and an optional system service.

🔔

Notifications

Home Assistant notifications as tray balloons or actionable popups — buttons fire action events back to HA for automations.

🎵

Media player

Control and observe the active media session — play, pause, skip, volume, and album art straight from HA.

📊

Sensors

Built-in system sensors plus custom sensors (process, service, disk) with fast / normal / hourly / startup polling profiles.

⚡

Commands

Shutdown, restart, and custom command buttons — run from automations or the HA dashboard.

🛠️

Windows service

An optional system service handles features that should work even when no user is logged in.

🧰

Danger Zone

Opt-in toolbox: MQTT cleanup, live monitor, debug log, settings backup/restore, and factory reset.

Three ways to connect

Use whichever fits your setup — or let the app fail over automatically when you're away from home.

RECOMMENDED

MQTT

Fast, local auto-discovery via your MQTT broker (e.g. Mosquitto). The primary, full-featured transport.

FAILOVER / REMOTE

HA WebSocket API

Connect over the Home Assistant WebSocket API — perfect for laptops away from home or setups with no MQTT broker. Auto-fails over when MQTT drops.

FALLBACK

Local HTTP API

A notification-only local endpoint for simple, direct integrations.

One-click updates from Home Assistant

Press Install in Home Assistant — done.

The HA update entity has a real Install button. With the system service installed, updates apply fully silently — no UAC prompt, the tray app relaunches itself, and Home Assistant gets a persistent notification when it's finished. Opt into the beta channel right inside the app to follow pre-releases.