Skip to content

feat(peon-ping): 🎮 add peon-ping feature for AI agent sound notifications#11

Merged
baxyz merged 3 commits intomainfrom
peon-ping
Mar 30, 2026
Merged

feat(peon-ping): 🎮 add peon-ping feature for AI agent sound notifications#11
baxyz merged 3 commits intomainfrom
peon-ping

Conversation

@baxyz
Copy link
Copy Markdown
Contributor

@baxyz baxyz commented Mar 30, 2026

Summary

New devcontainer feature that installs peon-ping — game character voice notifications (Warcraft, StarCraft, Portal, Zelda…) when your AI coding agent finishes or needs permission. Includes the Peon Pet VS Code sidebar extension.

What's included

New files

  • src/peon-ping/devcontainer-feature.json — Feature manifest with options, Peon Pet extension, and settings
  • src/peon-ping/install.sh — Non-interactive installation script with multi-IDE hook configuration
  • src/peon-ping/README.md — Full documentation (usage, options, relay setup, IDE-specific instructions)
  • test/peon-ping/test.sh — Tests for binary presence, config files, adapters, and prerequisites

Modified files

  • .github/workflows/test.yml — Added peon-ping to CI matrix (ubuntu:latest + devcontainers/base:ubuntu)
  • README.md — Added peon-ping section, table entry, and usage example

Options

Option Type Default Description
packs string default Sound packs: default (5 curated), all (165+), or CSV
noRc boolean true Skip shell rc modifications
ideSetup string vscode IDEs to configure: all, none, or CSV (e.g. vscode,cursor)
volume string 0.5 Default volume (0.0–1.0)

Usage

{
    "features": {
        "ghcr.io/helpers4/devcontainer/peon-ping:1": {}
    }
}

Audio in devcontainers

peon-ping auto-detects devcontainer environments and routes audio to host.docker.internal:19998. The user must run peon relay --daemon on the host machine.

IDE support

  • Claude Code — hooks registered automatically by the peon-ping installer
  • VS Code / Copilot — helper script peon-ping-copilot-setup generates .github/hooks/hooks.json
  • Cursor — hooks written to ~/.cursor/hooks.json when enabled
  • Codex — notify config added to ~/.codex/config.toml when enabled
  • 15+ other IDEs — adapters available at ~/.claude/hooks/peon-ping/adapters/

baxyz added 2 commits March 30, 2026 23:38
- peon-ping installer requires a supported audio player (pw-play, paplay, ffplay, mpv, or aplay)
- Add alsa-utils (provides aplay) to prerequisites to satisfy this dependency
…uild

- The peon-ping installer tests sound playback on exit, which fails in
  Docker builds where no audio device is available
- Changed to tolerate non-zero exit from installer and verify the binary
  exists ourselves instead
- Moved PEON_BIN variable declaration earlier to avoid redeclaration
@baxyz baxyz merged commit eb909c9 into main Mar 30, 2026
16 checks passed
@baxyz baxyz deleted the peon-ping branch March 30, 2026 22:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant