# Ha System

> 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.

- Skill: `beclab/ha-system` (Agent Skill)
- Install (CLI): `npx skillmds@latest add beclab/ha-system`
- Raw SKILL.md: https://api.skillmd.com/api/skills/beclab/ha-system/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: beclab (https://skillmd.com/u/beclab)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/beclab/ha-system

---


# ha-system

Native system insight and the data sources for audits. **Prerequisite:**
[`../ha-shared/SKILL.md`](../ha-shared/SKILL.md).

## Native commands

```bash
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)

```bash
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`](../ha-workflow-audit/SKILL.md)).

## Quick checks

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

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