Skip to main content

Stop babysiting your terminal

AI coding agents don’t notify you when they finish tasks or need permission. You tab away, lose focus, and waste 15 minutes getting back into flow. PeonPing fixes this with voice lines and bold on-screen banners from Warcraft, StarCraft, Portal, Zelda, and more — works with Claude Code, Cursor, OpenCode, Amp, GitHub Copilot, and any MCP client.

Installation

Install PeonPing via Homebrew, curl, or Windows installer

Quickstart

Get your first peon notification in under 2 minutes

Sound Packs

Browse 165+ packs from your favorite games

Integrations

Connect to Claude Code, Cursor, OpenCode, and 10+ other IDEs

How it works

PeonPing hooks into your AI coding agent and plays sounds + shows notifications when key events happen:
EventCESP CategoryExamples
Session startssession.start”Ready to work?”, “Yes?”, “What you want?”
Task finishestask.complete”Work, work.”, “I can do that.”, “Okie dokie.”
Permission neededinput.required”Something need doing?”, “Hmm?”, “What you want?”
Tool or command errortask.error”I can’t do that.”, “Son of a bitch!”
Rate or token limit hitresource.limit”Zug zug.” (pack dependent)
Rapid prompts (3+ in 10s)user.spam”Me busy, leave me alone!”
Plus large overlay banners on every screen (macOS/WSL/MSYS2) and terminal tab titles (● project: done) — you’ll know something happened even if you’re in another app.

Key features

Voice notifications

Game character voice lines from 165+ sound packs

Visual alerts

Large overlay banners or standard system notifications

Multi-IDE support

Claude Code, Cursor, OpenCode, Amp, GitHub Copilot, and more

Remote development

Audio relay for SSH, devcontainers, and Codespaces

Mobile push

Get notified on your phone via ntfy, Pushover, or Telegram

MCP server

Let AI agents pick their own sounds via Model Context Protocol

Platform support

PeonPing works across all major platforms:
  • macOS — Native afplay audio + JXA Cocoa overlays
  • Linux — PipeWire/PulseAudio + notify-send
  • Windows — Native PowerShell audio + Windows Forms overlays
  • WSL2 — Full Windows integration
  • SSH/Remote — Audio relay routes sound to your local machine

Open standard

PeonPing implements the Coding Event Sound Pack Specification (CESP) — an open standard for coding event sounds that any agentic IDE can adopt. Sound packs use the openpeon.json manifest format, making them portable across any CESP-compatible tool.

Next steps

Install PeonPing

Choose your installation method

Quick start

Get set up in under 2 minutes

Build docs developers (and LLMs) love