菜单
Control Home Assistant smart home devices, run automations, and manage scenes. Use when controlling lights, switches, climate, scenes, scripts, or any HA entity.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Diet tracking — logging meals, calories/macros, weigh-ins, daily summaries, weekly reports. Use when user mentions food, weight, calories, macros, diet, or asks about their food diary.
Stock watchlist management — add, remove, list stocks and get performance summaries. Use when user wants to track stocks, check prices, or manage their watchlist.
Google Workspace: Gmail, Calendar, Drive, Contacts, Sheets, Docs. Use when the user asks about email, calendar events, files on Drive, contacts, spreadsheets, or documents.
Real browser automation via Playwright. Use when a real browser session is needed — blocked sites (403, CAPTCHA), JS-heavy pages, shopping flows, multi-step navigation, or form filling.
GitHub operations: manage repos, issues, PRs, CI checks, gists, and releases via gh CLI. Use when user asks about GitHub repos, issues, pull requests, or CI.
Create new skills when a task pattern has no existing skill. Use when building a reusable solution the agent can apply in future interactions.
| name | home-assistant |
| description | Control Home Assistant smart home devices, run automations, and manage scenes. Use when controlling lights, switches, climate, scenes, scripts, or any HA entity. |
| version | 1.0.0 |
| requires | {"bins":["jq","curl"]} |
| always | false |
Control your smart home via Home Assistant's REST API.
Create ~/.janus/home-assistant/config.json (restrict permissions — contains secret token):
mkdir -p ~/.janus/home-assistant
cat > ~/.janus/home-assistant/config.json << 'EOF'
{
"url": "https://your-ha-instance.duckdns.org",
"token": "your-long-lived-access-token"
}
EOF
chmod 600 ~/.janus/home-assistant/config.json
export HA_URL="http://homeassistant.local:8123"
export HA_TOKEN="your-long-lived-access-token"
Use scripts/ha.sh via exec for all HA operations:
# Test connection
ha.sh info
# List entities
ha.sh list all # all entities
ha.sh list lights # just lights
ha.sh list switch # just switches
# Search entities
ha.sh search kitchen # find entities by name
# Get/set state
ha.sh state light.living_room
ha.sh states light.living_room # full details with attributes
ha.sh on light.living_room
ha.sh on light.living_room 200 # with brightness (0-255)
ha.sh off light.living_room
ha.sh toggle switch.fan
# Scenes & scripts
ha.sh scene movie_night
ha.sh script goodnight
# Climate
ha.sh climate climate.thermostat 22
# Call any service
ha.sh call light turn_on '{"entity_id":"light.room","brightness":200}'
| Domain | Service | Example entity_id |
|---|---|---|
light | turn_on, turn_off, toggle | light.kitchen |
switch | turn_on, turn_off, toggle | switch.fan |
climate | set_temperature, set_hvac_mode | climate.thermostat |
cover | open_cover, close_cover, stop_cover | cover.garage |
media_player | play_media, media_pause, volume_set | media_player.tv |
scene | turn_on | scene.relax |
script | turn_on | script.welcome_home |
automation | trigger, turn_on, turn_off | automation.sunrise |
For advanced usage, see references/api.md.