2026 03 03

[Claude Code] Home Assistant Skill Built¶

Skill: skills/home-assistant/: Greg can now control HA via Discord
Helper: skills/home-assistant/scripts/ha_helper.py (stdlib only, no deps)
Config: forge/.env: HA_URL + HA_TOKEN (gitignored via new root .gitignore)
Supports: ping, state, states, lights, on, off, toggle, call (any service)
.env auto-detected from Docker container path OR host path
TODO: Justin needs to paste actual HA long-lived token into .env
Go to HA → Profile → Long-Lived Access Tokens → Create token → paste into .env
Local HA: http://192.168.86.70:8123 | Cloud: Nabu Casa URL in .env

Token confirmed working, 42 lights detected & controllable ✅
Test commands successful:
Turned off office light strips ✅
Set office lights to yellow (RGB) ✅
Activated gaming scene ✅
FastAPI wrapper built and documented:
6 REST endpoints: ping, lights, state, states, command, call
Port 7357, CORS enabled, request logging
Full docs at /skills/home-assistant/api/ with README, QUICKSTART, ENDPOINTS_REFERENCE
Example client + requirements.txt included
All tests passing ✅
Claude Code integration ready, can call API from scripts/automations
HA Scenes discovered: Gaming Scene, Work Scene

FastAPI server built at skills/home-assistant/api/server.py
Venv installed at skills/home-assistant/.venv/ (fastapi + uvicorn)
Tested and working:
ping → {"status":"ok","message":"API running."}
lights → 40 lights enumerated (all off)
Start on host: skills/home-assistant/.venv/bin/python3 skills/home-assistant/api/server.py
Start in Docker: pip install fastapi uvicorn && python3 skills/home-assistant/api/server.py
Swagger UI: http://localhost:7357/docs
Greg can use ha_helper.py (stdlib, no deps) for direct CLI calls
TODO: systemd service if persistent server is wanted