</>MCP Agents Market
Plugin

peon-ping

by PeonPing5kShellUpdated 2026-08-30

Warcraft III Peon voice notifications (+ more!) for Claude Code, Codex, IDEs, and any AI agent. Stop babysitting your terminal. Employ a Peon today.

Claude CodeCodexGitHub Copilot CLIGrok BuildCursorAmpWindsurfOpenCode

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

Game character voice notifications for session start, task complete, errors, permission requests, and rate limits using 165+ sound packs
Large on-screen overlay banners and terminal tab title updates with multiple themes (Neon, Glass, Sakura, Jarvis)
Multi-IDE support: native hooks for Claude Code, Codex, Grok Build, Copilot CLI, plus adapters for 20+ tools (Cursor, Windsurf, OpenCode, Amp, Gemini CLI, etc.)
Remote development support with audio relay for SSH sessions, devcontainers, and Codespaces
Mobile push notifications via ntfy.sh (free), Pushover, or Telegram for away-from-desk alerts
Per-project pack assignment with glob path rules, IDE-based bindings, and session-override rotation modes
Built-in MCP server allowing agents to choose sounds via tool calls instead of automatic event hooks
Interactive pack creation workflow using Claude Code to generate and remix custom sound packs via ElevenLabs

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 more

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.

Related searches