ha-system

name	ha-system
version	0.1.0
description	Inspect Home Assistant system health, repair issues, error logs, logbook, and state history with hass-cli. Use to diagnose problems, check integration health, find open repairs, read recent errors, or gather the raw native data that audits (dead entities, broken automations) are derived from. Complexity scoring/audit are NOT native HA features; compute them here from native data.
metadata	{"requires":{"bins":["hass-cli"]},"cliHelp":"hass-cli system --help"}

ha-system

Native system insight and the data sources for audits. Prerequisite: ../ha-shared/SKILL.md.

Native commands

hass-cli system health        # per-integration health (system_health/info)
hass-cli system repairs       # open issues (Issue Registry / repairs)
hass-cli system errorlog      # raw error log text
hass-cli system logbook --entity <id>
hass-cli system history --entities a,b --start <iso8601>
hass-cli system hardware      # board / dongle info (hardware integration)
hass-cli system analytics     # analytics opt-in preferences
hass-cli system labs          # experimental preview (labs) features

Maintenance (hardware / analytics / labs)

hass-cli system hardware -o json | jq '.hardware'   # [] on plain Container installs

# Analytics opt-in (base/diagnostics/usage/statistics/snapshots)
hass-cli system analytics
hass-cli system analytics set --data '{"base":true,"statistics":true}'

# Labs preview features: list, then toggle one
hass-cli system labs
hass-cli system labs update --data '{"domain":"frontend","preview_feature":"winter_mode","enabled":true}'

Notes:

• hardware/analytics are provided by integrations that load shortly after startup; right after onboarding they may briefly return unknown_command.
• Enabling some labs features reloads/sets up the owning integration; pass "create_backup":true in the update payload to snapshot first.

What is and isn't native

Home Assistant natively provides: Repairs (issue registry), System Health, traces, logbook, history. It does NOT provide complexity scores, "dead entity" reports, or automation audits — those are derived. Compute them from native data (see ../ha-workflow-audit/SKILL.md).

Quick checks

# Anything broken or needing attention?
hass-cli system repairs -o json | jq '.issues'

# Recent errors only
hass-cli system errorlog | tail -n 40