mirror of
https://github.com/hanzoskill/homey.git
synced 2026-10-30 21:10:06 +00:00
1.4 KiB
1.4 KiB
homeycli
Control Athom Homey devices from the command line via local (LAN/VPN) or cloud APIs.
This tool is designed to be called by an LLM/agent (Skills skill), so it prioritizes:
- machine-readable JSON (
--json) - returning full device state (multi-sensor friendly)
- safe disambiguation (if a query matches >1 device, it errors and returns candidate IDs)
Install
npm install
chmod +x bin/homeycli.js
Auth
Local mode (LAN/VPN):
homeycli auth discover-local --save --pick 1
echo "LOCAL_API_KEY" | homeycli auth set-local --stdin
# or interactive (hidden input): homeycli auth set-local --prompt
Cloud mode (remote/headless):
echo "CLOUD_TOKEN" | homeycli auth set-token --stdin
# or interactive (hidden input): homeycli auth set-token --prompt
Note: the colon-separated triple-part key from the Homey Web App is for local mode only.
Check status:
homeycli auth status --json
Recommended: snapshot
homeycli snapshot --json
homeycli snapshot --json --include-flows
Devices
homeycli devices --json
homeycli devices --match "kitchen" --json
homeycli device "Kitchen Light" values --json
homeycli device <device-id> set dim 0.7 --json
Flows
homeycli flows --json
homeycli flow trigger "Good Night" --json
See the README for more.
For agent integrations, also see: docs/output.md (stable JSON contract).