peon-ping
Warcraft III Peon voice notifications (+ more!) for Claude Code, Codex, IDEs, and any AI agent. Stop babysitting your terminal. Employ a Peon today.
- 5.1k stars
- 396 forks
- 33 open issues
- Language: Shell
- License: MIT
- updated
Install
git clone https://github.com/PeonPing/peon-ping && cp peon-ping/*.md ~/.claude/agents/- Clone the repository and copy the agent .md definitions into ~/.claude/agents (or .claude/agents inside a project).
- Start a new Claude Code session to load the agents.
- Delegate work to them with the Task/Agent tool or by name.
Editor's note
Peon-ping is a notification tool that plays video game voice lines and displays on-screen overlay banners whenever an AI coding agent completes a task or requires user input. It integrates with Claude Code via hooks registered in `.claude/settings.json`, and also supports Cursor, Codex, Windsurf, GitHub Copilot, and roughly twenty other agents through dedicated adapters. Sound packs draw from Warcraft III Peon dialogue, StarCraft's Kerrigan, Portal, Zelda, and others, and users can browse and select packs interactively at peonping.com. An included MCP server lets the agent itself choose which sound to trigger programmatically. Installation is available via Homebrew, a curl script for macOS and Linux, and a PowerShell installer for Windows and WSL2, with the WSL2 path handling audio backend differences between Windows 10 and Windows 11 24H2 automatically. The tool targets developers who work away from the terminal during long agent runs and need a reliable ambient signal rather than manually polling for completion.
7 items in this repository
Update peon-ping configuration — volume, pack rotation, categories, active pack, and other settings. Use when user wants to change peon-ping settings like volume, enable round-robin, add packs to rotation, toggle sound categories, or adjust any config.
Internal — invoked headlessly by `peon create`; humans should run `peon create` instead. Author and render a brand-new PeonPing draft pack — invoked headlessly as: "Use the peon-ping-create-pack skill to draft a pack: name=<n> flavor=<f> vibe=<v> draft_root=<dir>. Follow the skill exactly." Authors all 7 CESP categories honoring the vibe, writes openpeon.json (draft-stamped) and prompts.json, renders every sound via scripts/pack-render.py, and always ends by telling the human to run `peon eval <name>`.
Log exercise reps for the Peon Trainer. Use when user says they did pushups, squats, or wants to log reps. Examples - "/peon-ping-log 25 pushups", "/peon-ping-log 30 squats", "log 50 pushups".
Internal — invoked headlessly by the peon eval server; humans should run `peon eval <pack>` instead. Execute one PeonPing reroll job — invoked headlessly by the peon eval server as: "Use the peon-ping-remix skill to execute the reroll job at <path>". Reads the job JSON (scope, category, index, caption), rewrites the affected sound prompt(s) to honor the caption, re-renders via scripts/pack-render.py, and logs the change to eval-log.json.
Rename the current Claude session for peon-ping notifications and terminal tab title. Use when user wants to give this session a custom name like "/peon-ping-rename Auth Refactor". Call with no argument to reset to auto-detect.
Toggle peon-ping sound notifications on/off. Use when user wants to mute, unmute, pause, or resume peon sounds during a Claude Code session. Also handles config changes like volume, pack rotation, categories — any peon-ping setting.
Set which voice pack (character voice) plays for the current chat session. Automatically enables session_override rotation mode if not already set. Use when user wants a specific character voice like GLaDOS, Peon, or Kerrigan for this conversation.
Subagents overview
What people ask about peon-ping
What is PeonPing/peon-ping?
PeonPing/peon-ping is subagents for the Claude AI ecosystem. Warcraft III Peon voice notifications (+ more!) for Claude Code, Codex, IDEs, and any AI agent. Stop babysitting your terminal. Employ a Peon today. It has 5.1k GitHub stars and its last recorded update is dated 2026-10-19.
How do I install peon-ping?
You can install peon-ping by cloning the repository (https://github.com/PeonPing/peon-ping) or following the README instructions on GitHub. ClaudeWave also provides quick install blocks on this page.
Is PeonPing/peon-ping safe to use?
Our security agent has analyzed PeonPing/peon-ping and assigned a Trust Score of 97/100 (tier: Verified). See the full breakdown of passed checks and flags on this page.
Who maintains PeonPing/peon-ping?
PeonPing/peon-ping is maintained by PeonPing. The last recorded GitHub activity is dated 2026-10-19, with 33 open issues.
Are there alternatives to peon-ping?
Yes. On ClaudeWave you can browse similar subagents at /categories/agents, sorted by popularity or recent activity.