# 使用 Homebrew 安装 homeassistant-cli 查看 homeassistant-cli 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。 ## 安装 ```sh sudo av install brew:homeassistant-cli ``` 其他安装命令: ### macOS - Homebrew (100%): ```sh brew install homeassistant-cli ``` 证据: local Homebrew formula metadata ## 软件包事实 - **软件包键:** brew:homeassistant-cli - **软件包管理器:** Homebrew - **版本:** 1.0.0 - **来源摘要:** Command-line utility for Home Assistant - **主页:** - **仓库:** - **最后更新:** 2026-06-09T11:20:01Z - **已生成:** 2026-08-03T19:37:03+00:00 ## 可执行文件 - hass-cli (别名) ## 安装行为 - Bottle: 不可用 ## 版本和新鲜度 - 页面生成时间: 2026-08-03 - 管理器版本: 1.0.0 ## 项目历史与用法 Home Assistant CLI, invoked as hass-cli, is a Python command-line client for working with local or remote Home Assistant instances. It wraps Home Assistant APIs in a shell-friendly interface for listing states, calling services, rendering templates, querying history, using completions, and scripting common smart-home tasks. ### 项目历史 The project was initially started by Fabian Affolter and then developed further by Max Rydahl Andersen, according to the official Home Assistant announcement. That announcement framed hass-cli as a missing command-line layer for Home Assistant users who wanted auto-completion, scripting, and direct access without replacing the browser UI. Early PyPI metadata shows a 0.0.2 release in November 2018. The official announcement describes the 0.4 era as a cleanup point where commands became more logical and explicit, table output became the default for many operations, and common Home Assistant operations were exposed as CLI subcommands. Later README examples show broader coverage, including state, device, area, event, service, config, integration, template, and Home Assistant Operating System related commands. ### 采用历史 Home Assistant CLI adoption is tied to Home Assistant's power-user culture: people who automate homes often also automate their automation system. The official README lists installation through pip, Fedora/EPEL packages, Homebrew, NixOS, and Docker, which reflects use across workstations, development shells, and containers. The Home Assistant community thread around the announcement shows the package-manager angle clearly: by August 2019, users were discussing Homebrew version lag and release automation for the formula. That is a small but telling sign that hass-cli was expected to behave like a normal developer CLI, not just a Python library. ### 使用方式 A typical setup exports HASS_SERVER and HASS_TOKEN after generating a long-lived Home Assistant token. The README also documents HASS_SUPERVISOR_TOKEN for supervisor access, HASS_PASSWORD for older password-based access, client certificate support, and shell completion for bash, zsh, and fish. Common commands include hass-cli state list, state get, state history, service list, service call, config release, event watch, device list, area create or assign, raw API calls, and template rendering. The CLI can emit table, JSON, YAML, NDJSON, and other table formats, which is why it fits shell pipelines and scripts. ### 为什么软件包爱好者会关心 Home Assistant CLI is package-nerd significant because it is the shell bridge into a popular self-hosted automation platform. It converts a web-and-API product into something scriptable with environment variables, completions, JSON/YAML output, and package-manager installs. It also illustrates the messier side of Python CLI packaging: pip releases, distro packages, Homebrew formula updates, Docker wrappers, and Home Assistant's own supervisor CLI world overlap. For a package maintainer, the interesting parts are dependency freshness, token handling, and keeping the CLI aligned with evolving Home Assistant APIs. ### 时间线 - 2018: PyPI records homeassistant-cli 0.0.2. - 2019: Home Assistant announcement introduced hass-cli to the wider Home Assistant audience around the 0.4 era. - 2019: Homebrew packaging lag and formula automation were discussed in the official community thread. - 2020: PyPI records the 0.9.0 line. - 2022: PyPI records 0.9.6. - 2026: PyPI records 1.0.0. ### Related projects - Home Assistant is the parent platform and API target. The separate home-assistant/cli project is related but different: it provides the ha command for Home Assistant Supervisor interaction. Home Assistant Operating System, the Supervisor API proxy add-on, and the Home Assistant developer docs are adjacent because hass-cli can work with supervisor-related commands when configured. ### 来源 - - - - ## 安全说明 没有找到 homeassistant-cli 的匹配本地密钥处理 manifest。Nucleus 软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 URL。 ## Combined YAML source View the package source record on GitHub. [combined/homeassistant-cli.yml](https://github.com/mxcl/pkgdb/blob/main/combined/homeassistant-cli.yml) ## 来源 - pkg.so package database - Geiger risk classifier - curated package history - pkgdb category and tag curation - cross-ecosystem install command graph