openhue

Control Philips Hue lights and scenes via OpenHue CLI commands.

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/Polealpha/XINNIAN_PI --skill openhue-polealpha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openhue
Source: https://github.com/Polealpha/XINNIAN_PI/tree/main/app%20windows/vendor/openclaw-runtime/skills/openhue
Command: npx skills add https://github.com/Polealpha/XINNIAN_PI --skill openhue-polealpha

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing Philips Hue lights and scenes through the CLI is difficult because it requires learning device IDs and repetitive manual steps in the Hue app.

Core Features & Use Cases

  • Bridge discovery and guided setup: Find Hue Bridges automatically and complete pairing with the bridge.
  • Read light/room/scene state as JSON: Inspect what lights, rooms, and scenes exist and how they are configured.
  • Set light state, brightness, color, and scenes: Turn on/off lights, adjust brightness, set RGB colors, and trigger a scene for instant ambiance changes.

Example use case: When preparing a “focus” or “relax” environment, switch to a saved Hue scene and then fine-tune a specific light’s brightness and color.

Quick Start

Use indented instruction: Run "openhue discover" to find your Hue Bridge.

Frequently Asked Questions about openhue

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I control Philips Hue lights from the command line?

To control Philips Hue lights via CLI, you issue Hue Bridge commands through the OpenHue interface. This enables repeatable light state changes across lights, rooms, and scenes directly from your terminal.

How do I discover and set up a Hue Bridge for terminal access?

You can discover a Hue Bridge by running the discover command in your terminal. After finding the bridge, complete the guided setup and pairing process to enable CLI control of your lighting system.

Can I query Hue light, room, and scene states as JSON?

Yes, you can query Hue light, room, and scene states as JSON. This allows you to inspect existing configurations and determine how your lights and rooms are currently set up before applying changes.

How do I set brightness, RGB colors, and activate scenes for Hue lights?

You set brightness, RGB colors, and activate scenes by sending specific state-setting commands to the Hue Bridge. This enables instant ambiance changes like triggering a saved scene or fine-tuning a specific light's color.

Do I need a reachable Hue Bridge to use CLI lighting control?

Yes, a reachable Hue Bridge on your network is required. You must also complete the initial setup and pairing process to authorize the CLI before executing any discovery, querying, or state-setting commands.

What is the best way to automate repetitive Hue lighting changes?

The best way to automate repetitive Hue lighting changes is by using CLI commands within your home automation workflows. This allows you to script repeatable light state changes, such as switching to a focus scene and adjusting brightness.