菜单
Control Home Assistant media players with hass-cli: play/pause/stop, next/previous track, set volume, mute, select source, and play media. Use for 'pause the TV', 'set volume to 30%', 'play music in the kitchen', 'switch input to HDMI2' requests. All control goes through service call.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Shared foundation for all hass-cli skills. Read this FIRST. Covers connecting to a Home Assistant instance (HASS_SERVER + HASS_TOKEN long-lived token), the unified REST+WebSocket transport facade, output formats (table/json/yaml/ndjson), the raw passthrough escape hatches (raw api / raw ws), and the auth-error recovery table. Use whenever the user mentions Home Assistant, hass-cli, controlling smart-home entities, calling services, automations, or any HA REST/WebSocket API task.
Manage Home Assistant radio gateways and their networks with hass-cli: Zigbee (ZHA), Z-Wave JS, Matter, and Thread/OTBR. Use to pair/remove a Zigbee device, permit join, add/exclude a Z-Wave node, read network status/topology, back up a Zigbee/Z-Wave coordinator, commission a Matter device, or inspect Thread datasets. The gateway integration's own lifecycle (add/reload/delete) lives in ha-integrations; the devices it exposes live in ha-registry.
Manage Home Assistant integrations (config entries) and device discovery with hass-cli: list integrations and their state, reload, enable/disable, delete, update entry options, and inspect discovered/in-progress config flows. Use for 'list my integrations', 'reload the X integration', 'why is this integration failing', 'disable this entry', 'what was discovered on my network' requests.
Inspect and configure Home Assistant's Energy dashboard with hass-cli: read energy preferences (grid/solar/battery/gas/water sources and devices), validate the energy config, and pull consumption statistics. Use for 'show my energy setup', 'how much solar did I produce', 'what's using the most power' questions. Energy data is WebSocket + statistics-based.
Read Home Assistant entity states and recent history with hass-cli. Use to answer 'is the light on', 'what's the temperature', 'list all sensors', 'what changed recently', or to inspect any entity's current state and attributes. Covers state list/get, table shaping (--columns/--sort-by), and history/logbook reads.
Manage Home Assistant add-ons and the Supervisor/OS layer with hass-cli. Use to list/install/uninstall/update/start/stop/restart add-ons, browse the add-on store, read add-on logs, or check Core/Supervisor/OS info. Works through Core's supervisor/api WebSocket proxy with a regular admin token (no separate supervisor token needed).
| name | ha-media |
| version | 0.1.0 |
| description | Control Home Assistant media players with hass-cli: play/pause/stop, next/previous track, set volume, mute, select source, and play media. Use for 'pause the TV', 'set volume to 30%', 'play music in the kitchen', 'switch input to HDMI2' requests. All control goes through service call. |
| metadata | {"requires":{"bins":["hass-cli"]},"cliHelp":"hass-cli service call --help"} |
Media players (speakers, TVs, receivers). Prerequisites:
../ha-shared/SKILL.md, ../ha-services/SKILL.md.
hass-cli service call media_player.media_play --arguments entity_id=media_player.kitchen
hass-cli service call media_player.media_pause --arguments entity_id=media_player.kitchen
hass-cli service call media_player.media_play_pause --arguments entity_id=media_player.kitchen
hass-cli service call media_player.media_stop --arguments entity_id=media_player.kitchen
hass-cli service call media_player.media_next_track --arguments entity_id=media_player.kitchen
hass-cli service call media_player.media_previous_track --arguments entity_id=media_player.kitchen
# volume_level is 0.0 .. 1.0
hass-cli service call media_player.volume_set --data '{"entity_id":"media_player.kitchen","volume_level":0.3}'
hass-cli service call media_player.volume_mute --data '{"entity_id":"media_player.kitchen","is_volume_muted":true}'
hass-cli service call media_player.turn_off --arguments entity_id=media_player.kitchen
hass-cli state get media_player.kitchen -o json # attributes.source_list / sound_mode_list
hass-cli service call media_player.select_source --data '{"entity_id":"media_player.tv","source":"HDMI 2"}'
hass-cli service call media_player.play_media --data '{"entity_id":"media_player.kitchen","media_content_type":"music","media_content_id":"http://.../stream.mp3"}'
Browse available content with the WS API when needed:
hass-cli raw ws media_player/browse_media --data '{"entity_id":"media_player.kitchen"}'.