peon-ping is a notification tool that delivers voice lines and visual overlays to alert developers when AI coding agents need attention or complete tasks.
The problem it solves is the loss of focus and wasted time that occurs when developers step away from their terminal while waiting for AI agents to finish or request permission. peon-ping works by triggering game character voice lines and bold on-screen banners from franchises like Warcraft, StarCraft, Portal, and Zelda whenever an AI agent needs interaction. The tool integrates with multiple AI coding platforms through hooks and adapters, and also exposes an MCP server interface that allows agents to select their own sounds programmatically.
The tool suits developers who work with AI coding agents across various IDEs and environments and want to stay engaged without constant monitoring. It works with Claude Code, Amp, GitHub Copilot, Codex, Cursor, Windsurf, and many other AI coding platforms. The project supports macOS, WSL2, Linux, Windows, MSYS2, and SSH environments, making it accessible across different development setups. It also includes mobile notification support and allows users to create custom sound packs beyond the built-in game character libraries.
The project maintains active support across a broad ecosystem of AI coding tools and platforms, with integrations spanning both established and emerging agents. Development includes tooling for sound pack creation and debugging capabilities for users implementing the tool in their workflows. The project provides documentation in multiple languages and offers both direct installation via package managers and remote development support through SSH, dev containers, and cloud environments.
