tonyyont/peon-ping: Warcraft III Peon voice notifications for Claude Code. Stop babysitting your terminal.

Peon-Ping: The Warcraft III Voice Alert System for Claude Code That’s Taking Devs by Storm

In a world where developers constantly juggle multiple tasks and lose precious minutes to context switching, a new open-source tool is making waves in the tech community. Peon-Ping, created by Tony Yont, transforms your Claude Code experience by adding iconic Warcraft III Peon voice lines that alert you when your AI coding assistant needs attention.

The Problem: Claude Code’s Silent Treatment

Claude Code, Anthropic’s powerful terminal-based AI coding assistant, has revolutionized how developers interact with AI for programming tasks. However, it comes with a frustrating limitation: it doesn’t notify you when it finishes tasks or needs permission. As Tony Yont explains, “You tab away, lose focus, and waste 15 minutes getting back into flow.”

The Solution: Warcraft III Meets AI Coding

Peon-Ping fixes this productivity killer with a brilliantly simple solution—Warcraft III Peon voice lines. When Claude Code needs your attention, your terminal suddenly sounds like Orgrimmar, complete with beloved quotes like “Ready to work?”, “Work, work.”, and “Okie dokie.”

The installation is remarkably straightforward:
bash
curl -fsSL https://raw.githubusercontent.com/tonyyont/peon-ping/main/install.sh | bash

One command. Ten seconds. Compatible with macOS and WSL2 on Windows. Re-run to update, and your sounds and config are preserved.

How It Works: Event-Driven Audio Alerts

Peon-Ping hooks into Claude Code’s session lifecycle, responding to four key events:

• Session starts: Greeting sounds like “Ready to work?” or “What you want?”
• Task finishes: Acknowledgment sounds such as “Work, work.” or “I can do that.”
• Permission needed: Alert sounds including “Something need doing?” or “Hmm?”
• Rapid prompts (3+ in 10s): Easter egg sounds like “Me busy, leave me alone!”

Plus, it updates your Terminal tab titles (e.g., “● project: done”) and sends desktop notifications when your terminal isn’t focused.

Total Control: Mute, Switch, and Customize

Need to mute during meetings? Peon-Ping offers two quick methods:

Slash command (while in Claude Code): /peon-ping-toggle
CLI (from any terminal tab): peon --toggle

Other CLI commands include:

• peon --pause / peon --resume to mute/unmute
• peon --status to check current state
• peon --packs to list available sound packs
• peon --pack <name> to switch packs or cycle through them

Tab completion is supported—type peon --pack <tab> to see available pack names.

Customization Galore

Edit ~/.claude/hooks/peon-ping/config.json to fine-tune your experience:

json
{
“volume”: 0.5,
“categories”: {
“greeting”: true,
“acknowledge”: true,
“complete”: true,
“error”: true,
“permission”: true,
“annoyed”: true
}
}

Adjust volume (0.0–1.0, quiet enough for the office), toggle individual sound categories, set annoyed thresholds, and even configure pack rotation for variety.

Beyond Peons: A Growing Sound Pack Library

While the default Peon pack features iconic Orc Peon lines from Warcraft III, Peon-Ping supports multiple sound packs:

• Peon (French): French Orc Peon voice lines
• Peon (Polish): Polish voice lines
• Peasant: Human Peasant from Warcraft III
• Ra2 Soviet Engineer: From Red Alert 2
• SC Battlecruiser: StarCraft’s Battlecruiser
• SC Kerrigan: Sarah Kerrigan from StarCraft

Switch packs via CLI or edit the config file. Want to add your own? The project welcomes contributions.

Technical Implementation

Peon-Ping is a Claude Code hook registered for SessionStart, UserPromptSubmit, Stop, and Notification events. It maps events to sound categories, picks random voice lines (avoiding repeats), plays them via afplay (macOS) or PowerShell MediaPlayer (WSL2), and updates Terminal tab titles.

Requirements

• macOS (uses afplay and AppleScript) or WSL2 (uses PowerShell MediaPlayer and WinForms)
• Claude Code with hooks support
• Python 3

The Viral Appeal

Peon-Ping isn’t just functional—it’s fun. It transforms mundane coding sessions into something memorable, with developers sharing their experiences across social media. The combination of productivity enhancement and nostalgic gaming references has created a perfect storm of adoption.

Tags: #ClaudeCode #AI #Productivity #WarcraftIII #OpenSource #DeveloperTools #Terminal #Gaming #Tech #Innovation #Coding #AIAssistant #PeonPing #VoiceAlerts #ProductivityHack #DevTools #TechNews

Viral Phrases: “Your terminal sounds like Orgrimmar”, “Never miss a beat with Warcraft III voice lines”, “Fixes the 15-minute flow killer”, “One command. Ten seconds. Game-changing”, “Productivity meets nostalgia”, “The sound of productivity”, “Coding with Peon power”, “AI that actually gets your attention”, “Terminal notifications that don’t suck”, “The Warcraft III productivity hack devs are raving about”

,