peon-ping CLI
Sound and on-screen notifications for coding agents: game voice lines when the agent finishes or waits for permission
- 5,113 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Downloads sound packs and registers hooks in the agent's configuration
- Installs via a network script and runs shell commands
Install
- Works in
Manual install
brew install PeonPing/tap/peon-ping
peon-ping-setupmacOS and Linux. The setup command registers hooks and downloads sound packs.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Downloads sound packs and registers hooks in the agent's configuration
- Installs via a network script and runs shell commands
This is third-party code. Review the repository files before installing.
What it does
peon-ping plays voice lines and shows banners when the agent finishes or asks for permission, so you do not have to watch the terminal. It hooks into agent events: for Claude Code the hook is built in, other harnesses use adapters, and events are normalized to a common format. Sound packs come from games such as Warcraft, StarCraft, Portal and Zelda, and you can install, switch, bind them to a project directory and build your own. Control goes through the peon CLI: pause, volume, status, rotation, pack management, plus auto-muting on do not disturb. There is also an MCP server through which the agent picks the sound itself via a tool call instead of playing a fixed one on every event.
Who it is for. For developers who run an agent in a terminal or IDE and do not want to keep checking whether it is done.
Good fit when
- You want a cue when the agent finishes or waits for permission
- You need notifications across several agents and IDEs through one mechanism
- You want the agent to pick the event sound itself via MCP
- You need notifications during remote work over SSH or in a devcontainer
Not a fit when
- You do not want sound or on-screen notifications in your setup
- Your environment supports no hooks and none of the adapters fit
Example request
Set up peon-ping so Claude Code plays a sound when it finishes or asks for permissionLimitations
The tool targets macOS, Linux, WSL2 and Windows, and each system has its own audio quirks. On WSL2 audio plays through Windows, and on Windows 11 24H2 and newer MP3 packs need ffmpeg. Some CLI commands on Windows are still being brought to parity. During install the tool downloads sound packs and registers hooks in the agent's configuration. The MCP server needs Node.js 18 or newer.
How to disable. To mute temporarily use peon toggle or peon pause. To remove it fully run uninstall.sh or uninstall.ps1 from the peon-ping hooks directory.
FAQ
Which agents does it work with?
For Claude Code the hook is built in; many other harnesses and IDEs have adapters that normalize events to a common format. It also works with any MCP client through the built-in MCP server.
Can I mute it temporarily?
Yes, with peon toggle or peon pause, and with a slash command in Claude Code. You can also enable auto-muting on do not disturb.
Discussion
No questions or reviews yet.
Related
CLI toolsechook plays a sound, a desktop toast or a message when Claude Code, Cursor or Codex finishes or waits for your permission
A realtime voice layer on top of Claude Code, Codex and OpenCode that keeps talking and listening while background tasks run in parallel
Hook-driven sounds for coding agents: starts, failures, completions and even individual Bash commands each get their own cue
Background music for a coding agent: it plays while the agent works and stops when it waits for your input.
Voice control of Claude Code and Codex sessions on your machines: a small agent on each box links it to the pitupitu cloud.
Agent Notifications is an alert plugin that includes project and branch context in Claude Code and Codex desktop messages.
README in short
The README presents peon-ping as a sound and on-screen notification tool for agents that do not signal when they finish or need permission. It connects via hooks: built in for Claude Code and through adapters for dozens of other harnesses and IDEs that normalize events to a common standard. There are game sound packs, control through the peon CLI, a trainer mode, support for remote work over SSH and in devcontainers, and mobile notifications. It also documents an MCP server through which the agent picks a sound via a tool call. Installation is available via Homebrew, a script for macOS, Linux and WSL2, a Windows installer, cloning the repository, or Nix.