timvdhoorn

Homey CLI Skill — Development skill for Claude Code

Development community

Claude Code / agent skill for driving Homey Pro via the official homey CLI.

How to install Homey CLI Skill

This entry records only its repository, not the path inside it, so there is no exact command to give. Open timvdhoorn/homey-cli-skill and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Homey CLI Skill does

Claude Code / agent skill for driving Homey Pro via the official homey CLI. Replaces the public Homey MCP and adds full advanced-flow JSON support.

Alternatives in Development

Petdex — A public gallery of animated pets for Codex, Claude Code, DeepSeek Harness, Hermes, OpenCode, Gemini CLI, and 4k ★
MCP Edit — tilth_write replaces the host Edit and Write tools 349 ★
Premiere Pro MCP — Adobe Premiere Pro MCP — independent, local-first server for supported workflows 292 ★

README

homey-cli skill

A Claude Code / agent skill for driving a **Homey Pro** smart-home hub through the official `homey` CLI (`homey api `). Replaces the public `mcp__claude_ai_Homey__*` MCP and adds full advanced-flow JSON support, app inventory, device settings, and ~50 API managers.

Features

📖 Read everything: devices, zones, flows, apps, moods, alarms, insights, system info (~50 managers)
🔍 Discover flow cards per installed app, every trigger / condition / action with full args schema
🧩 Build standard flows: trigger + AND/OR condition groups + then/else actions
🕸️ Build advanced flows: full graph editor with 8 card types (trigger, condition, action, start, delay, all, any, note)
🎛️ Control devices: turn on/off, dim, set thermostat, set lock, set mood, rename, move zones
🚀 Trigger flows on demand, standard and advanced
📦 Manage apps: enable, disable, restart, list versions
🛠️ Raw API escape hatch: POST / PUT / DELETE against any manager endpoint
📜 HomeyScript fallback for logic flows can't express, with a decision tree on when to use
🌐 Token-mode (LAN): bypass cloud and hit the Homey directly over the local network
🗂️ Templates included: 4 flow skeletons + 8 card primitives + 3 HomeyScript starters
✅ 10-point validation checklist before every flow push
🛡️ Guardrails: risk tiers, active-Homey check, broken: false distrust, backup-before-update
🔁 Drop-in MCP replacement: all 19 public mcp__claude_ai_Homey__* tools have a CLI equivalent
💡 Flow suggestions: ask "suggest flows" / "wat kan ik automatiseren" — the agent generates ideas from your device inventory and shows them in a browser picker (filters, status tags, want/maybe/skip/done) or terminal multi-select; agent auto-continues on submit and can build the picked flows next