# Openhue

Control Philips Hue lights via OpenHue CLI + Hue Bridge API

- Repository: https://github.com/taracodlabs/aiden (868 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-10-19
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add taracodlabs/aiden --skill openhue -g -a claude-code -y`
Codex: `npx skills add taracodlabs/aiden --skill openhue -g -a codex -y`
Cursor: `npx skills add taracodlabs/aiden --skill openhue -g -a cursor -y`
Gemini CLI: `npx skills add taracodlabs/aiden --skill openhue -g -a gemini-cli -y`

## Description

Control Philips Hue lights via OpenHue CLI + Hue Bridge API

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Philips Hue Smart Light Control

Control Philips Hue lights using the OpenHue CLI or the local Hue Bridge REST API. Works entirely on your local network, no cloud required.

## When to Use

- User wants to turn lights on or off
- User wants to change light color or brightness
- User wants to activate a Hue scene
- User wants to list all lights and their current state
- User wants to set up automation rules for lights

## How to Use

### 1. Install OpenHue CLI

```powershell
# Install via winget
winget install openhue.cli

# Or via npm
npm install -g openhue-cli

# Verify
openhue --version
```

### 2. First-time setup, discover and pair with Bridge

```powershell
# Discover the Hue Bridge on your network
openhue discover

# Pair (press the button on the Bridge within 30 seconds, then run)
openhue pair --host 192.168.1.x   # use IP from discover output

# Save credentials
openhue configure --host 192.168.1.x --api-key YOUR_API_KEY
```

### 3. List all lights

```powershell
openhue get lights
```

### 4. Turn lights on and off

```powershell
# Turn specific light on/off (by ID or name)
openhue set light "Living Room 1" --on true
openhue set light "Living Room 1" --on false

# Turn all lights off
openhue set lights --on false
```

### 5. Change brightness and color

```powershell
# Brightness 0-100
openhue set light "Desk Lamp" --brightness 70

# Set color by hue/saturation (hue 0-360, saturation 0-100)
openhue set light "Desk Lamp" --hue 240 --saturation 80 --brightness 80

# Set color temperature in Kelvin (2000K warm to 6500K cool)
openhue set light "Desk Lamp" --color-temp 3000
```

### 6. Activate a scene

```powershell
# List available scenes
openhue get scenes

# Activate a scene in a room
openhue set scene "Relax" --room "Living Room"
```

### 7. Use the Hue local REST API directly

```powershell
$bridge  = "192.168.1.x"
$apiKey  = $env:HUE_API_KEY
$baseUrl = "https://$bridge/clip/v2"
$headers = @{ "hue-application-key" = $apiKey }

The rest: https://github.com/taracodlabs/aiden/blob/HEAD/skills/openhue/SKILL.md