AGENTS.md, zigbee2mqtt/state.json

This commit is contained in:
Home Assistant Version Control
2026-07-31 15:12:44 +00:00
parent 8a72fb5a3c
commit 00baf10545
2 changed files with 18 additions and 16 deletions
+3 -1
View File
@@ -117,6 +117,7 @@ Home Assistant is developing a native `llm` integration where Core integrations
A CLI tool designed for AI agents to manage Home Assistant. Run `hab` commands via the terminal: A CLI tool designed for AI agents to manage Home Assistant. Run `hab` commands via the terminal:
- **Entity management**: `hab entity list`, `hab entity get light.living_room`, `hab entity logbook sensor.power --start 2h` - **Entity management**: `hab entity list`, `hab entity get light.living_room`, `hab entity logbook sensor.power --start 2h`
- **Service calls**: `hab action call light.turn_on --entity light.living_room --data '{"brightness": 200}'` - **Service calls**: `hab action call light.turn_on --entity light.living_room --data '{"brightness": 200}'`
- **Service calls that answer with data**: add `--return-response`, e.g. `hab action call weather.get_forecasts --entity weather.home --data '{"type":"daily"}' --return-response`. Without the flag Home Assistant refuses the call outright
- **Automation CRUD**: `hab automation list`, `hab automation create`, `hab automation delete` - **Automation CRUD**: `hab automation list`, `hab automation create`, `hab automation delete`
- **Dashboard management**: `hab dashboard list`, `hab dashboard view create` - **Dashboard management**: `hab dashboard list`, `hab dashboard view create`
- **Area/floor/zone/label**: `hab area list`, `hab area create "Kitchen"` - **Area/floor/zone/label**: `hab area list`, `hab area create "Kitchen"`
@@ -703,7 +704,7 @@ Read and modify YAML files to understand and change Home Assistant's defined beh
### MCP Tools (When Available) ### MCP Tools (When Available)
Query and interact with the running Home Assistant instance: Query and interact with the running Home Assistant instance:
- `get_states`, `search_entities`, `get_home_context` - Current entity states and compact area/domain/entity context - `get_states`, `search_entities`, `get_home_context` - Current entity states and compact area/domain/entity context
- `call_service` - Control devices (with confirmation) - `call_service` - Control devices (with confirmation), and read from services that answer with data (`recorder.get_statistics`, `weather.get_forecasts`, `calendar.get_events`, `todo.get_items`) — the response comes back automatically
- `get_history`, `get_logbook` - Historical data - `get_history`, `get_logbook` - Historical data
- `get_devices`, `get_areas` - Device and area registry info - `get_devices`, `get_areas` - Device and area registry info
- `write_config_safe` - **Safe config writing with automatic validation, content protection, and backup** - `write_config_safe` - **Safe config writing with automatic validation, content protection, and backup**
@@ -724,6 +725,7 @@ Query and interact with the running Home Assistant instance:
| Understand automation logic | Read YAML | Check state with `get_states` | `hab automation get` | N/A | | Understand automation logic | Read YAML | Check state with `get_states` | `hab automation get` | N/A |
| Check current device state | Reference only | Primary (`get_home_context` for focused context) | `hab entity get` | N/A | | Check current device state | Reference only | Primary (`get_home_context` for focused context) | `hab entity get` | N/A |
| Control devices | N/A | `call_service` | `hab action call` | N/A | | Control devices | N/A | `call_service` | `hab action call` | N/A |
| Read from a service that answers with data | N/A | `call_service` (automatic) | `hab action call --return-response` | N/A |
| Add new integrations | Primary | N/A | N/A | N/A | | Add new integrations | Primary | N/A | N/A | N/A |
| Troubleshoot issues | Review configs | `diagnose_entity`, `get_error_log` | `hab system health` | N/A | | Troubleshoot issues | Review configs | `diagnose_entity`, `get_error_log` | `hab system health` | N/A |
| Check agent/LLM readiness | N/A | `get_agent_capabilities` | N/A | N/A | | Check agent/LLM readiness | N/A | `get_agent_capabilities` | N/A | N/A |
+15 -15
View File
@@ -27,10 +27,10 @@
"led_brightness": 100, "led_brightness": 100,
"countdown_to_turn_off": 0, "countdown_to_turn_off": 0,
"countdown_to_turn_on": 0, "countdown_to_turn_on": 0,
"power": 4, "power": 130,
"current": 0.13, "current": 3.26,
"energy": 24.1, "energy": 24.1,
"power_factor": 0.25, "power_factor": 0.33,
"update": { "update": {
"state": "idle", "state": "idle",
"installed_version": 268513381, "installed_version": 268513381,
@@ -74,13 +74,13 @@
"led_brightness": 100, "led_brightness": 100,
"countdown_to_turn_off": 0, "countdown_to_turn_off": 0,
"countdown_to_turn_on": 0, "countdown_to_turn_on": 0,
"voltage": 120, "voltage": 119.5,
"state": "ON", "state": "ON",
"ac_frequency": 60, "ac_frequency": 60,
"energy": 89.31, "energy": 89.31,
"power": 3.7, "power": 109.2,
"current": 0.05, "current": 0.94,
"power_factor": 0.41, "power_factor": 0.93,
"update": { "update": {
"state": "idle", "state": "idle",
"installed_version": 268513381, "installed_version": 268513381,
@@ -96,10 +96,10 @@
"countdown_to_turn_off": 0, "countdown_to_turn_off": 0,
"countdown_to_turn_on": 0, "countdown_to_turn_on": 0,
"voltage": 120.7, "voltage": 120.7,
"energy": 36.73, "energy": 36.74,
"state": "ON", "state": "ON",
"power": 77.4, "power": 68.3,
"current": 0.84, "current": 0.74,
"ac_frequency": 60, "ac_frequency": 60,
"power_factor": 0.8, "power_factor": 0.8,
"update": { "update": {
@@ -119,7 +119,7 @@
"energy": 5.74, "energy": 5.74,
"current": 0.01, "current": 0.01,
"power": 0.1, "power": 0.1,
"power_factor": 0.11, "power_factor": 0,
"linkquality": 109, "linkquality": 109,
"update": { "update": {
"state": "idle", "state": "idle",
@@ -136,14 +136,14 @@
"0xffffb40e0608864e": { "0xffffb40e0608864e": {
"led_brightness": 100, "led_brightness": 100,
"countdown_to_turn_off": 0, "countdown_to_turn_off": 0,
"voltage": 121.4, "voltage": 121.3,
"energy": 16.08, "energy": 16.08,
"countdown_to_turn_on": 0, "countdown_to_turn_on": 0,
"state": "ON", "state": "ON",
"current": 0.02, "current": 0.02,
"ac_frequency": 60, "ac_frequency": 60,
"power": 0.4, "power": 0.4,
"power_factor": 0.2, "power_factor": 0.14,
"update": { "update": {
"state": "idle", "state": "idle",
"installed_version": 268513381, "installed_version": 268513381,
@@ -172,7 +172,7 @@
"0xffffb40e060893d8": { "0xffffb40e060893d8": {
"state": "ON", "state": "ON",
"led_brightness": 100, "led_brightness": 100,
"voltage": 121.7, "voltage": 121.6,
"countdown_to_turn_off": 0, "countdown_to_turn_off": 0,
"countdown_to_turn_on": 0, "countdown_to_turn_on": 0,
"energy": 2.98, "energy": 2.98,
@@ -188,7 +188,7 @@
"latest_release_notes": null "latest_release_notes": null
}, },
"power_factor": 0, "power_factor": 0,
"power": 0.3 "power": 0.1
}, },
"0xa4c1380d0679ffff": { "0xa4c1380d0679ffff": {
"battery": 100, "battery": 100,