← Back to Skills Marketplace
6273
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 only if you are comfortable giving a CLI broad Home Assistant access. Use HTTPS with certificate verification, avoid storing long-lived tokens in shell startup files, never print or paste the token, prefer a secret manager or restricted config, and test state-changing commands only on verified non-critical entities with explicit user confirmation.
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
Credentials
The skill needs a Home Assistant server URL and long-lived token, which is expected, but the docs recommend persistent shell exports, include an HTTP example, and suggest --insecure troubleshooting without adequate credential and transport warnings.
Install Mechanism
The OpenClaw metadata offers pip and Homebrew installation of homeassistant-cli by mutable package/formula name, which is purpose-aligned but unpinned and relies on the upstream package supply chain.
Instruction Scope
The skill gives direct service-call and scripting examples for lights, switches, climate, covers, automations, notifications, media players, and alarms, but does not clearly separate read-only discovery from state-changing actions or warn about physical impact.
Persistence & Privilege
The skill does not install a backdoor or background service, but it tells users to persist HASS_TOKEN in shell configuration and add eval-based shell completion to rc files, creating persistent credential and shell-startup exposure.
Purpose & Capability
The stated purpose matches the artifacts: installing and using hass-cli to query and control Home Assistant. The concern is that examples include real physical-device and security-relevant actions without clear cautions or confirmation guidance.
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 6273 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