# Send Philips Hue Thinking Indicator to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "philips-hue-thinking",
    "name": "Philips Hue Thinking Indicator",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/JesseRod329/philips-hue-thinking",
    "canonicalUrl": "https://clawhub.ai/JesseRod329/philips-hue-thinking",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/philips-hue-thinking",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=philips-hue-thinking",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "hue-hooks.sh",
      "README.md",
      "package.json",
      "SKILL.md",
      "quick-setup.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "philips-hue-thinking",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T20:31:09.317Z",
      "expiresAt": "2026-05-07T20:31:09.317Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=philips-hue-thinking",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=philips-hue-thinking",
        "contentDisposition": "attachment; filename=\"philips-hue-thinking-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "philips-hue-thinking"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/philips-hue-thinking"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/philips-hue-thinking",
    "downloadUrl": "https://openagent3.xyz/downloads/philips-hue-thinking",
    "agentUrl": "https://openagent3.xyz/skills/philips-hue-thinking/agent",
    "manifestUrl": "https://openagent3.xyz/skills/philips-hue-thinking/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/philips-hue-thinking/agent.md"
  }
}
```
## Documentation

### Philips Hue Thinking Indicator

Visual AI activity indicator — Connect your AI assistant's work status to your physical environment through Philips Hue smart lights.

### What It Does

Turns a Philips Hue light into an AI activity indicator:

Light StateMeaning🟢 GreenReady / Done / Idle🔴 Pulsing RedAI is thinking, analyzing, or planning🔴 Solid RedAI is actively building/working

### Why Use This?

Ambient awareness — Know when your AI is working without checking screens
Flow state protection — Visual indicator prevents interruptions during deep work
Satisfying completion — Green light signals "ready for next task"
Conversation starter — "My AI has a physical presence in my house"

### 1. Setup Your Hue Bridge

# Find your bridge IP (check router or Hue app), then run:
hue setup <bridge-ip>

# Example:
hue setup 192.168.1.100

### 2. Find Your Light

hue lights

# Output:
#   2: Bed room 1 💡 ON
#   3: Bedroom 2 ⚫ OFF
#   5: Front door 💡 ON  ← Use this one

### 3. Use It

# AI starts thinking
hue thinking 5

# AI is done
hue done 5

### Option 1: Copy to PATH

# Clone or download
git clone https://github.com/yourusername/philips-hue-thinking.git

# Add to PATH
cp philips-hue-thinking/hue /usr/local/bin/
chmod +x /usr/local/bin/hue

### Option 2: Use Directly

# Add to your shell profile (.zshrc or .bashrc)
export PATH="$PATH:/path/to/philips-hue-thinking"

# Then reload
source ~/.zshrc

### Core Commands

# Setup (press bridge button first!)
hue setup <bridge-ip>

# List all lights
hue lights

# Thinking mode (pulsing red)
hue thinking <light-id>

# Done (solid green)
hue done <light-id>

# Set any color
hue set <light-id> <color>

### Available Colors

hue set 5 red
hue set 5 green
hue set 5 blue
hue set 5 yellow
hue set 5 purple
hue set 5 orange

### Utility Commands

# Turn off
hue off 5

# Pulse continuously
hue pulse 5 --color red

### With AI Assistants

Planning Mode:

User: "Planning mode — I want to build a website"
AI:  [runs 'hue thinking 5'] 🔴 Pulsing...
     "Here are my questions..."
User: [answers]
AI:  [runs 'hue done 5'] ✅ Green
     "Starting build now..."
     [runs 'hue thinking 5'] 🔴 Solid red while building
AI:  [runs 'hue done 5'] ✅ Green
     "Done!"

### Shell Aliases

Add to ~/.zshrc:

# Quick aliases
alias think='hue thinking 5'
alias done='hue done 5'

Then just type:

think  # Light pulses red
done   # Light turns green

### How It Works

Hue Bridge API — Communicates via local HTTP API
Color XY Values — Uses CIE color space for accurate colors
Background Pulse — Bash loop dims/brightens light
Stateless — Stores config in ~/.config/philips-hue/

### Color XY Values

ColorXYRed0.6750.322Green0.2140.709Blue0.1670.040Yellow0.4920.476Purple0.2650.100Orange0.6000.380

### The Pulse Effect

# Brightness oscillation
254 (bright) → 50 (dim) → 254

# Timing
~2 second cycle
Background process keeps pulsing

### Configuration

Config stored in: ~/.config/philips-hue/config.json

{
  "bridge_ip": "192.168.1.100",
  "username": "your-api-key"
}

### Requirements

Philips Hue Bridge (v2)
Philips Hue color bulbs
macOS/Linux with curl
Bash 4.0+

### "Link button not pressed"

Press the physical button on your Hue Bridge, then run setup within 30 seconds.

### Light not responding

# Check connection
hue lights

# Verify config
cat ~/.config/philips-hue/config.json

### Pulse won't stop

# Kill background process
pkill -f "hue-pulse-loop"

# Reset light
hue done 5

### Future Ideas

Auto-trigger via AI session lifecycle
 Multiple lights for different task types
 Heartbeat mode (gentle pulse every 30 min)
 Error state (flash purple)
 Success celebration (rainbow effect)

### License

MIT — See LICENSE file

### Credits

Created by Jesse & Kate (Clawdbot)
Inspired by the need for AI physical presence

Questions? Open an issue or DM @jesse on Twitter
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: JesseRod329
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T20:31:09.317Z
- Expires at: 2026-05-07T20:31:09.317Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/philips-hue-thinking)
- [Send to Agent page](https://openagent3.xyz/skills/philips-hue-thinking/agent)
- [JSON manifest](https://openagent3.xyz/skills/philips-hue-thinking/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/philips-hue-thinking/agent.md)
- [Download page](https://openagent3.xyz/downloads/philips-hue-thinking)