f210510276
Skills can now declare runtime prerequisites (env vars, CLI binaries) via YAML frontmatter. Skills with unmet prerequisites are excluded from the system prompt so the agent never claims capabilities it can't deliver, and skill_view() warns the agent about what's missing. Three layers of defense: - build_skills_system_prompt() filters out unavailable skills - _find_all_skills() flags unmet prerequisites in metadata - skill_view() returns prerequisites_warning with actionable details Tagged 12 bundled skills that have hard runtime dependencies: gif-search (TENOR_API_KEY), notion (NOTION_API_KEY), himalaya, imessage, apple-notes, apple-reminders, openhue, duckduckgo-search, codebase-inspection, blogwatcher, songsee, mcporter. Closes #658 Fixes #630
108 lines
2.7 KiB
Markdown
108 lines
2.7 KiB
Markdown
---
|
|
name: openhue
|
|
description: Control Philips Hue lights, rooms, and scenes via the OpenHue CLI. Turn lights on/off, adjust brightness, color, color temperature, and activate scenes.
|
|
version: 1.0.0
|
|
author: community
|
|
license: MIT
|
|
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)
|
|
curl -sL https://github.com/openhue/openhue-cli/releases/latest/download/openhue-linux-amd64 -o ~/.local/bin/openhue && chmod +x ~/.local/bin/openhue
|
|
|
|
# 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)
|