PeonPing/peon-ping

Warcraft III Peon voice notifications (+ more!) for Claude Code, Codex, IDEs, and any AI agent. Stop babysitting your terminal. Employ a Peon today.

What it solves

AI coding agents often run tasks in the background without notifying the user when they finish or require input. This leads to lost focus and wasted time as developers tab back and forth to check progress. This project provides an automated notification system that alerts you via voice lines and on-screen banners when your agent needs attention.

How it works

It integrates with various AI coding tools (such as Claude Code, Cursor, and GitHub Copilot) using hook scripts. When the agent completes a task, hits an error, or requires user input, the software triggers a sound pack (based on the Coding Event Sound Pack Specification) and displays a visual overlay on your desktop. It supports multiple platforms including macOS, Linux, and Windows (via WSL2 or native PowerShell), and allows for custom sound pack management through a CLI.

Who it’s for

Developers who use AI coding agents and want to maintain their flow state by receiving non-intrusive, thematic audio and visual feedback when their AI assistant finishes a task or requires interaction.

Highlights

  • Supports a wide range of AI coding agents including Claude Code, Cursor, Windsurf, and GitHub Copilot.
  • Implements the open-source Coding Event Sound Pack Specification (CESP) for standardized event sounds.
  • Provides interactive CLI controls to manage volume, sound packs, and notification settings.
  • Includes visual overlay themes (e.g., Neon, Glass, Jarvis) and supports custom sound pack creation.
  • Offers flexible installation options including Homebrew, Nix, and direct scripts for various environments.

Related

  • Project
    777genius/agent-notifications

    A cross-platform utility that provides desktop notifications and webhook alerts for various AI agent CLIs, helping users track task progress and agent requests in real-time.

  • Project
    whaleyxbt/claude-motion

    A motion design toolkit that gives AI coding agents the design taste, self-review capabilities, and a sound engine needed to create professional motion graphics and simulations.

  • Project
    pskoett/pskoett-ai-skills

    A collection of modular skills and feedback loops designed to improve the reliability, quality, and self-improvement capabilities of AI coding agents.

  • Project
    spacering-net/codeg

    A multi-agent coding workspace that integrates various AI coding agents into a single visual interface, allowing them to collaborate and work on the same project.

  • Project
    ZekerTop/ai-cli-complete-notify

    AI CLI Complete Notify watches Claude, Codex, OpenCode, Gemini, ZCode (and Herdr) CLI tools, detects when a turn finishes (via log‑watch or native hooks), and pushes a notification through desktop toast, sound/TTS, Telegram, email, or custom webhooks. You can set per‑source enable flags, duration thresholds, and optional LLM‑generated summaries. The project ships a Tauri‑based GUI (Windows, macOS, Linux) and a CLI sidecar (`ai-reminder`) for background watching, one‑off command wrapping, or manual start/stop timers. Configuration lives in a separate `.env` file (webhook URLs, SMTP, LLM API, etc.).