**Original link：https://warpnav.com/peonping-warcraft-voice-ai-coding
Adding the sounds of Warcraft 3 Orc peons to Claude Code is not only fun but also provides reminders of its current running status. PeonPing is such a tool, making AI programming less tedious.
Project Overview
PeonPing is an open-source tool designed for AI programming assistants and IDEs such as Claude Code, OpenAI Codex, and Cursor . Its core function is to add voice and desktop notifications for various events during the programming process .
Inspired by the orc peons from Blizzard's Warcraft III, this project uses their classic voice lines by default (such as "Ready to work?" and "Work, work!"). It aims to free developers from "babysitting your terminal," as PeonPing will promptly notify you via sound and notifications when an AI task is completed or requires your authorization while you switch to another window to work.
Project address: [https://github.com/PeonPing/peon-ping]
Core Functions
Immersive voice notifications
PeonPing plays specific sound effects based on different events, allowing you to perceive the task status through hearing:
- Task begins: Play the voice prompt "Ready to work?"
- Task completed: Play confirmation messages such as "Work, work." and "Okie dokie."
- Permission required: When the AI needs your confirmation to execute a command, it will play "Something need doing?" or "What you want?"
- Error/Failure: Played voice prompts such as "Me not that kind of orc!"
- Easter egg: If you submit more than 3 prompts in a short period of time (within 10 seconds), an annoyed voice message will be triggered: "Me busy, leave me alone!"
Multi-dimensional reminder mechanism
- Desktop notifications: Send system-level desktop notifications when the terminal window is out of focus, ensuring you don't miss important information.
- Dynamic terminal title: Modify the title of the terminal tab to display the current project name and status (for example
● project: done), allowing for quick and easy viewing.
Rich voice packs
Although the default is Orc Peons, PeonPing supports multiple voice packs and complies with the CESP (Coding Event Sound Pack Specification) standard:
- Built-in/Official Package: Provides unit voices from StarCraft (Battlecruiser, Kerrigan), Portal (GLaDOS), and various styles of Warcraft III.
- Rotation mechanism: Supports setting voice pack rotation (Round-robin), using different voice characters for each task to keep things fresh.
- Customization: Users can create and submit their own voice packs.
Wide compatibility
Supported IDEs/Agents:
- Claude Code (Native Support)
- OpenAI Codex
- Cursor
- OpenCode (via adapter)
operating system:
- macOS: Using
afplayAppleScript - WSL2 (Windows): Using PowerShell MediaPlayer and WinForms
- Linux: Supports multiple media players including
pw-play[ list of media players]paplay,ffplay...mpvetc.notify-send
Lightweight and technology stack
- No dependencies: Written entirely using Bash Shell scripts in conjunction with embedded Python.
- No Node.js required: No need to install npm or the Node runtime environment; installation and operation are very lightweight.
Installation and Configuration
The project offers an extremely simple installation method:
General installation (recommended):
curl -fsSL https://raw.githubusercontent.com/PeonPing/peon-ping/main/install.sh | bash
Homebrew (macOS/Linux):
brew install PeonPing/tap/peon-ping
PeonPing is designed to be usable with "zero configuration" while also supporting deep customization:
- Natural language configuration: You can directly tell Claude: "Enable round-robin pack rotation" or "Set volume to 0.5", and it will automatically modify the configuration.
- The Slash command: In Claude Code, this can be used to
/peon-ping-togglequickly turn the code on or off. - Configuration file: The configuration file is located at the default location
~/.claude/hooks/peon-ping/config.json, where you can manually edit volume, voice packs, disable specific types of sounds, etc.
Summarize
PeonPing is a fun and practical developer tool. It not only solves the problem of developers' attention being distracted by long runs of AI programming tools, but also adds fun to the tedious debugging process through gamified voice feedback. It's an excellent companion plugin for developers using terminal AI assistants like Claude Code.
Top comments (0)