Ops Home

/ops:ops-home — Smart Home Command Center

Control your smart home from Claude Code via Homey Pro (local API preferred, Athom cloud fallback).

What it does

• Device status — lights, locks, sensors, climate, alarms across all zones
• Run flows / scenes — fuzzy-match by name, trigger immediately
• Energy — current draw, today's kWh, anomaly detection vs 7-day baseline
• Climate — per-zone temp/humidity, set target temp
• Presence — who is home
• Security — active alarms, arm/disarm modes

Setup

Run /ops:setup --section home and provide:

• HOMEY_LOCAL_URL — your Homey Pro's LAN IP (e.g. https://192.168.1.42)
• HOMEY_LOCAL_TOKEN — Personal Access Token from https://my.homey.app/manager/tokens
• HOMEY_CLOUD_TOKEN — (optional) Athom OAuth for off-LAN fallback
• HOMEY_ID — (optional) hub ID, only needed for cloud API

Credentials are stored in ~/.claude/plugins/data/ops-ops-marketplace/preferences.json under home_automation.*.

Usage

Command	What it does
/ops:ops-home	Status dashboard (default)
/ops:ops-home devices	List devices grouped by zone
/ops:ops-home devices lights --off	Bulk-toggle lights off
/ops:ops-home flow good-night	Trigger the "good night" flow
/ops:ops-home energy	Live power draw + anomalies
/ops:ops-home climate living-room 21	Set zone target temp
/ops:ops-home presence	Who is home
/ops:ops-home alarm	Active alarms + arm/disarm
/ops:ops-home setup	(Re)configure credentials

Cross-channel integration

• Critical alarms (smoke/leak/security) pipe to /ops:ops-comms for WhatsApp/Telegram alerts.
• Energy spikes surface in /ops:ops-fires as P0/P1/P2 incidents.
• Presence appears in /ops:ops-go morning briefing.
• /ops:ops-yolo COO agent checks alarm-armed state and device health.

API surface

Uses Homey local Web API v3:

• GET /api/manager/devices/device — list devices
• PUT /api/manager/devices/device/{id}/capability/{capability} — set capability
• GET /api/manager/flow/flow + POST .../trigger — list/run flows
• GET /api/manager/energy/live — live power
• GET /api/manager/alarms/alarm — active alarms

Docs: https://apps.developer.homey.app/the-basics/web-api

Requirements

• Homey Pro (2023 model or newer recommended)
• Same LAN as the machine running Claude Code (or cloud token for remote)
• Personal Access Token with at least homey.device.readwrite + homey.flow.readwrite scopes