# Ha CLI

> Queries and controls an explicitly configured Home Assistant instance and can write a private inventory into the active overlay. Use for Home Assistant state, configuration, integration, service-call, reload, or inventory operations. Never place returned instance data in public Axon.

- Skill: `larsboes/ha-cli` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add larsboes/ha-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/larsboes/ha-cli/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: larsboes (https://skillmd.com/u/larsboes)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/larsboes/ha-cli

---


# ha-cli

Generic Home Assistant REST tooling. Non-secret connection facts come from the active overlay;
the API token comes from the configured private secret mechanism at runtime.

## Commands

```sh
scripts/ha-cli config
scripts/ha-cli domains
scripts/ha-cli states [DOMAIN]
scripts/ha-cli get ENTITY_ID
scripts/ha-cli automations
scripts/ha-cli unavailable
scripts/ha-cli entries
scripts/ha-cli call DOMAIN SERVICE [JSON]
scripts/ha-cli reload-automations
scripts/ha-inventory [--overlay PATH] [--output PATH]
```

Read operations may reveal private entity IDs, locations, devices, URLs, and integration names.
Keep their output local. `ha-inventory` writes to the active overlay by default and must never
target the Axon repository.

Service calls and reloads are writes. Confirm the target and requested action before invoking
them. A missing token or endpoint is an error; do not substitute remembered deployment facts.