smart-home

Check Home Assistant backup status and history

List and check status of all Home Assistant add-ons

Review Home Assistant automations for issues and optimization

Check Home Assistant database health and performance

List and analyze Home Assistant entities

List and check status of all Home Assistant integrations

Examine Home Assistant logs for errors, warnings, and issues

Check MQTT broker status and connectivity

Check Home Assistant network configuration and connectivity

Review sensor entities and their status

Check Home Assistant storage and disk space

Check for available Home Assistant updates

Check Zigbee network status and health

Check Z-Wave network status and health

Clean up Home Assistant database and optimize

Validate Home Assistant configuration without restarting

Create a Home Assistant snapshot/backup

Check comprehensive Home Assistant system status and health

Analyze and optimize Home Assistant performance

Restart Home Assistant (with safety checks)

Verify backup integrity and completeness

Report who's currently streaming.

Find library hygiene issues. **Read-only by default** — propose, don't delete.

Scan the LAN and identify the Plex server, the NAS, and Plex clients.

Synology-focused health check.

Walk the user through setting up this workspace for their specific Plex + Synology stack.

Trigger a library scan on the Plex server.

Produce a quick health snapshot of the whole stack.

Add an additional audio output (second speaker) to a snapclient

Create a persistent Snapcast group in /etc/snapserver.conf and mirror to topology

Delete a persistent Snapcast group from /etc/snapserver.conf

Diagnose a snapclient that's silent, desynced, or disconnected

Render a point-in-time topology map of the Snapcast network to network/maps/

Install snapclient on a target host, point it at the snapserver, bind it to a sink, and register it in topology

ARP-scan the LAN to discover the snapserver and snapclients, then update network/topology.yaml

Define or change the audio sink (speaker) bound to a snapclient

Quick health summary of the snapserver and all known clients

Rename a Snapcast group, change its stream, or update client membership

Install snapclient on a target host, point it at the snapserver, and register it in the topology

Apply a per-device EQ / DSP preset (podcast, classical, bass, vocal, flat) via PipeWire / EasyEffects / ALSA

Diagnose why a specific device isn't playing — checks service status, audio sink, reachability, Spotify Connect visibility

Render a timestamped Typst PDF of the current Spotify playback network topology

Document and configure multi-user Spotify Connect visibility on the household network

Install and configure snapserver on a chosen host, with the primary speaker attached, to fan synchronized audio out to snapclients

Install a Spotify Connect client (raspotify, spotifyd, librespot, or verify the official app) on a target host and bind it to a chosen audio sink

ARP-scan the LAN to discover candidate Spotify playback hosts and persist them to network/topology.yaml

Read network/topology.yaml and report the current playback network at a glance

Help create, debug, and optimize Home Assistant automations

Manage and troubleshoot Home Assistant backup operations

Manage Home Assistant devices and their entities

Manage, configure, and troubleshoot Home Assistant integrations

Diagnose and resolve Home Assistant issues systematically

Provision a new smart-home workspace on disk. Use when the user wants to start a fresh workspace for Home Assistant administration, multi-room audio (Snapcast/Spotify), or a Plex+NAS media server. Accepts a workspace name and a variant (home-assistant | multi-room-audio | media-server). Scaffolds the workspace, personalises CLAUDE.md from the user's global memory, and (by default) creates a public GitHub repo.

Reference material for Snapcast server config, client flags, group semantics, and JSON-RPC control. Loaded when working on Snapcast topology.

Shared references for the Spotify Network Installer template — package names, systemd unit fragments, EQ preset definitions, and zeroconf quirks. Loaded by the commands in this repo.