Peon Ping: The Complete Guide to Voice Notifications for AI Coding Agents
"Work work." If those two words just triggered a wave of nostalgia, you already understand what Peon Ping is about.
Every AI coding agent has the same problem: you start a task, switch tabs, and 15 minutes later you realize it finished ages ago. Peon Ping fixes this with game character voice lines and bold on-screen overlay banners — Warcraft III Peons telling you "Job's done!", GLaDOS mocking your errors, StarCraft Kerrigan confirming file reads.
With 3,700+ stars in just one month since release, it's become one of the fastest-growing developer tools of 2026.
Key Stats
| Metric | Value |
|---|---|
| GitHub Stars | 3,700+ |
| Forks | 261 |
| Created | February 2026 |
| Language | Shell (Bash + PowerShell) |
| License | MIT |
| Homepage | peonping.com |
| Releases | 23 |
| Install | Homebrew, curl, Windows installer, Nix |
The Problem It Solves
Modern AI coding agents — Claude Code, Codex, Cursor, Copilot — run tasks asynchronously. You kick off a build, a test suite, or a code generation task, tab over to Slack or docs, and then completely forget the agent is waiting for your input. You lose 15–30 minutes of flow time, multiplied across every session.
Peon Ping solves this by:
- Playing a game character voice line when events happen (task complete, error, permission needed)
- Showing a bold overlay banner across your screen — visible even when you're in another app
- Updating terminal tab titles with status indicators (● project: done)
- Sending mobile push notifications when you're away from your desk
What You'll Hear
Peon Ping maps AI agent events to the CESP (Coding Event Sound Pack Specification) — an open standard for coding event sounds:
| Event | When It Fires | Default Sound |
|---|---|---|
session.start | Agent session begins | "Ready to work!" |
task.complete | Agent finishes a task | "Job's done!" |
input.required | Agent needs permission or input | "More work?" |
task.error | Build or tool failure | "We're under attack!" |
task.acknowledge | Agent starts working | "Okie dokie" |
resource.limit | Context window or memory limits | "Can't carry anymore" |
user.spam | Repeated identical inputs | "Stop poking me!" |
165 Sound Packs
The default install includes 5 curated packs. But there are 165 total spanning iconic games and characters:
- Warcraft III — Peon, Peasant, Arthas, Night Elf, Undead
- StarCraft — Kerrigan, Battlecruiser, Zergling, Marine
- Portal — GLaDOS
- Zelda — Link, Navi
- Red Alert — Soviet, Allied
- Dota 2 — Various heroes
- Helldivers 2 — Squad notifications
- Elder Scrolls — Guard quotes
- Duke Nukem — Classic one-liners
Install all with peon packs install --all or browse at openpeon.com/packs.
Supported IDEs & Agents
Peon Ping works with 15+ AI coding tools through IDE-specific adapters:
| IDE / Agent | Setup |
|---|---|
| Claude Code | Built-in (auto-configured on install) |
| Codex | Adapter via ~/.codex/config.toml |
| Cursor | Native hooks support |
| Amp | Adapter script |
| GitHub Copilot | .github/hooks/hooks.json adapter |
| OpenCode | Adapter script |
| Kilo CLI | Adapter script |
| Gemini CLI | Adapter script |
| Kiro | Adapter script |
| Kimi Code | Auto-install adapter |
| Windsurf | Adapter script |
| Google Antigravity | Adapter script |
| Rovo Dev CLI | Config-based setup |
| DeepAgents | Adapter script |
| Any MCP client | MCP server (agent picks its own sounds!) |
All adapters have native PowerShell (.ps1) versions for Windows — no WSL required.
MCP Server — Agents Pick Their Own Sounds
The most innovative feature: Peon Ping includes an MCP (Model Context Protocol) server so AI agents can play sounds directly via tool calls.
The key difference: the agent chooses the sound. Instead of a fixed sound per event, the agent calls play_sound with exactly what it wants:
duke_nukem/SonOfABitchwhen a build failssc_kerrigan/IReadYouwhen reading filesglados/YourBusinessIsAppreciatedwhen finishing a task
This turns sound feedback from a simple notification into an expressive, context-aware experience.
Peon Trainer
Your peon is also your personal trainer. Built-in Pavel-style daily exercise mode — the same orc who tells you "work work" now tells you to drop and give him twenty. Because sitting at a terminal all day isn't great for you.
Remote Development
Coding on a remote server, inside a devcontainer, or in GitHub Codespaces? Peon Ping auto-detects remote environments and routes audio + notifications through a lightweight relay running on your local machine.
peon relay --daemon # Start relay on local machine
# Remote audio & notifications automatically forwarded
Mobile Notifications
Get push notifications on your phone via ntfy.sh (free, no account needed):
peon mobile ntfy my-topic # Set up phone notifications
peon mobile test # Send a test notification
Installation
Homebrew (Recommended)
brew install peonping/tap/peon-ping
Installer Script (macOS, Linux, WSL2)
curl -fsSL https://raw.githubusercontent.com/PeonPing/peon-ping/main/install.sh | bash
Windows (PowerShell)
irm https://raw.githubusercontent.com/PeonPing/peon-ping/main/install.ps1 | iex
Nix
nix-env -iA nixpkgs.peon-ping
Quick Controls
peon pause # Mute sounds
peon resume # Unmute
peon volume 0.7 # Set volume (0.0–1.0)
peon packs use glados # Switch sound pack
peon packs next # Cycle to next pack
peon preview # Play all sounds
peon notifications off # Disable desktop notifications
Peon Ping vs Alternatives
There really aren't direct alternatives — Peon Ping created its own category. But here's how it compares to general notification approaches:
| Approach | Sound Notifications | Visual Overlay | Multi-IDE | Sound Packs | MCP | Remote Dev |
|---|---|---|---|---|---|---|
| Peon Ping | ✅ 165 game packs | ✅ Full-screen overlay | ✅ 15+ IDEs | ✅ 165 | ✅ | ✅ |
| Terminal bell | ✅ (beep) | ❌ | ❌ | ❌ | ❌ | ❌ |
say / espeak | ✅ (TTS) | ❌ | ❌ | ❌ | ❌ | ❌ |
| Desktop notifications | ❌ | ✅ (small toast) | ❌ | ❌ | ❌ | ❌ |
| Custom scripts | DIY | DIY | DIY | DIY | ❌ | ❌ |
How It Works
- Event mapping — An embedded Python block maps hook events to CESP sound categories
- Sound selection — Picks a random voice line from the active pack, avoiding repeats
- Audio playback — Plays asynchronously via
afplay(macOS), PowerShellMediaPlayer(Windows), orpw-play/paplay/ffplay/mpv/aplay(Linux) - Notifications — Updates terminal tab title + sends desktop notification if terminal isn't focused
- Remote routing — In SSH/devcontainer/Codespaces, forwards requests to a local relay server
Conclusion
Peon Ping is one of those tools that sounds like a joke but solves a genuine productivity problem. AI coding agents don't notify you — and that gap costs real time. By combining 165 game character sound packs, full-screen overlay banners, MCP integration, 15+ IDE support, and remote development routing, Peon Ping turns your terminal into an aware, responsive workspace.
And honestly? Hearing "Job's done!" in a Peon voice when your build passes never gets old.