Claude Meseeks

claude-meseeks 🔵

*"I'm Mr. Meeseeks! Look at me!"*

A Claude Code plugin that plays a Mr. Meeseeks voice line
whenever Claude is genuinely waiting on *you*.

- When Claude finishes and is waiting for your next prompt → a satisfied/finished clip
  from audio/done/ (*"All done!"*, *"Ooh yeah!"*, *"Yes siree!"* …).
- When Claude needs your approval → an asking/coaching clip from audio/asking/
  (*"Can you help me?"*, *"You mind if we get back to the task?"* …).

Both are driven by the Notification event, filtered by notification_type so it fires
only when you're actually needed. Autonomous work — auto-accept/bypass-permissions runs,
background-agent and subagent activity, auth refreshes — stays silent. Clips are random
within the category, and playback is detached and non-blocking, so a long line never freezes
your prompt.

Install

This repository is both the plugin and its own marketplace.

Or, from a local clone:

Restart or reload Claude Code and finish a turn — you should hear Meeseeks.

Requirements

An audio player on your PATH. The tool auto-detects, in order:
afplay (macOS, built in) → ffplay → mpg123 → paplay → aplay → Windows PowerShell
Media.SoundPlayer. On macOS nothing extra is needed. On Linux, install ffmpeg
(for ffplay) or mpg123.

No Go toolchain is required to *use* the plugin — prebuilt binaries ship in bin/. Go is
only needed to rebuild them (see below).

The meeseeks CLI

Playback is handled by a small Go program, meeseeks, with the clips embedded directly in
the binary. You can drive it by hand too:

How it works

hooks/hooks.json registers Notification and UserPromptSubmit hooks that both run
scripts/play.sh notify. That launcher execs the prebuilt bin/meeseeks-- for
your platform (falling back to go build from source if there's no matching…