openhue

Control Philips Hue lights and scenes via the OpenHue CLI.

Updated Nov 17, 2025
One-click install
npx skills add https://github.com/ci/persops --skill openhue-ci
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openhue
Source: https://github.com/ci/persops/tree/main/modules/ai/openhue
Command: npx skills add https://github.com/ci/persops --skill openhue-ci

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables home automation users to control Philips Hue lights and scenes programmatically via the OpenHue CLI, eliminating manual button presses and enabling scripted lighting control.

Core Features & Use Cases

  • Discover and connect Hue Bridges with the CLI (openhue discover).
  • Setup and pair the Bridge (openhue setup).
  • Read current state of lights, rooms, and scenes (openhue get light/room/scene --json).
  • Write state to devices and scenes (openhue set light/scene with on/off, brightness, and color).
  • Use cases include ambient lighting automation, scene changes for entertainment, and remote control via scripts.
  • Notes: You may need to press the Hue Bridge button during setup and specify room names for disambiguation.

Quick Start

Discover and connect to your Hue bridges, then perform a sample control:

  • Discover: openhue discover
  • Setup: openhue setup
  • Example: Turn on the Living Room light: openhue set light "Living Room" --on

Frequently Asked Questions about openhue

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

FAQPage Schema
How do I automate Philips Hue lights via command line?

Automate Philips Hue lights by using the OpenHue CLI to control state, brightness, color, and scenes programmatically. This eliminates manual button presses and enables scripted lighting control for your home automation workflows.

How do I connect to a Hue Bridge from a terminal?

Connect to a Hue Bridge from a terminal by running 'openhue discover' to find it, followed by 'openhue setup' to pair. You will need to physically press the Hue Bridge button during the setup process to authenticate the connection.

Can I adjust Hue light brightness and color using a CLI tool?

Adjust Hue light brightness and color using the 'openhue set light' command with parameters for on/off state, brightness, and color. You can specify the target light by name, such as 'Living Room', to apply the desired state changes.

Do I need to install anything specific to control Hue scenes from scripts?

You need the OpenHue CLI installed and accessible in your system PATH to control Hue scenes from scripts. Additionally, a reachable Hue Bridge on your network is required for executing any discovery, setup, or state read and write operations.

How do I check the current state of my Hue lights and rooms?

Check the current state of Hue lights, rooms, and scenes by running 'openhue get light/room/scene --json'. This command outputs the current device states in JSON format, allowing you to read configurations before applying any write operations.

What should I do if the CLI cannot identify which light to control?

If the CLI cannot identify which light to control, specify the exact room name for disambiguation. This ensures the OpenHue CLI targets the correct device when executing state changes across your home automation network.