Peon Ping

Active
GitHub Shell MIT

Description

Warcraft III Peon voice notifications for Claude Code, Codex, IDEs, and any AI agent — stop babysitting your terminal, employ a Peon today.

Key Features

  • Game character voice lines and visual overlay notifications when AI agents need attention
  • Supports 16+ AI coding tools: Claude Code, Codex, Cursor, Copilot, Windsurf, OpenCode, and more
  • Multi-platform: macOS, Linux, WSL2, Windows, SSH, MSYS2
  • MCP server integration — let agents pick their own sounds
  • Extensible sound packs from Warcraft, StarCraft, Portal, Zelda, and more
  • Homebrew, Nix, and installer script support with declarative configuration

Use Cases

💡 Getting audible alerts when your AI coding agent finishes a task or needs input
💡 Reducing idle time by not babysitting the terminal during AI agent runs
💡 Adding fun game-themed voice feedback to development workflows
💡 Using MCP to let agents dynamically select notification sounds

Quick Start

```bash
# Install via Homebrew (recommended)
brew install PeonPing/tap/peon-ping
peon-ping-setup

# Or via installer script
curl -fsSL https://raw.githubusercontent.com/PeonPing/peon-ping/main/install.sh | bash

# Verify
peon-ping status

# Start using with Claude Code or your preferred AI coding tool
```

Related Projects