What is peon-ping?

peon-ping is a tool that plays voice lines and shows on-screen banners when your AI coding agent finishes a task or needs your attention. When you use an AI coding tool like Claude Code, Cursor, or GitHub Copilot to work on code, those tools often run for minutes at a time and then sit waiting for you to come back and approve something. The problem is they give you no audio or visual signal when that happens, so you end up constantly switching back to check, or you miss the notification and waste time. peon-ping watches for those moments and makes noise. The voice lines come from game characters like the Warcraft III Peon (the grunting worker unit the project is named after), as well as characters from StarCraft, Portal, Zelda, and other games. The README lists sound packs as a configurable choice, so you can pick which game's sounds you want. Beyond audio, it also displays bold on-screen banners as visual notifications. It supports a wide list of AI coding tools including Claude Code, Amp, Gemini CLI, GitHub Copilot, Codex, Cursor, Windsurf, Kiro, and others, via a hook or adapter system that each tool supports for running external scripts on events. The tool works on macOS, Linux, Windows, and WSL2 (the Windows Subsystem for Linux). Installation options include Homebrew on Mac and Linux, a curl installer script, a PowerShell script for Windows, cloning the repo directly, or Nix. After installing, a setup command registers the hooks with your AI tools and downloads sound packs. There is also an MCP server component, which is a protocol that AI agents can use to call external tools. Through MCP, an AI agent can choose which sound to play rather than relying only on fixed hook events. A feature called Peon Trainer is mentioned in the table of contents as well, though the truncated README does not expand on it in the portion available. The full README is longer than what was shown.