peon-ping
Warcraft III Peon voice notifications (+ more!) for Claude Code, Codex, IDEs, and any AI agent. Stop babysitting your terminal. Employ a Peon today.
peon-ping is a notification plugin for Claude Code and other AI coding agents that plays iconic game character voice lines (Warcraft, StarCraft, Portal, etc.) and displays desktop overlays when your agent finishes tasks, needs permission, or hits errors. It prevents context-switching by alerting you when the agent is idle, so you don't waste time babysitting the terminal. The plugin supports 20+ IDEs via adapters, works over SSH/containers via audio relay, includes mobile push notifications, and offers 165+ sound packs following the CESP (Coding Event Sound Pack) standard.
Key Features
Use Cases
- 01Get audible alerts when Claude Code finishes long-running tasks so you can multitask without constantly checking the terminal
- 02Assign different sound packs to different projects (GLaDOS for client work, Peon for personal repos) using path-based rules
- 03Receive mobile notifications when permission prompts appear while you're away from your desk
- 04Route audio to your laptop when coding over SSH or in a devcontainer via the relay daemon
- 05Suppress notifications during meetings automatically using macOS Focus detection or headphones-only mode
- 06Create custom AI-generated sound packs with specific vibes (calm, intense, retro) using the built-in pack creation tool
Related Plugins
View moreandrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
claude-mem
Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Understand-Anything
Graphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
rtk
CLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Single Rust binary, zero dependencies
peon-ping — FAQ
What is peon-ping?+
peon-ping is a notification plugin for Claude Code and compatible AI coding agents that plays game character voice lines and shows desktop overlays when your agent needs attention. It prevents context-switching by alerting you to task completions, errors, and permission requests.
How do I install peon-ping for Claude Code?+
Run 'curl -fsSL https://raw.githubusercontent.com/PeonPing/peon-ping/main/install.sh | bash' on macOS/Linux/WSL2, or download and run 'install.ps1' via PowerShell on Windows. On macOS you can also install via Homebrew with 'brew install PeonPing/tap/peon-ping' then run 'peon-ping-setup'.
Which AI clients and IDEs does peon-ping support?+
Built-in support for Claude Code, OpenAI Codex, GitHub Copilot CLI, Grok Build, and Cursor. Adapters available for 20+ tools including Amp, Windsurf, OpenCode, Kilo CLI, Gemini CLI, Kimi Code, Qwen Code, iFlow CLI, and others.
Does peon-ping require API keys?+
No API keys are required for basic sound and notification functionality. An ElevenLabs API key is only needed if you want to create custom AI-generated sound packs using 'peon create'.
Is peon-ping free?+
Yes, peon-ping is free and open source (MIT license). Mobile notifications via ntfy.sh are also free; Pushover requires a one-time $5 purchase.
Can I use peon-ping over SSH or in containers?+
Yes, run 'peon relay --daemon' on your local machine, then SSH with port forwarding 'ssh -R 19998:localhost:19998 server'. For devcontainers and Codespaces, just run the relay locally and peon-ping auto-detects the environment.
How do I install peon-ping?+
Open the source repository on GitHub and follow its README. peon-ping is a plugin — MCP Agents Market links you directly to the official repo.
Is peon-ping free?+
peon-ping is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.