# peonping/peon-ping **Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/peonping-peon-ping).** 2,550 stars · 175 forks · Shell · mit ## Links - GitHub: https://github.com/PeonPing/peon-ping - Homepage: https://www.peonping.com - awesome-repositories: https://awesome-repositories.com/repository/peonping-peon-ping.md ## Topics `ai` `ai-engineering` `antigravity` `claude-code` `codex` `cursor` `opencode` `terminal` ## Description Peon Ping is an MCP-based sound server that plays game character voice lines and desktop notifications triggered by AI coding agent events. It functions as a multi-functional system combining desktop notifications, fitness gamification, sound pack management, and audio feedback for coding environments, all accessible through the Model Context Protocol. The project distinguishes itself through a modular architecture that includes adapter-based IDE integration, translating events from multiple agentic IDEs into a standardized sound format. It features an animated desktop pet engine that renders sprite-based characters reacting to coding events, a config-driven sound behavior system controlling volume and category toggling, and a file-based sound pack registry managing over 160 sound packs across 14 languages. The system also provides history-based deduplication to prevent repeated voice lines, a lightweight remote audio relay for forwarding sounds from remote servers, and a push notification bridge delivering alerts to mobile devices and desktop popups. Additional capabilities include daily fitness goal tracking with workout rep logging, sound clip previewing in the browser, custom sound pack creation through GitHub repositories, and sound and notification muting that persists across sessions. The project supports remote audio relay from SSH, devcontainer, or Codespace sessions, and displays a terminal tab status indicator with project name and task completion dots. ## Tags ### Artificial Intelligence & ML - [Sound Servers](https://awesome-repositories.com/f/artificial-intelligence-ml/mcp-servers/sound-servers.md) — Plays game character voice lines and desktop notifications triggered by AI coding agent events via MCP. - [Sound Trigger Servers](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-agent-servers/sound-trigger-servers.md) — Exposes a play_sound function through an MCP server so AI agents can trigger voice lines directly. ([source](https://peonping.com/)) - [Sound Tool Servers](https://awesome-repositories.com/f/artificial-intelligence-ml/mcp-servers/sound-tool-servers.md) — Triggers voice lines directly by calling a tool from any MCP-compatible client. ([source](https://www.peonping.com)) ### Part of an Awesome List - [Sound Pack Browsing and Switching](https://awesome-repositories.com/f/awesome-lists/media/sound-libraries/sound-pack-browsing-and-switching.md) — Lists, previews, and switches between 43+ curated sound packs from games like Warcraft and StarCraft. ([source](https://cdn.jsdelivr.net/gh/peonping/peon-ping@main/README.md)) - [Custom Sound Pack Creation](https://awesome-repositories.com/f/awesome-lists/media/sound-libraries/custom-sound-pack-creation.md) — Registers a GitHub repository of sound clips so anyone can install and use a custom character pack. ([source](https://www.peonping.com)) ### Development Tools & Productivity - [Event Translation Adapters](https://awesome-repositories.com/f/development-tools-productivity/ide-context-adapters/event-translation-adapters.md) — Translates events from various agentic IDEs into a standard sound format using pluggable adapters. - [Event Translation Adapters](https://awesome-repositories.com/f/development-tools-productivity/ide-integrations/event-translation-adapters.md) — Provides pluggable adapters that translate events from multiple agentic IDEs into a standardized sound format. ([source](https://www.peonping.com)) - [Sound Pack Installers](https://awesome-repositories.com/f/development-tools-productivity/cli-command-extensions/community-extension-installers/sound-pack-installers.md) — Downloads and installs new character voice packs from a community registry using a CLI command. ([source](https://www.peonping.com)) ### Graphics & Multimedia - [Character Voice Line Playback](https://awesome-repositories.com/f/graphics-multimedia/audio-music/audio-playback/dialogue-voice-playback/character-voice-line-playback.md) — Plays a random voice line from a game character pack when a coding agent starts a session or finishes a task. ([source](https://cdn.jsdelivr.net/gh/peonping/peon-ping@main/README.md)) - [Sound Pack Managers](https://awesome-repositories.com/f/graphics-multimedia/sound-effect-libraries/sound-effects-playback/sound-pack-managers.md) — Selects from over 160 game character sound packs and controls playback volume and category toggling. - [Desktop Pet Animations](https://awesome-repositories.com/f/graphics-multimedia/2d-sprite-animations/character-model-animations/desktop-pet-animations.md) — Renders an animated orc character that reacts to coding events with sleeping, waking, and celebrating animations. ([source](https://www.peonping.com)) ### Software Engineering & Architecture - [Sound Pack Selections](https://awesome-repositories.com/f/software-engineering-architecture/theme-configuration-engines/sound-theme-engines/sound-pack-selections.md) — Provides a manager that selects from over 160 game character sound packs across 14 languages. ([source](https://www.peonping.com)) - [Sound Pack Switching](https://awesome-repositories.com/f/software-engineering-architecture/theme-configuration-engines/sound-theme-engines/sound-pack-switching.md) — Cycles through or selects from over 40 game character sound packs with random rotation or manual CLI switching. ([source](https://peonping.com/)) - [Audio Behavior Configurations](https://awesome-repositories.com/f/software-engineering-architecture/theme-configuration-engines/sound-theme-engines/audio-behavior-configurations.md) — Adjusts volume, enables or disables specific sound categories, sets spam thresholds, and configures pack rotation. ([source](https://cdn.jsdelivr.net/gh/peonping/peon-ping@main/README.md)) ### System Administration & Monitoring - [Alert Notification Systems](https://awesome-repositories.com/f/system-administration-monitoring/alert-notification-systems.md) — Sends audio alerts, desktop popups, and mobile push notifications when coding tasks complete or need attention. ### Business & Productivity Software - [Fitness Gamification Tools](https://awesome-repositories.com/f/business-productivity-software/gamification-platforms/developer-productivity-gamification/fitness-gamification-tools.md) — Prompts users to complete daily pushup and squat goals through session reminders and mid-conversation logging. ### DevOps & Infrastructure - [Desktop Notification Bridges](https://awesome-repositories.com/f/devops-infrastructure/push-notification-services/desktop-notification-bridges.md) — Delivers alerts to mobile devices and desktop popups when the terminal is unfocused. ### Education & Learning Resources - [Sound Pack Registries](https://awesome-repositories.com/f/education-learning-resources/language-packs/local-language-pack-testing/sound-pack-registries.md) — Manages over 160 sound packs across 14 languages through a community registry with CLI-based installation. ### Networking & Communication - [Mobile Push Notification Deliveries](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/messaging-notification-systems/messaging-services/notification-delivery-services/push-notification-providers/mobile-push-notification-deliveries.md) — Delivers push notifications to your phone when coding tasks finish or need attention. ([source](https://cdn.jsdelivr.net/gh/peonping/peon-ping@main/README.md)) - [Remote Audio Relays](https://awesome-repositories.com/f/networking-communication/peer-to-peer-networking/supernode-relay-routing/audio-relay-fallbacks/remote-audio-relays.md) — Routes audio and desktop notifications from SSH, devcontainer, or Codespace sessions to the local machine. ([source](https://cdn.jsdelivr.net/gh/peonping/peon-ping@main/README.md)) - [Notification Delivery Fixes](https://awesome-repositories.com/f/networking-communication/push-notifications/notification-delivery-fixes.md) — Pushes alerts when the terminal is not focused, ensuring you never miss a permission prompt. ([source](https://www.peonping.com)) ### Programming Languages & Runtimes - [Audio Behavior Configurations](https://awesome-repositories.com/f/programming-languages-runtimes/audio-behavior-configurations.md) — Controls volume, category toggles, spam thresholds, and pack rotation through a single configuration file. ### User Interface & Experience - [Reactive Desktop Pets](https://awesome-repositories.com/f/user-interface-experience/character-encoding-support/sprite-animations/reactive-desktop-pets.md) — Renders a sprite-based animated character that reacts to coding events with state-driven animations.