claude-code-done-overlay

ClaudeCodeDoneOverlay

English | 한국어

A macOS and Linux app that displays a fullscreen overlay notification and plays a sound when Claude Code finishes responding and waits for your input.

Like MeetingBar's meeting alerts, it takes over the screen so you never miss when Claude is ready — even if you're in another app.

Install

claude plugin marketplace add https://github.com/roeniss/claude-code-done-overlay.git
claude plugin install claude-code-done-overlay

No manual configuration needed — hooks are registered automatically. On the first trigger the matching prebuilt binary is downloaded from GitHub Releases and verified against the release SHA256SUMS; if the download is unavailable and a Rust toolchain is present, it is built from source instead. Just restart Claude Code and start a conversation.

Triggers:

• Claude finishes responding and waits for your next prompt (Stop)
• Claude presents a multiple-choice question (AskUserQuestion)

CLI Options

claude-code-done-overlay [options]
  -m, --message <text>    Message to display (default: "Ready for input")
  -t, --timeout <sec>     Auto-dismiss after N seconds (omit to stay until dismissed)
  -h, --help              Show help

Test

After install, just start a new Claude Code session and send any message. When Claude finishes responding, the fullscreen overlay should appear.

To test the binary directly:

bash ~/.claude/plugins/cache/claude-code-done-overlay/claude-code-done-overlay/*/scripts/notify.sh

Expected behavior:

1. Entire screen covered with a semi-transparent black overlay
2. "Claude Code" title + message displayed in the center
3. A short chime plays once
4. Dismissed immediately by any key press or click (or auto-dismissed after timeout)

Duplicate prevention: if an overlay is already showing, a new invocation does nothing and the existing overlay stays.

Update

claude plugin marketplace update roeniss
claude plugin update claude-code-done-overlay@roeniss

Restart Claude Code to apply. (claude plugin update requires the <plugin>@<marketplace> form — the bare name is not resolved.)

Uninstall

claude plugin uninstall claude-code-done-overlay
claude plugin marketplace remove roeniss

Platform Support

Platform	Status
macOS 13+ (Apple Silicon & Intel)	✅ Supported (universal binary)
Linux + X11 (x86_64 / aarch64)	✅ Supported
Linux + Wayland	⚠️ Best-effort (always-on-top / input grab may be unreliable)
Headless / SSH (no display), WSL, Windows	❌ Not supported — the hook exits quietly

A fullscreen overlay needs a desktop GUI session, so display-less environments are intentionally out of scope.

Requirements

• A desktop GUI session on a supported platform (see above).
• Building from source (only used as a fallback when the release download is unavailable): a Rust toolchain. On Linux also install the GUI/audio dev libraries, e.g. on Debian/Ubuntu:

  sudo apt-get install -y libasound2-dev libudev-dev libxkbcommon-dev \
    libwayland-dev libgl1-mesa-dev libxcb1-dev libx11-dev