peon-ping

Stop babysitting your terminal

Your Peon pings you the instant Claude Code finishes or needs permission. Never lose flow to a silent terminal again — and your workspace sounds like Orgrimmar.

curl -fsSL https://raw.githubusercontent.com/PeonPing/peon-ping/main/install.sh | bash

Sound check

Meet your new coworker

Click to play. These are the actual sounds you'll hear.

▶

"Ready to work?"

greeting

▶

"Work, work."

acknowledge

▶

"Be happy to."

acknowledge

▶

"Okie dokie."

acknowledge

▶

"Something need doing?"

permission

▶

"Me not that kind of orc!"

annoyed

▶

"I can do that."

acknowledge

▶

"What you want?"

permission

Sound packs

Choose your character

Swap packs with one line in config. Click sounds to preview.

Default

Orc Peon

Warcraft III

peon

Added by @tonyyont

New

Human Peasant

Warcraft III

peasant

Added by @thomasKn

New

Soviet Engineer

Red Alert 2

ra2_soviet_engineer

Added by @msukkari

New

Battlecruiser

StarCraft

sc_battlecruiser

Added by @garysheng

New

Sarah Kerrigan

StarCraft

sc_kerrigan

Added by @garysheng

New

TF2 Engineer

Team Fortress 2

tf2_engineer

Added by @Arie

34 packs and counting! You're only seeing a few above — there are many more including GLaDOS, StarCraft Terran units, Czech, Spanish & Russian & Polish Warcraft packs, and others.

Run peon --packs to see them all, or check the full list on GitHub.

Want to add your own? Any game, any character — drop your sound files in packs/<name>/sounds/, add a manifest, and open a PR.

Details

Tuned for real work

🔊

Volume control

0.0 – 1.0 in config. Quiet enough for the office.

🔀

No repeats

Tracks last played per category. Never the same line twice in a row.

🎛

Category toggles

Enable or disable greeting, acknowledge, complete, error, annoyed individually.

📋

Tab titles

Terminal tab shows project name and status. Dot indicator when done.

📦

Pack system

Orc Peon, Soviet Engineer, Battlecruiser, Kerrigan, and more. Submit your own.