peon-ping is a cross-platform sound and notification system for AI coding assistants, intercepting lifecycle events from tools like Claude Code, Cursor, Copilot, and Gemini to play contextual audio feedback (e.g., Warcraft Peon voice lines) and show desktop notifications. The architecture consists of a core hook script (`peon.sh` on Unix, `peon.ps1` embedded in `install.ps1` on Windows), a set of thin adapter scripts that translate each IDE's native event format into a canonical CESP JSON schema, and an MCP server (`mcp/peon-mcp.js`) enabling agents to trigger sounds programmatically. Key data flows: adapter receives an event → pipes JSON to peon.sh → parses config/state → resolves sound pack via override hierarchy → plays audio via platform-appropriate backend → shows notification via overlay or toast. External dependencies include system audio players (afplay, pw-play, ffplay, etc.), ElevenLabs/MiniMax TTS APIs, ntfy.sh/Pushover/Telegram for mobile notifications, and a remote pack registry. The project also includes a trainer mode for exercise reminders, structured debug logging (ADR-002), and an automated agent-driven project management system (gitban) for its own development. Reusable components include the MCP server (can be extracted as a standalone tool), the Windows audio playback module with fallback chain (`scripts/win-play.ps1`), and the TypeScript utilities for debounce/spam detection (`peon-ping-internals.ts`). The adapter pattern is well-documented and could be replicated for new IDEs. The project is actively maintained with frequent commits, comprehensive multi-language tests (BATS, Pester, Vitest), and clear separation of concerns despite the complexity of supporting 20+ IDE integrations.