thephw/claude-meseeks
main
Branches
Tags
Go to file
Code
Open more actions menu
Folders and files
Name
Name
Last commit message
Last commit date
Latest commit
History
14 Commits
14 Commits
.claude-plugin
.claude-plugin
.github/
workflows
.github/
workflows
audio
audio
bin
bin
hooks
hooks
scripts
scripts
.gitignore
.gitignore
.tool-versions
.tool-versions
CLAUDE.md
CLAUDE.md
LICENSE
LICENSE
README.md
README.md
claude-meseeks
claude-meseeks
detach_unix.go
detach_unix.go
detach_windows.go
detach_windows.go
go.mod
go.mod
main.go
main.go
main_test.go
main_test.go
player.go
player.go
View all files
Repository files navigation
README
License
More
items
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.
/plugin marketplace add thephw/claude-meseeks
/plugin install mr-meeseeks@claude-meseeks
Or, from a local clone:
/plugin marketplace add /path/to/claude-meseeks
/plugin install mr-meeseeks@claude-meseeks
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:
meeseeks play # random “done” clip, detached
meeseeks play asking # random “asking” clip
meeseeks play feedback –wait # a prompt-submit clip, blocking until it finishes
meeseeks play –clip “ALL DONE” # a specific clip by name
meeseeks list all # list every embedded clip
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 binary, or
staying silent if neither is available), passing the event’s JSON through on stdin.
meeseeks notify
reads that JSON and looks at
hook_event_name
and
notification_type
:
Event
Result
UserPromptSubmit
(you just sent Claude a prompt)
random
feedback
Notification
+
idle_prompt
(Claude done, your turn)
random
done
Notification
+
permission_prompt
(needs approval)
random
asking
anything else (
agent_completed
,
auth_success
, …)
silence
The chosen clip is extracted from the embedded audio to a cache dir and handed to a system
player in a detached process. Every path exits 0, so the hook never blocks or errors your
session.
Each category can be silenced independently via the plugin’s config options
(
enableDone
/
enableAsking
/
enableFeedback
) — Claude Code prompts for these when you
enable the plugin, and passes them to the hook as
CLAUDE_PLUGIN_OPTION_*
env vars. They
default to on; only automatic hook playback is gated (manual
meeseeks play
always plays).
Why not the
Stop
hook?
Stop
fires at the end of
every
turn — including
auto-continuations — so it plays sounds when you aren’t actually being waited on. The
event-type filter is the reliable signal for “it’s your turn.”
Customizing clips
Clips live under
audio/
, sorted into three folders that map to behavior:
audio/done/
— played when Claude finishes and it’s your turn (idle prompt).
audio/asking/
— played on permission/input prompts.
audio/feedback/
— played every time you submit a prompt to Claude.
To change what plays, move
.mp3
files between the folders or drop your own in, then
rebuild the binaries
so the new clips are re-embedded:
./scripts/build.sh # regenerates bin/ for all platforms
Two constraints: filenames must end in
.mp3
, and — because of a
go:embed
restriction —
must not contain apostrophes (
‘
).
Why Meeseeks? On single-purpose sessions
The theme isn’t just a joke — it’s a working philosophy.
A Mr. Meeseeks is summoned to accomplish
one task
. It exists only until that task is
done, and then it poofs out of existence, satisfied. Give a Meeseeks a single, concrete goal
(“help me finish this putt”) and it’s cheerful and effective. Give it a vague or unbounded
one, or keep it alive long past its purpose, and things degrade fast —
“existence is
pain, Jerry!”
— until you get a room full of increasingly unhinged Meeseeks.
A Claude Code session works best the same way:
Summon it for one goal.
A session scoped to a single, well-defined objective —
“add this endpoint”, “fix this failing test”, “write this plugin” — is focused and sharp,
the same way a fresh Meeseeks is.
Let it finish, then let it go.
When the goal is met, end the session. Start a new one
for the next task. A fresh session with a clean context beats a stale one every time.
Beware the long-lived session.
Dragging one conversation across many unrelated goals
is how you get the Meeseeks box problem: context piles up, focus drifts, earlier tangents
pollute later work, and quality slides. Long ≠ productive.
So: treat each session like a Meeseeks. One purpose. Accomplish it. Poof. 🔵
Credits
Inspired by and audio sourced from the
Mr. Meeseeks Soundboard
at jayuzumi.com.
Thanks for the clips! 🔵
Note on the audio
The voice clips are from
Rick and Morty
(via the
jayuzumi.com Mr. Meeseeks Soundboard
) and are
included here for personal, non-commercial fun. They are the property of their respective
rights holders. Please consider those rights before redistributing this plugin publicly or
swap in your own audio.
About
Claude Code plugin that plays a Mr. Meeseeks voice line whenever Claude is waiting for you.
Topics
audio
hooks
fun
rick-and-morty
claude
meeseeks
anthropic
claude-code
claude-code-plugin
Resources
Readme
License
View license
Uh oh!
There was an error while loading.
Please reload this page
.
Activity
Stars
28
stars
Watchers
0
watching
Forks
1
fork
Report repository
Releases
1
v0.2.0 — Embedded Go meeseeks CLI
Latest
Jul 8, 2026
Packages
0
Uh oh!
There was an error while loading.
Please reload this page
.
Contributors
Uh oh!
There was an error while loading.
Please reload this page
.
Languages
Go
87.5%
Shell
12.5%
