PeonPing/peon-ping is a cross-platform audio notification tool for AI coding agents, integrating Warcraft III voice lines and banners. It supports multiple adapters and install modes, with recent releases updating logging and registry hooks.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
peon-ping provides game-character voice notifications and on-screen banners for AI coding agents, aiming to alert users when agents need attention or complete tasks. It claims compatibility with Claude Code, AMP, Codex, Cursor, OpenCode, and other MCP clients, and exposes a wide range of adapters and sound packs.
How it works
The project implements a coding-event sound pack system (CESP) and adapters for various IDEs/agents. It offers commands to install packs, manage hooks, and control playback/notifications. It includes a Home Manager module for declarative configuration and supports multiple installation paths (Homebrew, installer script, Windows installer, Nix, and cloning from git).
Getting started
Install
Option 1: Homebrew (recommended)
brew install PeonPing/tap/peon-ping
Then run peon-ping-setup to register hooks and download sound packs. macOS and Linux.
Option 2: Installer script (macOS, Linux, WSL2)
curl -fsSL https://raw.githubusercontent.com/PeonPing/peon-ping/main/install.sh | bash
Option 3: Windows installer via PowerShell script
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/PeonPing/peon-ping/main/install.ps1" -OutFile ".\install.ps1" -UseBasicParsing
powershell -ExecutionPolicy Bypass -File .\install.ps1
Option 4: Clone and inspect first
git clone https://github.com/PeonPing/peon-ping.git
cd peon-ping
./install.sh
Option 5: Nix (macOS, Linux)
nix run github:PeonPing/peon-ping -- status
nix run github:PeonPing/peon-ping -- packs install peon
How to use
The README provides extensive CLI commands for managing packs, sounds, and notifications. Examples include toggling sound, listing/installing packs, and configuring notification preferences. A detailed list of commands is included under Quick controls and various sections.
Recent releases
- v2.35.1 (2026-07-24): Full Changelog: https://github.com/PeonPing/peon-ping/compare/v2.35.0...v2.35.1
- v2.35.0 (2026-07-19): Fixes for logging user prompt content and uninstaller handling symlinks
- v2.34.0 (2026-07-07): feat(codex): 增加 stable hooks 自动注册
- v2.33.0 (2026-07-02): Fix leading audio clipping; fix install/uninstall deleting other too
- v2.32.0 (2026-06-27): feat(install): --openpeon tool-agnostic install root (~/.openpeon); feat(tmux): configurable tab title/color passthrough
Traction
4977 stars, 367 forks, 25 open_issues as reported.
Behind the repo
The README lists a variety of adapters and integration points (Claude Code, Amp, Codex, Cursor, OpenCode, Kilo CLI, Kiro, Kimi Code, Windsurf, Antigravity, Rovo Dev CLI, DeepAgents, Qwen Code, iFlow CLI, Trae, Kiro IDE, ECA) and references an og-packs registry and openpeon.com, indicating a broad ecosystem and multiple installation/How-it-works integration points.
Caveats
- License: MIT
- Created: 2026-02-09
- Last push: 2026-07-24
- Language: Shell
- Open issues count: 25
- Audio backend notes for WSL2 and Windows dependencies are described in the installer notes (ffmpeg for non-WAV packs, various backends).