Home Assistant CLI

Use this skill when the user wants to interact with Home Assistant through the upstream hass-cli command-line tool from home-assistant-ecosystem/home-assistant-cli.

When To Use

Use this skill for requests involving hass-cli, Home Assistant CLI, Home Assistant command-line automation, entities, states, services, devices, areas, events, templates, raw API calls, or Home Assistant Operating System supervisor/core commands.

Do not use this skill for the separate ha command-line tool unless the user specifically asks to use hass-cli ha ... commands.

Safety

• Never print or expose HASS_TOKEN, HASS_SUPERVISOR_TOKEN, HASS_PASSWORD, long-lived access tokens, or API keys.
• Do not read, print, dump, or expose environment variables. Avoid commands such as env, printenv, export, set, declare, or echo $HASS_TOKEN. Never inspect token values directly.
• When checking Home Assistant access, run hass-cli commands and report success or sanitized errors. If authentication appears missing, ask the user to confirm that HASS_SERVER, HASS_TOKEN, or HASS_SUPERVISOR_TOKEN are set without revealing their values.
• Prefer read-only discovery commands before making changes.
• Ask for confirmation before commands that change state, call services, update/delete areas, assign devices, create backups, update Home Assistant Core, or use raw endpoints with non-GET behavior.
• Avoid --insecure unless the user explicitly accepts connecting with ignored TLS certificate validation.
• Use --output=json or --output=yaml for data that will be parsed or summarized.