{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/homeassistant-cli",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=homeassistant-cli",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "references/examples.md",
      "references/troubleshooting.md",
      "references/autocomplete.md",
      "README.md",
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/homeassistant-cli",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Home Assistant CLI",
        "body": "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."
      },
      {
        "title": "Why This Skill vs. homeassistant (curl-based)?",
        "body": "Choose homeassistant-cli if you want:\n\n✅ Auto-completion for entity IDs and services (bash/zsh/fish)\n✅ Event monitoring in real-time (hass-cli event watch)\n✅ History queries (hass-cli state history)\n✅ Better output formatting (table/YAML/JSON with one flag)\n✅ Interactive exploration (easier to discover entities and services)\n✅ Comprehensive documentation with examples and troubleshooting\n\nChoose homeassistant (curl) if you want:\n\n✅ Zero dependencies (curl + jq are pre-installed)\n✅ Lightweight and fast\n✅ Better for scripting and automation\n✅ No Python requirements\n\nBoth work great — this skill is for users who interact frequently with Home Assistant and want a richer CLI experience."
      },
      {
        "title": "Setup",
        "body": "Before using hass-cli, configure authentication:\n\nGenerate a long-lived access token in Home Assistant:\n\nNavigate to your profile: https://your-homeassistant:8123/profile\nScroll to \"Long-Lived Access Tokens\"\nCreate a new token\n\n\n\nSet environment variables (add to shell config for persistence):\nexport HASS_SERVER=https://homeassistant.local:8123\nexport HASS_TOKEN=<your-token>\n\n\n\nTest connection:\nhass-cli info"
      },
      {
        "title": "List Entities",
        "body": "# List all entities\nhass-cli state list\n\n# Filter by domain\nhass-cli state list light\nhass-cli state list switch\nhass-cli state list sensor\n\n# Get specific entity state\nhass-cli state get light.living_room"
      },
      {
        "title": "Control Devices",
        "body": "# Turn on/off lights\nhass-cli service call light.turn_on --arguments entity_id=light.living_room\nhass-cli service call light.turn_off --arguments entity_id=light.living_room\n\n# Set brightness (0-255)\nhass-cli service call light.turn_on --arguments entity_id=light.bedroom,brightness=128\n\n# Turn on/off switches\nhass-cli service call switch.turn_on --arguments entity_id=switch.fan\nhass-cli service call switch.turn_off --arguments entity_id=switch.fan\n\n# Toggle any device\nhass-cli service call homeassistant.toggle --arguments entity_id=light.kitchen"
      },
      {
        "title": "List and Call Services",
        "body": "# List all services\nhass-cli service list\n\n# Filter services\nhass-cli service list light\nhass-cli service list 'home.*toggle'\n\n# Get service details (YAML output)\nhass-cli -o yaml service list homeassistant.toggle"
      },
      {
        "title": "Work with Scenes",
        "body": "# List scenes\nhass-cli state list scene\n\n# Activate a scene\nhass-cli service call scene.turn_on --arguments entity_id=scene.movie_time"
      },
      {
        "title": "Monitor Events",
        "body": "# Watch all events\nhass-cli event watch\n\n# Watch specific event type\nhass-cli event watch state_changed\nhass-cli event watch automation_triggered"
      },
      {
        "title": "History",
        "body": "# Get state history (last 50 minutes)\nhass-cli state history --since 50m light.living_room\n\n# Multiple entities\nhass-cli state history --since 1h light.living_room switch.fan"
      },
      {
        "title": "Output Formats",
        "body": "Control output with -o or --output:\n\n# Table (default)\nhass-cli state list\n\n# YAML\nhass-cli -o yaml state get light.living_room\n\n# JSON\nhass-cli -o json state list light\n\n# No headers (for scripting)\nhass-cli --no-headers state list"
      },
      {
        "title": "Tips",
        "body": "Entity discovery: Use hass-cli state list to find entity IDs\nService discovery: Use hass-cli service list to find available services\nAuto-completion: See references/autocomplete.md for shell setup\nTroubleshooting: See references/troubleshooting.md"
      },
      {
        "title": "Examples",
        "body": "See references/examples.md for common automation patterns and use cases."
      }
    ],
    "body": "Home Assistant CLI\n\nControl 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.\n\nWhy This Skill vs. homeassistant (curl-based)?\n\nChoose homeassistant-cli if you want:\n\n✅ Auto-completion for entity IDs and services (bash/zsh/fish)\n✅ Event monitoring in real-time (hass-cli event watch)\n✅ History queries (hass-cli state history)\n✅ Better output formatting (table/YAML/JSON with one flag)\n✅ Interactive exploration (easier to discover entities and services)\n✅ Comprehensive documentation with examples and troubleshooting\n\nChoose homeassistant (curl) if you want:\n\n✅ Zero dependencies (curl + jq are pre-installed)\n✅ Lightweight and fast\n✅ Better for scripting and automation\n✅ No Python requirements\n\nBoth work great — this skill is for users who interact frequently with Home Assistant and want a richer CLI experience.\n\nSetup\n\nBefore using hass-cli, configure authentication:\n\nGenerate a long-lived access token in Home Assistant:\n\nNavigate to your profile: https://your-homeassistant:8123/profile\nScroll to \"Long-Lived Access Tokens\"\nCreate a new token\n\nSet environment variables (add to shell config for persistence):\n\nexport HASS_SERVER=https://homeassistant.local:8123\nexport HASS_TOKEN=<your-token>\n\n\nTest connection:\n\nhass-cli info\n\nCommon Commands\nList Entities\n# List all entities\nhass-cli state list\n\n# Filter by domain\nhass-cli state list light\nhass-cli state list switch\nhass-cli state list sensor\n\n# Get specific entity state\nhass-cli state get light.living_room\n\nControl Devices\n# Turn on/off lights\nhass-cli service call light.turn_on --arguments entity_id=light.living_room\nhass-cli service call light.turn_off --arguments entity_id=light.living_room\n\n# Set brightness (0-255)\nhass-cli service call light.turn_on --arguments entity_id=light.bedroom,brightness=128\n\n# Turn on/off switches\nhass-cli service call switch.turn_on --arguments entity_id=switch.fan\nhass-cli service call switch.turn_off --arguments entity_id=switch.fan\n\n# Toggle any device\nhass-cli service call homeassistant.toggle --arguments entity_id=light.kitchen\n\nList and Call Services\n# List all services\nhass-cli service list\n\n# Filter services\nhass-cli service list light\nhass-cli service list 'home.*toggle'\n\n# Get service details (YAML output)\nhass-cli -o yaml service list homeassistant.toggle\n\nWork with Scenes\n# List scenes\nhass-cli state list scene\n\n# Activate a scene\nhass-cli service call scene.turn_on --arguments entity_id=scene.movie_time\n\nMonitor Events\n# Watch all events\nhass-cli event watch\n\n# Watch specific event type\nhass-cli event watch state_changed\nhass-cli event watch automation_triggered\n\nHistory\n# Get state history (last 50 minutes)\nhass-cli state history --since 50m light.living_room\n\n# Multiple entities\nhass-cli state history --since 1h light.living_room switch.fan\n\nOutput Formats\n\nControl output with -o or --output:\n\n# Table (default)\nhass-cli state list\n\n# YAML\nhass-cli -o yaml state get light.living_room\n\n# JSON\nhass-cli -o json state list light\n\n# No headers (for scripting)\nhass-cli --no-headers state list\n\nTips\nEntity discovery: Use hass-cli state list to find entity IDs\nService discovery: Use hass-cli service list to find available services\nAuto-completion: See references/autocomplete.md for shell setup\nTroubleshooting: See references/troubleshooting.md\nExamples\n\nSee references/examples.md for common automation patterns and use cases."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/JonesChi/homeassistant-cli",
    "publisherUrl": "https://clawhub.ai/JonesChi/homeassistant-cli",
    "owner": "JonesChi",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}