Vibelight

A light that fits the vibe. Inspired by claude-lamp.

Features

• Govee Floor Lamp 2 (H607C) control via LAN multicast
• Five lighting modes: plan (orange), build (blue), agent (purple), idle (white), on/off
• Pure RGB mode for accurate color reproduction (no white channel mixing)
• Automatic device discovery via UDP multicast
• Opencode plugin for automatic mode switching based on agent activity
• Cursor hooks support for agent session integration
• CLI with graceful signal handling for cleanup

Quickstart

Navigate to where you cloned the repo, then run these commands:

cd /path/to/vibelight

Note on absolute paths: The symlinks below use $(pwd) to resolve the full path. We use absolute symlinks for reliability—they won't break if you move between directories, and they clearly indicate where the source files live. While relative symlinks work too, absolute paths are less fragile for configuration files.

1. Install to PATH

Add the vibe command to your PATH so it's available anywhere:

# Ensure ~/.local/bin exists and is in your PATH
mkdir -p ~/.local/bin
export PATH="$HOME/.local/bin:$PATH"  # Add to ~/.zshrc if not already there

# Create symlink using absolute path of current directory
ln -s "$(pwd)/vibe.py" ~/.local/bin/vibe

2. Install opencode plugin

# Symlink the plugin to opencode's plugin directory
ln -s "$(pwd)/update_mode.ts" ~/.config/opencode/plugins/

2b. Install Cursor hooks (optional)

# Symlink the hooks config and vibe entrypoint (global hooks run with cwd ~/.cursor/)
ln -s "$(pwd)/cursor_hooks.json" ~/.cursor/hooks.json
ln -sf "$(pwd)/vibe.py" ~/.cursor/vibe.py

Hooks call python3 ./vibe.py cursor-hook: purple while the agent is working (submit, tools, reads, edits), grey on session start/end and when a run completes (stop). Do not register sessionIdle in hooks — Cursor can emit it during an active agent run and would force grey over purple.

3. Optional: Turn on/off with opencode

Add to your ~/.zshrc:

# Remove any existing alias first (to avoid zsh parse errors)
unalias opencode 2>/dev/null

opencode() {
    vibe on
    command opencode "$@"
    vibe off
}

Now when you run any opencode command (e.g., opencode models --refresh), the light will turn on first, execute the command, then turn off after.

4. Optional: Cursor from the terminal (zsh)

Same idea as opencode: wrap cursor in a function so launching Cursor from the shell sets the lamp first.

unalias cursor 2>/dev/null

cursor() {
    vibe idle
    command cursor "$@"
}

This sets idle (grey) when you run cursor or cursor . from a terminal. The Cursor CLI usually returns as soon as the app opens, so hooks still control purple/grey while you work inside the editor.

To mirror opencode literally (vibe on / vibe off), you can use the same pattern; note that vibe off may run right after the CLI exits even though Cursor stays open:

cursor() {
    vibe on
    command cursor "$@"
    vibe off
}

Manual usage

vibe idle    # Calm breathing (white)
vibe plan    # Energetic breathing (orange)
vibe build   # Balanced breathing (blue)
vibe agent   # Creative breathing (purple) - for Cursor agent mode
vibe on      # Turn on steady light
vibe off     # Turn off