# Send Home Assistant CLI to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "homeassistant-cli",
    "name": "Home Assistant CLI",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/JonesChi/homeassistant-cli",
    "canonicalUrl": "https://clawhub.ai/JonesChi/homeassistant-cli",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/homeassistant-cli",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=homeassistant-cli",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "references/examples.md",
      "references/troubleshooting.md",
      "references/autocomplete.md",
      "README.md",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "homeassistant-cli",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-04T04:12:54.177Z",
      "expiresAt": "2026-05-11T04:12:54.177Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=homeassistant-cli",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=homeassistant-cli",
        "contentDisposition": "attachment; filename=\"homeassistant-cli-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "homeassistant-cli"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/homeassistant-cli"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/homeassistant-cli",
    "downloadUrl": "https://openagent3.xyz/downloads/homeassistant-cli",
    "agentUrl": "https://openagent3.xyz/skills/homeassistant-cli/agent",
    "manifestUrl": "https://openagent3.xyz/skills/homeassistant-cli/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/homeassistant-cli/agent.md"
  }
}
```
## Documentation

### Home Assistant CLI

Control your Home Assistant smart home devices using the official hass-cli tool — a feature-rich command-line interface with auto-completion, event monitoring, and flexible output formatting.

### Why This Skill vs. homeassistant (curl-based)?

Choose homeassistant-cli if you want:

✅ Auto-completion for entity IDs and services (bash/zsh/fish)
✅ Event monitoring in real-time (hass-cli event watch)
✅ History queries (hass-cli state history)
✅ Better output formatting (table/YAML/JSON with one flag)
✅ Interactive exploration (easier to discover entities and services)
✅ Comprehensive documentation with examples and troubleshooting

Choose homeassistant (curl) if you want:

✅ Zero dependencies (curl + jq are pre-installed)
✅ Lightweight and fast
✅ Better for scripting and automation
✅ No Python requirements

Both work great — this skill is for users who interact frequently with Home Assistant and want a richer CLI experience.

### Setup

Before using hass-cli, configure authentication:

Generate a long-lived access token in Home Assistant:

Navigate to your profile: https://your-homeassistant:8123/profile
Scroll to "Long-Lived Access Tokens"
Create a new token



Set environment variables (add to shell config for persistence):
export HASS_SERVER=https://homeassistant.local:8123
export HASS_TOKEN=<your-token>



Test connection:
hass-cli info

### List Entities

# List all entities
hass-cli state list

# Filter by domain
hass-cli state list light
hass-cli state list switch
hass-cli state list sensor

# Get specific entity state
hass-cli state get light.living_room

### Control Devices

# Turn on/off lights
hass-cli service call light.turn_on --arguments entity_id=light.living_room
hass-cli service call light.turn_off --arguments entity_id=light.living_room

# Set brightness (0-255)
hass-cli service call light.turn_on --arguments entity_id=light.bedroom,brightness=128

# Turn on/off switches
hass-cli service call switch.turn_on --arguments entity_id=switch.fan
hass-cli service call switch.turn_off --arguments entity_id=switch.fan

# Toggle any device
hass-cli service call homeassistant.toggle --arguments entity_id=light.kitchen

### List and Call Services

# List all services
hass-cli service list

# Filter services
hass-cli service list light
hass-cli service list 'home.*toggle'

# Get service details (YAML output)
hass-cli -o yaml service list homeassistant.toggle

### Work with Scenes

# List scenes
hass-cli state list scene

# Activate a scene
hass-cli service call scene.turn_on --arguments entity_id=scene.movie_time

### Monitor Events

# Watch all events
hass-cli event watch

# Watch specific event type
hass-cli event watch state_changed
hass-cli event watch automation_triggered

### History

# Get state history (last 50 minutes)
hass-cli state history --since 50m light.living_room

# Multiple entities
hass-cli state history --since 1h light.living_room switch.fan

### Output Formats

Control output with -o or --output:

# Table (default)
hass-cli state list

# YAML
hass-cli -o yaml state get light.living_room

# JSON
hass-cli -o json state list light

# No headers (for scripting)
hass-cli --no-headers state list

### Tips

Entity discovery: Use hass-cli state list to find entity IDs
Service discovery: Use hass-cli service list to find available services
Auto-completion: See references/autocomplete.md for shell setup
Troubleshooting: See references/troubleshooting.md

### Examples

See references/examples.md for common automation patterns and use cases.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: JonesChi
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-04T04:12:54.177Z
- Expires at: 2026-05-11T04:12:54.177Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/homeassistant-cli)
- [Send to Agent page](https://openagent3.xyz/skills/homeassistant-cli/agent)
- [JSON manifest](https://openagent3.xyz/skills/homeassistant-cli/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/homeassistant-cli/agent.md)
- [Download page](https://openagent3.xyz/downloads/homeassistant-cli)