← Back to Skills Marketplace
4797
Downloads
13
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install homeassistant-cli
Description
Advanced Home Assistant control using the official hass-cli tool. Features auto-completion, event monitoring, history queries, and rich output formatting. Alternative to the curl-based homeassistant skill - choose this if you want a more interactive CLI experience with better discovery and formatting.
Usage Guidance
Install this only if you want OpenClaw to help operate your Home Assistant instance. Use a restricted Home Assistant account if possible, keep HASS_TOKEN out of logs, screenshots, shell history, and version-controlled dotfiles, and require explicit confirmation before commands that affect alarms, locks, covers, climate, appliances, or security-related automations.
Capability Analysis
Type: OpenClaw Skill
Name: homeassistant-cli
Version: 1.0.0
The skill bundle is a legitimate wrapper for the `hass-cli` tool, providing documentation and examples for Home Assistant control. It instructs the user to configure sensitive `HASS_TOKEN` and `HASS_SERVER` environment variables, which is standard for `hass-cli`. The use of `eval` for shell auto-completion in `references/autocomplete.md` is a common and expected pattern for CLI tools, not indicative of malicious execution. All commands and instructions are focused on interacting with Home Assistant and lack any evidence of data exfiltration, malicious execution, persistence, or prompt injection attempts against the agent.
Capability Assessment
Purpose & Capability
The documented capabilities match the stated purpose: using hass-cli to list entities, monitor events, query history, and call Home Assistant services. Those capabilities can affect real devices, alarms, climate, automations, and household privacy, but that is inherent to the skill's purpose.
Instruction Scope
The artifacts are command documentation and examples, not hidden automatic execution. Some examples are state-changing and safety-sensitive, so user confirmation and careful entity selection are important.
Install Mechanism
The skill installs or requires the external homeassistant-cli package through pip or Homebrew and contains only markdown files itself. The external dependency is purpose-aligned, but users are relying on that package supply chain.
Credentials
HASS_SERVER and HASS_TOKEN are expected for hass-cli access. The token requirement is disclosed, but the docs give limited warning that the token may grant broad smart-home read/control access.
Persistence & Privilege
The README and SKILL.md suggest storing the token in shell startup files, and autocomplete setup uses a standard shell eval pattern. These are disclosed and common for CLI tooling, but users should protect the token and only enable completion from a trusted install.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install homeassistant-cli - After installation, invoke the skill by name or use
/homeassistant-cli - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the homeassistant-cli skill.
- Provides advanced Home Assistant control using the official hass-cli tool.
- Features include auto-completion, real-time event monitoring, history queries, and rich output formatting (table/YAML/JSON).
- Offers enhanced interactivity and discoverability compared to curl-based alternatives.
- Includes setup instructions, common commands, and usage tips for a richer CLI experience.
Metadata
Frequently Asked Questions
What is Home Assistant CLI?
Advanced Home Assistant control using the official hass-cli tool. Features auto-completion, event monitoring, history queries, and rich output formatting. Alternative to the curl-based homeassistant skill - choose this if you want a more interactive CLI experience with better discovery and formatting. It is an AI Agent Skill for Claude Code / OpenClaw, with 4797 downloads so far.
How do I install Home Assistant CLI?
Run "/install homeassistant-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Home Assistant CLI free?
Yes, Home Assistant CLI is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Home Assistant CLI support?
Home Assistant CLI is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Home Assistant CLI?
It is built and maintained by JonesChi (@joneschi); the current version is v1.0.0.
More Skills