A simple CLI to control your Philips Hue lights.

go install github.com/LarsEckart/huey@latest

Or download a binary from the releases page.

1. Run huey
2. huey automatically looks for your Hue bridge via https://discovery.meethue.com/
3. If multiple bridges are found, choose one; if none are found, enter the bridge IP manually
4. Press the link button on your Hue bridge
5. Press Enter

That's it! Your credentials are saved to ~/.config/huey/config.json.

Run without arguments to open the interactive interface:

huey

Navigation:

• Tab or l/h — Switch between Lights, Groups, and Scenes tabs
• ↑/↓ or j/k — Navigate list
• Space — Toggle selected light/group, or activate scene
• r — Rename selected item (Lights/Groups only)
• q — Quit

Groups tab only:

• a — Add new group (room or zone)
• i — Show group info (lights in group)
• d — Delete group (with confirmation)

Scenes tab only:

• a — Add new scene (captures current light states)

List all lights:

huey lights

Show light details:

huey light 1

Control a light:

huey light 1 --on
huey light 1 --off
huey light 1 --toggle

Rename a light:

huey light 1 --name "Desk Lamp"

List all groups:

huey groups

Show group details:

huey group 1

Control a group:

huey group 1 --on
huey group 1 --off
huey group 1 --toggle

Rename a group:

huey group 1 --name "Living Room"

Delete a group:

huey group 1 --delete

Create a group:

huey group-create --name "My Zone" --type zone --lights 1,2,3
huey group-create --name "My Room" --type room

List all scenes:

huey scenes

Activate a scene:

huey scene TqkSoVMtx4juUbU

Create a scene (captures current light states):

huey scene-create --name "Focus" --group 85

huey tries to detect your bridge automatically using https://discovery.meethue.com.

If automatic discovery fails:

• Check your router's connected devices
• Use the Hue app: Settings → Hue Bridges → (i) icon
• Visit https://discovery.meethue.com in your browser