Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add NousResearch/hermes-agent --skill openhue -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/openhue/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/openhue/

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.

From the same set61

The whole set →
blogwatcher Connects the blogwatcher-cli feed manager to your agent for RSS and Atom monitoring. Tracks new posts and maintains read status across blogs. CX Codex +1 339installs pretext A skill for browser demos built on @chenglou/pretext: text wraps around shapes, splits into graphemes and gets measured through canvas without a page reflow. CX Codex +1 320installs docx A skill for creating, reading, editing, and templating Word .docx files via Python CLI scripts. Helpful when automating reports, comments, and tracked changes. CX Codex +1 310installs grounded-citations grounded-citations grounds LLM responses in verifiable sources using Perplexity-style bracketed citations and strict quotation checks via an external ledger. CX Codex +1 307installs pdf A skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode that handles PDF files end to end: build from specs, extract tables, fill forms, merge pages, encrypt. CX Codex +1 283installs polymarket Pulls Polymarket data through its public REST APIs: markets, prices, orderbooks and history. Use it when you want the odds the market gives some event. CX Codex +1 282installs inspecting-hermes-desktop-dom The inspecting-hermes-desktop-dom skill reads the live DOM, computed CSS, and console output from Hermes Desktop over CDP. Use it to check whether a UI change took effect or identify the style rule in control. CX Codex +1 263installs github Routes GitHub workflows through the gh CLI, covering issues, PR lifecycles, code reviews, and repo tasks. Designed for tracking delivery straight from the terminal. CX Codex +1 245installs

Project sponsors

Companies that keep this analytics open