openhue

steipete/clawdis

Control Philips Hue lights and scenes via OpenHue CLI.

What is openhue?

OpenHue CLI lets you control Philips Hue lights, rooms, and scenes from the command line. Use it to turn lights on/off, adjust brightness and color temperature, activate scenes, and manage entire rooms via your local Hue Bridge.

Turn lights and rooms on/off
Adjust brightness (0-100) and color temperature (153-500 mirek)
Set colors by name or hex code on color-capable bulbs
Activate pre-defined scenes by room
List and query all lights, rooms, and scenes
Control individual lights or entire rooms at once

How to install openhue

npx skills add https://github.com/steipete/clawdis --skill openhue

Prerequisites

Philips Hue Bridge on local network
OpenHue CLI installed (via brew: openhue/cli/openhue-cli)
Hue Bridge pairing (button press on first run)

Claude Code

Cursor

Windsurf

Cline

How to use openhue

1.Install OpenHue CLI via brew
2.Ensure Hue Bridge is on your local network and powered on
3.Press the button on your Hue Bridge when first running openhue to pair
4.List available lights with: openhue get light
5.Control lights using: openhue set light "Light Name" --on --brightness 50
6.Activate scenes with: openhue set scene "Scene Name" --room "Room Name"

Use cases

Good for

Automate bedtime routines with dim warm lighting
Set work mode with bright cool lights for focus
Activate movie mode with minimal lighting
Create voice-controlled or scheduled lighting scenes
Adjust lighting based on time of day or activity

Who it's for

Home automation enthusiasts with Philips Hue systems
Developers building smart home workflows
Anyone wanting CLI control of Hue lights without mobile app

openhue FAQ

Do I need a Hue Bridge?

Yes, the Hue Bridge must be on your local network. OpenHue communicates with it to control lights.

Can I control non-Hue smart lights?

No, OpenHue only works with Philips Hue devices. Other brands are not supported.

What color formats are supported?

Colors can be set by name (e.g., red, blue) or hex code (e.g., #FF5500). Color control only works on color-capable bulbs, not white-only bulbs.

Can I use this with HomeKit or Shortcuts?

No, use Apple's HomeKit ecosystem for that. OpenHue is a standalone CLI tool for direct Hue Bridge control.

How do I list all available scenes?

Run: openhue get scene to list all scenes available on your Hue Bridge.

Full instructions (SKILL.md)

Source of truth, from steipete/clawdis.

name: openhue description: "Control Philips Hue lights and scenes via the OpenHue CLI." homepage: https://www.openhue.io/cli metadata: { "openclaw": { "emoji": "💡", "requires": { "bins": ["openhue"] }, "install": [ { "id": "brew", "kind": "brew", "formula": "openhue/cli/openhue-cli", "bins": ["openhue"], "label": "Install OpenHue CLI (brew)", }, ], }, }

OpenHue CLI

Use openhue to control Philips Hue lights and scenes via a Hue Bridge.

When to Use

Use when:

"Turn on/off the lights"
"Dim the living room lights"
"Set a scene" or "movie mode"
Controlling specific Hue rooms or zones
Adjusting brightness, color, or color temperature

When NOT to Use

Do not use when:

Non-Hue smart devices (other brands) -> not supported
HomeKit scenes or Shortcuts -> use Apple's ecosystem
TV or entertainment system control
Thermostat or HVAC
Smart plugs (unless Hue smart plugs)

Common Commands

List Resources

openhue get light       # List all lights
openhue get room        # List all rooms
openhue get scene       # List all scenes

Control Lights

# Turn on/off
openhue set light "Bedroom Lamp" --on
openhue set light "Bedroom Lamp" --off

# Brightness (0-100)
openhue set light "Bedroom Lamp" --on --brightness 50

# Color temperature (warm to cool: 153-500 mirek)
openhue set light "Bedroom Lamp" --on --temperature 300

# Color (by name or hex)
openhue set light "Bedroom Lamp" --on --color red
openhue set light "Bedroom Lamp" --on --rgb "#FF5500"

Control Rooms

# Turn off entire room
openhue set room "Bedroom" --off

# Set room brightness
openhue set room "Bedroom" --on --brightness 30

Scenes

# Activate scene
openhue set scene "Relax" --room "Bedroom"
openhue set scene "Concentrate" --room "Office"

Quick Presets

# Bedtime (dim warm)
openhue set room "Bedroom" --on --brightness 20 --temperature 450

# Work mode (bright cool)
openhue set room "Office" --on --brightness 100 --temperature 250

# Movie mode (dim)
openhue set room "Living Room" --on --brightness 10