Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/test.yml
Original file line number Diff line number Diff line change
Expand Up @@ -105,7 +105,7 @@ jobs:
- features: auto-header
baseImage: mcr.microsoft.com/devcontainers/base:ubuntu

# peon-ping - works on any base image with curl and python3
# peon-ping - works on any base image with curl and jq
- features: peon-ping
baseImage: ubuntu:latest
- features: peon-ping
Expand Down
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -77,7 +77,7 @@ version bump" below.
| `git-absorb` | 1.2.3 | git-absorb from GitHub releases |
| `bitwarden-secrets-manager` | 1.2.4 | `bws` CLI from bitwarden/sdk-sm GitHub releases, token-only auth, no persisted state |
| `dotfiles-sync` | 1.2.3 | Sync Git/SSH/GPG/npm/gh config from host; SSH key files opt-in (dependsOn helpers4-common) |
| `peon-ping` | 1.3.1 | AI agent sound notifications |
| `peon-ping` | 1.3.2 | AI agent sound notifications: one script, hooks ask the host's peon-ping relay to play a category (no packs in the container) |
| `shell-history-per-project` | 1.2.3 | Persistent shell history (zsh/bash/fish) |
| `org-workspace` | 1.0.1 | Clones every repo of a GitHub org into sibling `/workspaces` folders + generates/merges a multi-root `.code-workspace` (dependsOn helpers4-common, github-dev) |

Expand Down
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -255,13 +255,13 @@ Automatically configures file headers with customizable templates based on proje

### peon-ping

Installs [peon-ping](https://peonping.com/) for game character voice notifications when your AI coding agent finishes or needs permission. Includes the Peon Pet VS Code extension.
Plays your host's [peon-ping](https://peonping.com/) game-character sounds when your AI coding agent finishes or needs permission. Includes the Peon Pet VS Code extension.

**Key benefits:**
- Sound notifications from 165+ packs (Warcraft, StarCraft, Portal, Zelda…)
- Multi-IDE hooks: Claude Code, Copilot, Cursor, Codex, and more
- Uses the pack and volume of your host's peon-ping — nothing to configure or keep in sync
- Hooks for Claude Code, Cursor and Codex, always all configured
- Animated Peon Pet sidebar companion in VS Code
- Devcontainer-aware audio relay to host machine
- No download, no `initializeCommand`: sound goes through a relay you start once on your host
- Non-interactive, idempotent installation

[📖 Documentation](./src/peon-ping/README.md)
Expand Down Expand Up @@ -337,7 +337,7 @@ Features from this repository are available via GitHub Container Registry. Refer
| [git-absorb](./src/git-absorb) | Automatic absorption of staged changes into logical commits | [README](./src/git-absorb/README.md) |
| [dotfiles-sync](./src/dotfiles-sync) | Sync local Git, SSH, GPG, and npm config — works on macOS, Linux, WSL, Codespaces | [README](./src/dotfiles-sync/README.md) |
| [bitwarden-secrets-manager](./src/bitwarden-secrets-manager) | `bws` CLI from Bitwarden's own GitHub releases, token-only auth, no persisted state | [README](./src/bitwarden-secrets-manager/README.md) |
| [peon-ping](./src/peon-ping) | AI agent sound notifications with multi-IDE hooks and Peon Pet extension | [README](./src/peon-ping/README.md) |
| [peon-ping](./src/peon-ping) | AI agent sound notifications played by your host's peon-ping, multi-IDE hooks and Peon Pet extension | [README](./src/peon-ping/README.md) |
| [org-workspace](./src/org-workspace) | Clone an entire GitHub org into sibling workspace folders with one feature | [README](./src/org-workspace/README.md) |

## Dependency Graph
Expand Down
308 changes: 72 additions & 236 deletions src/peon-ping/README.md

Large diffs are not rendered by default.

35 changes: 4 additions & 31 deletions src/peon-ping/devcontainer-feature.json
Original file line number Diff line number Diff line change
@@ -1,38 +1,11 @@
{
"id": "peon-ping",
"version": "1.3.1",
"version": "1.3.2",
"name": "Peon Ping — AI Agent Sound Notifications",
"description": "Installs peon-ping and the Peon Pet VS Code extension for game character voice notifications when your AI coding agent finishes or needs permission. Supports VS Code/Copilot, Cursor, and Codex with audio relay for devcontainers. Also self-heals your devcontainer setup.",
"description": "Plays your host's peon-ping sounds when your AI coding agent finishes or needs permission — Claude Code, Cursor and Codex hooks, plus the Peon Pet VS Code extension. Nothing to configure: the sound and pack come from your host. Also self-heals your devcontainer setup.",
"documentationURL": "https://github.com/helpers4/devcontainer/tree/main/src/peon-ping",
"licenseURL": "https://github.com/helpers4/devcontainer/blob/main/LICENSE",
"keywords": ["helpers4", "peon", "audio", "notifications", "ai"],
"options": {
"packs": {
"type": "string",
"default": "default",
"description": "Sound packs to install: 'default' (peon, peasant, sc_kerrigan, sc_battlecruiser, glados), 'all', or a comma-separated list (e.g. 'peon,glados,murloc')"
},
"packsLang": {
"type": "string",
"default": "",
"description": "Restrict pack selection to language(s), e.g. 'fr' or 'en,fr' — passed straight through to the installer's own --lang flag, which understands per-pack language metadata (not just name matching, e.g. matches 'peon_fr'). Left empty, no language filtering happens. If set while 'packs' is still 'default', searches the full pack registry instead of just the 5 default franchise picks — those 5 may not all have a matching-language variant."
},
"noRc": {
"type": "boolean",
"default": true,
"description": "Skip .bashrc/.zshrc modifications (recommended for devcontainers)"
},
"ideSetup": {
"type": "string",
"default": "vscode",
"description": "IDEs to configure: 'all' (vscode + cursor + codex), 'none', or a comma-separated list (e.g. 'vscode,cursor')"
},
"volume": {
"type": "string",
"default": "0.5",
"description": "Default volume level (0.0 – 1.0)"
}
},
"customizations": {
"vscode": {
"extensions": [
Expand All @@ -43,8 +16,8 @@
}
}
},
"postCreateCommand": "/usr/local/share/peon-ping/install-claude-hooks.sh",
"postStartCommand": "/usr/local/share/peon-ping/patch-hosts.sh",
"postCreateCommand": "/usr/local/bin/peon-ping register",
"postStartCommand": "/usr/local/bin/peon-ping check",
"installsAfter": [
"ghcr.io/devcontainers/features/common-utils",
"ghcr.io/helpers4/devcontainer/claude-dev"
Expand Down
Loading
Loading