home

Modules

The complete inventory of home modules and the job each one owns.

Each module owns one service boundary and exposes its configuration, status, commands, effects, and skill guidance through the shared registry.

Home and network

ModuleSurface
unifiUniFi Network devices, clients, site health, networks, WLANs, firewall rules, reservations, vouchers, PoE cycling, and client control
protectUniFi Protect cameras, PTZ, lights, sensors, door locks, snapshots, events, NVR state, live views, viewers, chimes, and talkback
assistantHome Assistant states, services, automations, scenes, scripts, calendars, templates, history, events, cameras, and logbook

Media

ModuleSurface
spotifyCatalog search, item lookup, categories, new releases, and children
sonosDiscovery, players, playback, volume, grouping, queue, favorites, playlists, library, EQ, alarms, and notifications
ttsText-to-speech MP3 generation through macOS say or Linux espeak-ng

spotify, sonos, and tts are designed to compose: find a URI, hand it to playback, or synthesize an announcement and send it to a player.

Google and communication

ModuleSurface
googleShared Google OAuth client and grant lifecycle
gmailRead-only message/thread search, labels, drafts, and mailbox profile
gcalRead-only calendars, events, merged agendas, recurring expansion, and free/busy
gdriveFile listing, lookup, download, and export
discordChannel listing, message reads, and guarded bot messages

Configure the shared Google client once, then authorize Gmail, Calendar, and Drive independently.

Developer workflow

ModuleSurface
githubRepositories, pull requests, reviews, checks, diffs, Actions, issues, notifications, releases, and code search through gh
graphiteLocal stack layout, parents, children, restack readiness, and guarded mutations through gt
linearIssues, projects, milestones, cycles, teams, assignments, and guarded planning changes
vercelProjects, deployments, build events, domains, and explicit config sync

Operations

ModuleSurface
beszelHost/container health, resource pressure, metric history, SMART health, and firing alerts
uptime-kumaMonitor state, latency, certificates, incidents, maintenance windows, status pages, and summaries

Use home overview ops to combine operational signals across the modules that are configured on the current host.

Discover commands

home <module> --help
home <module> status
home <module> configure
home <module> skill

Shell completion is generated from the same tree, so newly registered commands and flags appear automatically.

On this page