hass-cli

Home Assistant CLI replacement focused on full feature coverage.

Install dependencies

bun install

Configure environment

Copy .env.example to .env and fill values:

cp .env.example .env

Required variables:

• HOMEASSISTANT_WS: Home Assistant WebSocket endpoint (example: ws://homeassistant.local:8123/api/websocket)
• HOMEASSISTANT_TOKEN: Home Assistant long-lived access token

Run

bun run index.ts doctor

CLI usage

hass-cli doctor
hass-cli ping
hass-cli entity list
hass-cli entity list --all
hass-cli entity list --room kitchen
hass-cli entity list --device-id abc123def456
hass-cli entity list --integration mqtt
hass-cli entity list --domain light
hass-cli entity get light.kitchen_main
hass-cli entity update light.kitchen_main --name "Kitchen Main" --room kitchen
hass-cli automation list
hass-cli automation get automation.good_morning
hass-cli automation enable automation.good_morning
hass-cli automation disable automation.good_morning
hass-cli automation trigger automation.good_morning
hass-cli automation trace automation.good_morning
hass-cli service list --domain light
hass-cli service call light turn_on --entity-id light.kitchen_main --data '{"brightness": 180}'
hass-cli dashboard list
hass-cli dashboard get dashboard-newipad
hass-cli dashboard update dashboard-newipad --json '{"title":"NewIpad"}'
hass-cli dashboard create cli-temp-dash --title "CLI Temp Dash" --icon mdi:test-tube
hass-cli dashboard delete cli-temp-dash --yes
hass-cli logbook --hours 6 --limit 100
hass-cli history light.kitchen_main --hours 24
hass-cli room list
hass-cli device list
hass-cli device get c1c1e66232e21ca47077d90c256ff2d6
hass-cli integration list
hass-cli integration status
hass-cli help

entity list prints the first 120 matches by default; pass --all to print all matching entities.

automation trigger performs a manual trigger without a trigger id or trigger data payload.

Running hass-cli with no command now defaults to:

• help when required environment is configured
• doctor output when required environment is missing