# PeonPing/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.

Repository: https://github.com/PeonPing/peon-ping
Canonical: https://ross.abutalabs.com/products/peon-ping
Homepage: https://www.peonping.com
Language: Shell
License: MIT
License Family: permissive
Topics: ai, ai-engineering, antigravity, claude-code, codex, cursor, opencode, terminal
Last push: 2026-08-26T22:49:37+00:00

## Health v2 (maintenance only)
Score: 82/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 99, longevity 14
- inputs: {"age_days": 205, "days_push": 7, "days_rel": 7, "gap_med": 1.5, "n_releases_24m": 53}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5003, forks 381 (observed 2026-08-28T04:09:04.509787+00:00)

## What it is
peon-ping is a shell-based notification tool that plays game character voice lines (Warcraft, StarCraft, Portal, Zelda) and shows visual overlays when AI coding agents finish tasks or need permission. It integrates with Claude Code, Codex, Cursor, and many other AI agents via hooks and adapters, plus MCP for agent-chosen sounds.

## Use cases
- get notified when claude code finishes a task
- stop watching the terminal while an ai agent works
- play a sound when my coding agent needs permission
- add audio alerts to cursor or codex
- let my ai agent pick its own notification sound via mcp
- terminal notification sounds for ai coding assistants

## When to choose
- you use AI coding agents (Claude Code, Codex, Cursor, etc.) and tab away while they work
- you want fun, game-themed audio and visual notifications instead of silence
- you want broad cross-platform support including WSL2, SSH, and many agent adapters
- you want an MCP server so agents can choose their own sounds

## When to avoid
- you want silent or purely professional notification tones
- you need a GUI application rather than a shell-based tool
- you don't use AI coding agents or terminal-based workflows

## Facets
- artifact type: cli-tool
- maturity: active
- function: developer-tools, terminal-ui, plugin-system, mcp
- domain: developer-tools
- platform: windows, cli, cross-platform
- tags: notifications, sound-alerts, claude-code, ai-coding-agents, voice-lines, shell-script, developer-experience, command-line, ai-agents, automation, macos, linux

## Member repositories
- PeonPing/peon-ping (main) score 82

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:04.509787+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:17:34.978517+00:00, confidence not recorded.
  - readme: https://github.com/PeonPing/peon-ping (fetched 2026-08-28T04:09:04.509787+00:00, sha 50bd97917756)
  - homepage: https://www.peonping.com (fetched 2026-08-29T08:58:27.086967+00:00, sha 258b4f8e3bf0)
- Data as of 2026-08-30T08:39:29.467469+00:00.