Claude Code Glow

claude-glow

An ambient screen-border glow that tells you when Claude Code is waiting on you.

The edges of your screen glow soft orange whenever Claude Code is blocked on your input — a finished turn, a permission prompt, an `AskUserQuestion`, or an MCP elicitation dialog. The glow clears the moment you unblock it — either by taking an action in the terminal, or simply by focusing a terminal window (so you can acknowledge the signal without losing context at the end of the day). No notifications, no dock bouncing, no context switch — just a peripheral-vision signal so you can work in another window and know the instant Claude needs you.

Requirements

• macOS
• Hammerspoon (brew install --cask hammerspoon)
• Claude Code
• jq (brew install jq)

Install

git clone https://github.com/noahkirsch/Claude-Code-Glow
cd Claude-Code-Glow
./install.sh

Then restart Claude Code so it picks up the new hook wiring.

The installer:

1. Copies ClaudeGlow.spoon into ~/.hammerspoon/Spoons/
2. Appends a one-liner to ~/.hammerspoon/init.lua that loads and starts the Spoon
3. Merges the Claude Code hook wiring into ~/.claude/settings.json (a timestamped backup is saved alongside)
4. Reloads Hammerspoon

It is safe to re-run; steps already applied are skipped.

Uninstall

./uninstall.sh

Removes the Spoon, the loader lines, and the hook entries. Backups are saved.

How it works

Hammerspoon draws a full-screen transparent canvas with a stack of stroked rectangles at decreasing alpha — a soft gradient band around the edges of every connected display. The canvas sits at the `overlay` window level, ignores clicks, and joins all Spaces so you see it everywhere.

Claude Code hooks fire `open