菜单
Create, list, inspect, delete, and restore Home Assistant backups with hass-cli. Use for 'make a backup', 'list my backups', 'back up before I change something', 'delete old backups', 'restore this backup' requests. Backups go to configured agents (local and/or cloud/network).
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Shared foundation for all hass-cli skills. Read this FIRST. Covers connecting to a Home Assistant instance (HASS_SERVER + HASS_TOKEN long-lived token), the unified REST+WebSocket transport facade, output formats (table/json/yaml/ndjson), the raw passthrough escape hatches (raw api / raw ws), and the auth-error recovery table. Use whenever the user mentions Home Assistant, hass-cli, controlling smart-home entities, calling services, automations, or any HA REST/WebSocket API task.
Manage Home Assistant radio gateways and their networks with hass-cli: Zigbee (ZHA), Z-Wave JS, Matter, and Thread/OTBR. Use to pair/remove a Zigbee device, permit join, add/exclude a Z-Wave node, read network status/topology, back up a Zigbee/Z-Wave coordinator, commission a Matter device, or inspect Thread datasets. The gateway integration's own lifecycle (add/reload/delete) lives in ha-integrations; the devices it exposes live in ha-registry.
Manage Home Assistant integrations (config entries) and device discovery with hass-cli: list integrations and their state, reload, enable/disable, delete, update entry options, and inspect discovered/in-progress config flows. Use for 'list my integrations', 'reload the X integration', 'why is this integration failing', 'disable this entry', 'what was discovered on my network' requests.
Inspect and configure Home Assistant's Energy dashboard with hass-cli: read energy preferences (grid/solar/battery/gas/water sources and devices), validate the energy config, and pull consumption statistics. Use for 'show my energy setup', 'how much solar did I produce', 'what's using the most power' questions. Energy data is WebSocket + statistics-based.
Read Home Assistant entity states and recent history with hass-cli. Use to answer 'is the light on', 'what's the temperature', 'list all sensors', 'what changed recently', or to inspect any entity's current state and attributes. Covers state list/get, table shaping (--columns/--sort-by), and history/logbook reads.
Manage Home Assistant add-ons and the Supervisor/OS layer with hass-cli. Use to list/install/uninstall/update/start/stop/restart add-ons, browse the add-on store, read add-on logs, or check Core/Supervisor/OS info. Works through Core's supervisor/api WebSocket proxy with a regular admin token (no separate supervisor token needed).
| name | ha-backup |
| version | 0.1.0 |
| description | Create, list, inspect, delete, and restore Home Assistant backups with hass-cli. Use for 'make a backup', 'list my backups', 'back up before I change something', 'delete old backups', 'restore this backup' requests. Backups go to configured agents (local and/or cloud/network). |
| metadata | {"requires":{"bins":["hass-cli"]},"cliHelp":"hass-cli backup --help"} |
Native Home Assistant backups (the Settings > System > Backups feature).
Prerequisite: ../ha-shared/SKILL.md.
hass-cli backup list # backups + manager state (idle/create_backup/...)
hass-cli backup agents # storage locations (e.g. backup.local, cloud.cloud)
hass-cli backup get <backup_id>
backup list returns backups[] (each with backup_id, name, date,
agents, with_automatic_settings) plus the manager state and the
last/next automatic-backup timestamps.
Specify which agents to store to (get ids from backup agents):
hass-cli backup create --data '{"agent_ids":["backup.local"],"name":"before upgrade"}'
# Or use the configured automatic-backup settings:
hass-cli backup create --auto
create returns a backup_job_id and runs asynchronously. Poll
hass-cli backup list until state is idle and the new backup appears in
backups[]. Optional create fields: include_database (bool),
include_folders (array), include_addons / include_all_addons (supervised
installs), password (encrypt).
On Windows PowerShell prefer
--data @file.jsonover inline JSON.
hass-cli backup delete <backup_id>
hass-cli backup restore <backup_id> --data '{"agent_id":"backup.local"}'
Restore params: agent_id (required — where to pull the backup from),
password (if encrypted), restore_database (bool), restore_addons /
restore_folders (arrays), restore_homeassistant (bool). Restoring triggers a
Home Assistant restart; the CLI call returns as the process begins.
hass-cli backup agents → pick an agent_id.hass-cli backup create --data '{"agent_ids":["backup.local"],"name":"pre-change"}'.hass-cli backup list until the backup shows up.integration reload, workflow automation save).hass-cli backup restore <backup_id> --data '{"agent_id":"backup.local"}'.