task-banner

Show a large, always-on-top desktop banner when Claude Code finishes a turn — with a one-line summary of what was actually completed. Works even when macOS Notification Center silently drops osascript display notification calls (a common problem: the CLI has no Notification Center registration, so the command exits 0 but nothing shows).

The banner is a borderless Cocoa overlay window drawn by mac-overlay.js (a JXA script adapted from peon-ping), so no notification permissions are needed.

Requirements

• macOS (the overlay uses Cocoa via JXA / osascript -l JavaScript)
• Claude Code with hooks support

Setup

1. Copy mac-overlay.js from this skill directory to ~/.claude/scripts/mac-overlay.js.

2. Merge a Stop hook into ~/.claude/settings.json (read the file first and preserve existing hooks):