Dbochman/hue-lights

Hue Lights Control

Control Philips Hue lights via the hue CLI. Two bridges (Crosstown and Cabin) with credentials managed via 1Password. The CLI auto-detects local vs remote access — works from any device on the tailnet.

Available Commands

Show room status

hue status

Turn a room on or off

hue on <room>
hue on <room> 50        # on at 50% brightness
hue off <room>

Set brightness (0-100%)

hue bri <room> 75

Set color

hue color <room> warm       # warm white
hue color <room> cool       # cool white
hue color <room> daylight   # daylight
hue color <room> red        # named colors: red, orange, yellow, green, blue, purple, pink

Activate a scene

hue scene <room> <scene-name>

All lights on/off

hue all-on
hue all-off

List individual lights

hue lights

Rooms

Crosstown residence (9 rooms)

• Entryway (1 light)
• Kitchen (1 light)
• Living room (9 lights)
• Bedroom (5 lights)
• Office (1 light)
• Movie Room (2 lights)
• Cat Room (3 lights)
• Downstairs (3 lights)
• Master Bath (3 lights)

Cabin (8 rooms)

• Kitchen (2 lights)
• Living room (3 lights)
• Bathroom (4 lights)
• Hallway (1 light)
• Bedroom (4 lights)
• Office (3 lights)
• Solarium (3 lights)
• Staircase (1 light)

Room names are fuzzy-matched — use any substring (e.g. "bed" for Bedroom, "living" for Living room).

Home Disambiguation

There are two homes with overlapping room names. You must always select the correct bridge.

| Home | Location | Flag | Unique rooms | |------|----------|------|-------------| | Crosstown | Boston (Crosstown residence) | --crosstown (default) | Entryway, Movie Room, Cat Room, Downstairs, Master Bath | | Cabin | Philly | --cabin | Bathroom, Hallway, Solarium, Staircase |

Shared room names (exist in both homes): Kitchen, Living room, Bedroom, Office

When the user mentions a shared room name, determine the correct home from context:

• If they say "cabin kitchen" or "philly kitchen" → hue --cabin on kitchen
• If they say "crosstown kitchen" or "boston kitchen" → hue on kitchen (or hue --crosstown on kitchen)
• If a unique room is mentioned (e.g. "solarium", "movie room"), the home is unambiguous
• If unclear, ask which home they mean — don't guess

When running routines or multi-room commands, make sure every command targets the same bridge.

Connection

The CLI tries the local bridge first (LAN), then falls back to the Hue Cloud API (remote). Override with HUE_MODE=local or HUE_MODE=remote.

Both bridges have remote API access. Use --crosstown (default) or --cabin to select, or HUE_BRIDGE=cabin.

hue --cabin status          # Cabin (Philly) lights
hue --crosstown on kitchen  # Crosstown (Boston) kitchen
hue status                  # defaults to Crosstown

1Password items:

• "Philips Hue Bridge - Crosstown" (Private vault) — local + remote credentials
• "Philips Hue Bridge - Cabin" (Private vault) — local credentials only

Notes

• CRITICAL: Only use the hue CLI at /opt/homebrew/bin/hue — it is already paired, configured, and has credentials for both bridges. Do NOT use openhue, do NOT install any other Hue CLI (brew install anything), do NOT use raw Hue REST API curl calls, and do NOT attempt bridge pairing or setup. Everything is already working. Just run hue commands.
• Always run hue status first to show the user current state before making changes
• Brightness is 0-100 (percent)
• Some lights may show as UNREACHABLE if powered off at the switch
• When asked to set a mood, combine brightness and color (e.g. hue color bedroom warm then hue bri bedroom 30)