peonping/peon-ping

★ 4,711ShellAudience · developerComplexity · 2/5Setup · easy

Mindmap

mindmap
  root((peon-ping))
    What it does
      Audio notifications
      On-screen banners
      AI tool hooks
    Sound packs
      Warcraft III
      StarCraft
      Portal
      Zelda
    Supported tools
      Claude Code
      Cursor
      Copilot
      Gemini CLI
    Setup
      Homebrew
      curl installer
      PowerShell

mindmap root((peon-ping)) What it does Audio notifications On-screen banners AI tool hooks Sound packs Warcraft III StarCraft Portal Zelda Supported tools Claude Code Cursor Copilot Gemini CLI Setup Homebrew curl installer PowerShell

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Get an audio alert from Warcraft or StarCraft voice lines when Claude Code or Cursor finishes and needs your approval.

USE CASE 2

Display bold on-screen banners so you notice when an AI coding tool is waiting without constantly switching back to check.

USE CASE 3

Use the MCP server component so your AI agent can choose which sound to play when it completes a step.

Tech stack

Shell

Getting it running

Difficulty · easy Time to first run · 5min

In plain English

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.

Copy-paste prompts

Prompt 1

How do I install peon-ping on macOS with Homebrew and connect it to Claude Code so I hear a Peon voice when it finishes?

Prompt 2

Show me how to configure peon-ping to use StarCraft sound packs instead of the default Warcraft III Peon sounds.

Prompt 3

How do I register peon-ping hooks with multiple AI tools like Cursor and Gemini CLI at the same time?

Prompt 4

Explain how to set up the peon-ping MCP server so my AI agent can pick which sound to play mid-task.

Open on GitHub → Explain another repo

← peonping on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.