Peon Ping
Game character voice notifications for Claude Code, Codex, IDEs, and any AI agent.
Last verified:
What is Peon Ping?
Peon Ping is an open-source terminal notification tool that plays game character voice lines when AI coding agents finish tasks, need permission, or encounter errors. It works with Claude Code, Codex, Cursor, and more, and includes an MCP server so agents can choose their own sounds.
Peon Ping pricing
Pricing model: Freemium
PeonPing is completely free and open source under the MIT license. There is no paid tier or subscription. All features including all 160+ sound packs, MCP server, Peon Trainer mode, and animated desktop pet are free. Installation is free via Homebrew (brew install PeonPing/tap/peon-ping) or curl one-liner (curl -fsSL peonping.com/install | bash).
Peon Ping pros
- Open source with MIT license
- 160+ game-themed sound packs available
- Native support for Claude Code
- Works with 10+ AI agents and IDEs
- Cross-platform: macOS, Linux, Windows, WSL2
- Large overlay banners visible across all apps
- Desktop notifications when terminal isn't focused
- Volume control for office-friendly use
- No-repeat tracking prevents annoying loops
- Category toggles for granular control
- Terminal tab titles show status updates
- MCP server lets AI choose sounds
- SSH/remote audio relay to local machine
- Peon Trainer fitness reminder mode
- Animated desktop orc pet companion
- Easy installation via Homebrew or one-liner
- Inspired native VS Code sound hooks (50M+ users)
- Create and share your own sound packs
- 14 languages supported in sound packs
- Lightweight shell tool that doesn't interfere with workflow
Peon Ping cons
- Can get noisy with rapid poll cycles
- Primarily focused on AI coding agents
- Overlay banners may distract some users
- Requires terminal/IDE integration setup
- Some sound packs are community-made (unofficial)
- No official mobile app (push via ntfy/Pushover/Telegram only)
- Windows overlay uses Windows Forms (less polished)
- Learning curve for advanced configuration
Frequently asked questions about Peon Ping
What is PeonPing and what does it do?
PeonPing is an open-source terminal notification tool that plays game character voice lines when your AI coding agent finishes tasks, needs permission, or encounters errors. It prevents you from 'babysitting your terminal' by providing audio and visual alerts so you can stay focused on other work while knowing exactly when your AI agent needs attention.
Which AI agents and IDEs does PeonPing work with?
PeonPing has native support for Claude Code and adapters for Codex, Cursor, OpenCode, Kilo CLI, Kiro, Windsurf, Google Antigravity (Gemini CLI), OpenClaw, GitHub Copilot, Amp, and any MCP-compatible agent. It works across macOS, Linux, Windows, and WSL2.
How do I install PeonPing?
Installation is simple: on macOS use 'brew install PeonPing/tap/peon-ping', or use the one-liner on any platform: 'curl -fsSL peonping.com/install | bash'. The installer sets up the tool and integrates with your terminal automatically.
What sound packs are available?
There are 160+ sound packs including Warcraft III (Orc Peon, Human Peasant), StarCraft (Battlecruiser, Sarah Kerrigan), Red Alert 2 (Soviet Engineer), Team Fortress 2 (TF2 Engineer), GLaDOS from Portal, Zelda, and many more in 14 languages. Browse the full catalog at openpeon.com or run 'peon packs list --registry'.
How do I switch to a different sound pack?
Swap packs with one line in your config file. Run 'peon packs install [pack-name]' to add a pack, then set it as active in your configuration. You can also build a custom install command on the website that pre-selects your favorite packs.
What events trigger notifications?
PeonPing triggers on six event categories: session starts (greeting), task complete (acknowledgment), permission needed (input required), tool/command error, rate or token limit hit, and rapid prompts (3+ in 10 seconds). Each category has distinct voice lines and you can toggle them individually.
Can I create my own sound pack?
Yes! Create a GitHub repo with your sounds in openpeon.json manifest format, register it at openpeon.com, and it becomes available to everyone. The CESP (Coding Event Sound Pack Specification) makes packs portable across any compatible tool.
What is the Peon Trainer mode?
Peon Trainer is a fitness feature that reminds you to do 300 pushups and squats daily. It greets you at session start with a workout reminder, lets you log reps mid-conversation via '/peon-ping-log 25 pushups', sends periodic nagging reminders every ~20 minutes, and celebrates when you hit your daily goal.
Does PeonPing work with remote development?
Yes, PeonPing supports SSH and remote development through audio relay that routes sound to your local machine. It also works with devcontainers and Codespaces, ensuring you get notifications even when developing remotely.
Is PeonPing free or does it cost money?
PeonPing is completely free and open source under the MIT license. All features including all 160+ sound packs, MCP server, Peon Trainer mode, and animated desktop pet are free with no paid tier or subscription required.