openhue · nousresearch — Claude Code skill: what it does, how to install
Controls Philips Hue lights, rooms, and scenes via OpenHue CLI. Useful for adjusting lighting and triggering presets directly from the terminal.
MIT 288 installs ★ 265,216 updated 2026-10-25
npx skills add NousResearch/hermes-agent --skill openhue -a claude-codeWhat openhue does
This skill instructs the agent on interacting with the openhue CLI tool. It allows toggling fixtures, updating brightness levels from 0 to 100, and activating saved room scenes. Light and room names are case-sensitive. The agent checks exact names first using openhue get light or openhue get room before applying changes.
Running these commands requires the standalone openhue binary and a physical Hue Bridge on the same local network. macOS users can install it via brew install openhue/cli/openhue-cli, while Linux environments use the pre-built release tarballs.
Initial setup requires pressing the pair button on your Hue Bridge. Without this authorization step on local hardware, the CLI fails to connect.
What it helps with
- turn off all lights across specific rooms
- adjust brightness and color temperature values
- trigger configured lighting scenes like bedtime modes
- list available Philips Hue bulbs, rooms, and groups
Example prompts for the agent
- Turn off all lights in the Bedroom
- Set Bedroom Lamp brightness to 50 with a warm temperature
- Activate the Relax scene in the Living Room
How to install openhue
1Skills CLI (Vercel)
npx skills add NousResearch/hermes-agent --skill openhue -a claude-code2Manually: put the files in place
~/.claude/skills/openhue/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/openhue/
1Skills CLI (Vercel)
npx skills add NousResearch/hermes-agent --skill openhue -a codex2Manually: put the files in place
.agents/skills/openhue/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add NousResearch/hermes-agent --skill openhue -a cursor2Manually: put the files in place
.cursor/skills/openhue/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install NousResearch/hermes-agent optional-skills/smart-home/openhue2Manually: put the files in place
.github/skills/openhue/SKILL.md1Skills CLI (Vercel)
npx skills add NousResearch/hermes-agent --skill openhue -a gemini-cli2Platform CLI
gemini skills install https://github.com/NousResearch/hermes-agent --path optional-skills/smart-home/openhueManually: put the files in place
.devin/skills/openhue/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add NousResearch/hermes-agent --skill openhue -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about openhue
How to install openhue in Claude Code?
Run npx skills add NousResearch/hermes-agent --skill openhue -a claude-code.
What does openhue do?
It interfaces with your Philips Hue Bridge through the command line to adjust bulb states and trigger room scenes.
What is required before using openhue?
You need the openhue binary installed and the bridge reachable on your local network. You must also physically press the button on the Hue Bridge during the first run to authorize the connection.
Source text
SKILL.md · MIT
---
name: openhue
description: "Control Philips Hue lights, scenes, rooms via OpenHue CLI."
version: 1.0.1
author: community
license: MIT
platforms: [linux, macos, windows]
metadata:
hermes:
tags: [Smart-Home, Hue, Lights, IoT, Automation]
homepage: https://www.openhue.io/cli
prerequisites:
commands: [openhue]
---
# OpenHue CLI
Control Philips Hue lights and scenes via a Hue Bridge from the terminal.
## Prerequisites
```bash
# Linux (pre-built binary — releases ship tarballs, not bare binaries)
curl -sL "https://github.com/openhue/openhue-cli/releases/latest/download/openhue_Linux_x86_64.tar.gz" \
| tar -xz -C ~/.hermes/cache/scratch openhue \
&& install -m 0755 ~/.hermes/cache/scratch/openhue ~/.local/bin/openhue
# (use openhue_Linux_arm64.tar.gz on ARM64)
# macOS
brew install openhue/cli/openhue-cli
```
First run requires pressing the button on your Hue Bridge to pair. The bridge must be on the same local network.
## When to Use
- "Turn on/off the lights"
- "Dim the living room lights"
- "Set a scene" or "movie mode"
- Controlling specific Hue rooms, zones, or individual bulbs
- Adjusting brightness, color, or color temperature
## Common Commands
### List Resources
```bash
openhue get light # List all lights
openhue get room # List all rooms
openhue get scene # List all scenes
```
### Control Lights
```bash
# 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
```bash
# Turn off entire room
openhue set room "Bedroom" --off
# Set room brightness
openhue set room "Bedroom" --on --brightness 30
```
### Scenes
```bash
openhue set scene "Relax" --room "Bedroom"
openhue set scene "Concentrate" --room "Office"
```
## Quick Presets
```bash
# 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
# Everything off
openhue set room "Bedroom" --off
openhue set room "Office" --off
openhue set room "Living Room" --off
```
## Notes
- Bridge must be on the same local network as the machine running Hermes
- First run requires physically pressing the button on the Hue Bridge to authorize
- Colors only work on color-capable bulbs (not white-only models)
- Light and room names are case-sensitive — use `openhue get light` to check exact names
- Works great with cron jobs for scheduled lighting (e.g. dim at bedtime, bright at wake)
© community · MIT · NousResearch/hermes-agent
Similar skills
All skills for Automation and no-code: n8n, Zapier, Make →openhue by other authors comes first.