itsyhome

A command-line tool to control your HomeKit devices through the Itsyhome macOS app.

Install

brew install nickustinov/tap/itsyhome

Or build from source:

go install github.com/nickustinov/itsyhome-cli@latest

Prerequisites

• Itsyhome macOS app with Pro subscription
• Webhooks/CLI server enabled in Settings → Webhooks/CLI

Usage

Control commands

itsyhome toggle Office/Spotlights
itsyhome on Kitchen/Light
itsyhome off Bedroom/Lamp
itsyhome brightness 50 Office/Lamp
itsyhome position 75 "Living Room/Blinds"
itsyhome speed 50 Bedroom/Ceiling Fan
itsyhome temp 22 Hallway/Thermostat
itsyhome color FF6600 Bedroom/Light
itsyhome scene Goodnight
itsyhome lock "Front Door"
itsyhome unlock "Front Door"
itsyhome open Garage/Door
itsyhome close Bedroom/Blinds
itsyhome toggle "group.All Lights"            # Control a global group
itsyhome toggle "Office/group.All Lights"    # Control a room-scoped group
itsyhome off "group.Office Lights"

Query commands

itsyhome status                  # Home summary
itsyhome status Office           # Device states for a room
itsyhome status "Living Room"    # Use quotes for spaces
itsyhome list rooms              # List all rooms
itsyhome list devices            # List all devices
itsyhome list devices Office     # List devices in a room
itsyhome list scenes             # List all scenes
itsyhome list groups             # List all groups
itsyhome info Office/Lamp        # Device info with state
itsyhome info "Living Room"      # All devices in a room
itsyhome info "group.All Lights"         # Global group info
itsyhome info "Office/group.All Lights" # Room-scoped group info

Example output

$ itsyhome status Office
Device         | State | Value
---------------|-------|------
Office AC      | on    | 22.5°
Spotlights     | on    | 80%
Blinds         | off   | —

$ itsyhome list devices
Device     | Type       | Room       | Status
-----------|------------|------------|------
Lamp       | light      | Office     | ok
AC Unit    | thermostat | Bedroom    | ok
Blinds     | blind      | Living Room| unreachable

$ itsyhome info Office/Lamp
Property   | Value
-----------|------
Name       | Lamp
Type       | light
Room       | Office
Status     | reachable
brightness | 80
on         | true

JSON output

Add --json to any command for machine-readable output:

itsyhome status --json
itsyhome list devices --json
itsyhome info Office/Lamp --json

Configuration

itsyhome config                        # Show current config
itsyhome config set --host 192.168.1.5 # Connect to remote Mac
itsyhome config set --port 9000        # Use custom port

Config file: ~/.config/itsyhome/config.json

Default: localhost:8423

Shell completions

itsyhome completion bash > /etc/bash_completion.d/itsyhome
itsyhome completion zsh > "${fpath[1]}/_itsyhome"
itsyhome completion fish > ~/.config/fish/completions/itsyhome.fish

Target formats

API reference

The CLI communicates with the Itsyhome webhook server over HTTP.

Control endpoints

GET /<action>/<target>
GET /<action>/<value>/<target>

Query endpoints

Response format

Success:

{"status": "success"}

Error:

{"status": "error", "message": "device not found"}

HTTP 403 when Pro is not active.

License

MIT License © 2026 Nick Ustinov