homeassistant-cli 0.1.2

Agent-friendly Home Assistant CLI with JSON output, structured exit codes, and schema introspection
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

# homeassistant-cli

Agent-friendly CLI for Home Assistant with JSON output, structured exit codes, and schema introspection.

## Installation

```bash
cargo install homeassistant-cli
```

## Configuration

Run `ha init` to set up credentials interactively, or create `~/.config/ha/config.toml`:

```toml
[default]
url = "http://homeassistant.local:8123"
token = "eyJ..."
```

Create a long-lived access token in Home Assistant: **Settings → Profile → Long-Lived Access Tokens**.

Environment variables override the config file:
- `HA_URL` — Home Assistant URL
- `HA_TOKEN` — Long-lived access token
- `HA_PROFILE` — Active profile name

## Usage

```
ha entity get <entity_id>
ha entity list [--domain <domain>]
ha entity watch <entity_id>

ha service call <domain.service> [--entity <id>] [--data <json>]
ha service list [--domain <domain>]

ha event fire <event_type> [--data <json>]
ha event watch [<event_type>]

ha schema
ha init [--profile <name>]
ha config show
ha config set <key> <value>
```

## Agent Use

Output is JSON when stdout is not a terminal, or with `--output json`:

```json
{ "ok": true, "data": { ... } }
{ "ok": false, "error": { "code": "HA_NOT_FOUND", "message": "..." } }
```

Exit codes: `0` success, `1` error, `2` auth/config, `3` not found, `4` connection.

Run `ha schema` for a full machine-readable description of all commands, flags, and output shapes.

## License

MIT