Agent skill · software engineering · sundial-org
homey-cli
Control Homey home automation hub via CLI. Use when you need to control smart home devices (lights, thermostats, sockets, etc.), check device status, list zones, trigger flows, or perform any Homey automation tasks. Supports on/off, dimming, color changes, temperature control, and device inspection. Safe, capability-allowlisted operations only.
Why this skill is useful
Adds executable scripts for controlling Homey devices and managing flows that the AI wouldn't generate on its own.
What it needs
Requires npm installed locally. Requires homey account access. About 2k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
Homey CLI Safe, agent-friendly CLI for controlling Homey home automation hubs. What This Skill Provides Device control: Turn devices on/off, dim lights, change colors, set temperatures Device inspection: List devices, check status, read capabilities Zone management: List zones and devices per zone Flow control: List and trigger flows Inventory: Get complete hub overview Setup 1. Install Dependencies 2. Create Homey App Credentials 1. Go to https://tools.developer.homey.app/tools/app 2. Create a new app with: Callback URL: http://localhost:8787/callback Note your Client ID and Client Secret 3. Configure Environment Create .env file: 4. Login Follow the OAuth flow in your browser. Tokens are stored in ~/.config/homey-cli/. Usage List Homeys Select Active Homey Device Operations Flow Operations Complete Inventory Safety Model Write operations are capability-allowlisted for safety: Default allowed: onoff, dim, lighthue, lightsaturation, lighttemperature, targettemperature Override via: export HOMEYCLIALLOWEDCAPABILITIES=onoff,dim,targettemperature Destructive operations (delete devices, modify flows, change app settings) are not supported. Common Queries When users ask: "Turn on the kitchen lights" → List devices, find match, use devices on <deviceId> "Dim living room to 50%" → Find device, use devices dim <deviceId> 0.5 "What's the temperature in the bedroom?" → Find device, use devices read <deviceId> measuretemperature "List all my lights" → Use devices list --json and filter by class/capabilities Configuration Storage Tokens: ~/.config/homey-cli/credentials.json Active Homey: ~/.config/homey-cli/config.json Troubleshooting Auth errors: Re-run bash run.sh auth login Device not found: Check device name/ID with bash run.sh devices list Capability not allowed: Add to HOMEYCLIALLOWEDCAPABILITIES or check if it's a read-only capability
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/homey-cli