{
  "$type": "site.standard.document",
  "bskyPostRef": {
    "cid": "bafyreihuwar72b2ynu5e6r5mrlzd25ro6r7l3eqaweqcbbbma654kbjcia",
    "uri": "at://did:plc:nkxz2ojdvmieg2nhphvputvp/app.bsky.feed.post/3mmgxi7ftiup2"
  },
  "coverImage": {
    "$type": "blob",
    "ref": {
      "$link": "bafkreie6qj6jsovb5a5xdb25elmb26242yfapdj7g3ka6ojiamkn7b2ixm"
    },
    "mimeType": "image/png",
    "size": 1017855
  },
  "description": "Wer mit AI-Coding-Agents arbeitet, kennt das Spiel. Claude Code läuft, macht sein Ding — und man sitzt daneben und wartet. Oder man wechselt kurz den Fokus, verpasst die Rückfrage und wundert sich zehn Minuten später, warum nichts mehr passiert. Terminal-Babysitting in Reinform.\n\nEin Bekannter hat mir dann peon-ping empfohlen. Kurz ausprobiert — direkt behalten. Danke dafür!\n\nWas ist peon-ping?\n\npeon-ping ist ein kleines Open-Source-Tool (MIT-Lizenz), das Sound-Benachrichtigungen für […]",
  "path": "/2026/03/03/peon-ping-sound-benachrichtigungen-fuer-claude-code/",
  "publishedAt": "2026-05-22T12:42:15.000Z",
  "site": "https://www.kernel-error.de",
  "tags": [
    "ClaudeCode",
    "KI",
    "Linux",
    "OpenSource",
    "Tools",
    "peon-ping",
    "ntfy.sh",
    "openpeon.com",
    "CESP-Spezifikation",
    "github.com/PeonPing/peon-ping",
    "peonping.com"
  ],
  "textContent": "Wer mit AI-Coding-Agents arbeitet, kennt das Spiel. Claude Code läuft, macht sein Ding — und man sitzt daneben und wartet. Oder man wechselt kurz den Fokus, verpasst die Rückfrage und wundert sich zehn Minuten später, warum nichts mehr passiert. Terminal-Babysitting in Reinform.\n\nEin Bekannter hat mir dann peon-ping empfohlen. Kurz ausprobiert — direkt behalten. Danke dafür!\n\n### Was ist peon-ping?\n\npeon-ping ist ein kleines Open-Source-Tool (MIT-Lizenz), das Sound-Benachrichtigungen für AI-Coding-Agents nachrüstet. Der Name ist Programm — im Default-Modus hört man den Peon aus Warcraft III. _„Ready to work?“_ wenn eine Session startet, _„Work, work.“_ wenn eine Aufgabe fertig ist, _„Something need doing?“_ wenn der Agent eine Eingabe braucht. Und wenn man zu schnell hintereinander Prompts abfeuert: _„Me busy, leave me alone!“_\n\nDas Tool unterstützt nicht nur Claude Code, sondern auch Cursor, Codex, Windsurf, Kiro, GitHub Copilot und diverse andere Agents. Für Claude Code erfolgt die Integration über den nativen Hook-Mechanismus — es werden automatisch Hooks in `~/.claude/settings.json` registriert.\n\n### Warum das Sinn ergibt\n\nDas Problem ist simpel: Man startet Claude Code mit einer Aufgabe, wechselt in den Browser oder ein anderes Terminal — und verpasst den Moment, in dem der Agent fertig ist oder eine Frage hat. Ohne Feedback sitzt man entweder da und starrt auf den Output, oder man verliert Zeit, weil der Agent längst auf Eingabe wartet.\n\npeon-ping löst das mit akustischem Feedback. Verschiedene Sounds für verschiedene Events — Task fertig, Fehler aufgetreten, Eingabe nötig, Rate-Limit erreicht. Dazu optional Desktop-Notifications als visuelles Overlay und sogar Push-Benachrichtigungen aufs Handy via ntfy.sh. Man kann also ruhig den Fokus wechseln und weiß trotzdem immer, was der Agent gerade treibt.\n\n### Installation unter Linux\n\nDie Installation ist erfrischend simpel. Ein Einzeiler:\n\n\n    curl -fsSL peonping.com/install | bash\n\nAlternativ gibt es auch Homebrew (`brew install PeonPing/tap/peon-ping`) oder Nix. Nach der Installation einmal das Setup laufen lassen:\n\n\n    peon-ping-setup\n\nDas Setup registriert die Hooks in eurer Claude-Code-Konfiguration und installiert das Default-Sound-Pack. Fertig. Beim nächsten Start von Claude Code solltet ihr den Peon hören.\n\nFür die Audio-Wiedergabe unter Linux nutzt peon-ping automatisch `pw-play` (PipeWire), `paplay` (PulseAudio), `ffplay` oder `mpv` — je nachdem, was verfügbar ist. Desktop-Notifications laufen über `notify-send`.\n\n### Konfiguration\n\nDie Konfiguration liegt in `~/.claude/hooks/peon-ping/config.json`. Die wichtigsten Optionen:\n\n\n    {\n      \"volume\": 0.5,\n      \"enabled\": true,\n      \"desktop_notifications\": true,\n      \"default_pack\": \"peon\",\n      \"pack_rotation\": [\"peon\", \"sc_kerrigan\"],\n      \"pack_rotation_mode\": \"random\"\n    }\n\n`volume` regelt die Lautstärke (0.0 bis 1.0), `desktop_notifications` schaltet die visuellen Overlay-Benachrichtigungen ein oder aus, und `pack_rotation` lässt euch mehrere Sound-Packs im Wechsel abspielen — entweder zufällig oder reihum (`round-robin`). Man kann sogar Packs an bestimmte Projektverzeichnisse binden — GLaDOS für die Arbeit, Peon fürs Hobby.\n\nPer CLI geht das Meiste auch schnell zwischendurch:\n\n\n    peon volume 0.3          # Leiser\n    peon pause               # Stummschalten\n    peon resume              # Wieder an\n    peon status              # Aktueller Zustand\n\nWer Claude Code nutzt, bekommt außerdem Slash-Commands: `/peon-ping-toggle` zum Stummschalten, `/peon-ping-config` für interaktive Einstellungen und `/peon-ping-use <pack>` zum Wechseln des Sound-Packs in der laufenden Session.\n\n### Sound Packs\n\nUnd hier wird es lustig. Auf openpeon.com gibt es über 164 Sound-Packs. Der Warcraft-Peon ist der Default, aber es gibt so ziemlich alles: GLaDOS aus Portal, Kerrigan aus StarCraft, den TF2 Engineer, Duke Nukem, Sheogorath aus Elder Scrolls, den Dude aus The Big Lebowski — sogar ein cleanes Chimes-Pack ohne Sprachlinien, falls man es dezenter mag.\n\nPacks installieren und wechseln geht über die CLI:\n\n\n    peon packs list --registry      # Verfügbare Packs anzeigen\n    peon packs install glados       # GLaDOS installieren\n    peon packs use glados           # GLaDOS aktivieren\n    peon packs install --all        # Alle installieren (wenn man sich nicht entscheiden kann)\n\nDie Packs basieren auf der offenen CESP-Spezifikation (Coding Event Sound Pack) — wer eigene Sounds mitbringen will, kann sich relativ einfach ein eigenes Pack bauen.\n\n### Fazit\n\npeon-ping ist klein, kostenlos, Open Source (MIT) und löst ein echtes Problem. Kein Terminal-Babysitting mehr, keine verpassten Rückfragen. Und ja — es macht einfach Spaß, wenn der Peon einem bestätigt, dass die Arbeit erledigt ist. _„Work complete.“_\n\nNochmal Danke an den Bekannten für den Tipp. Manchmal sind es die kleinen Tools, die den größten Unterschied machen.\n\n**Links:**\n\nGitHub: github.com/PeonPing/peon-ping\nSound Packs: openpeon.com\nWebsite: peonping.com\n\nNutzt ihr AI-Coding-Agents im Alltag? Wie haltet ihr es mit Benachrichtigungen — oder sitzt ihr auch und starrt auf den Output? Schreibt mir gerne, ich bin gespannt.",
  "title": "peon-ping — Sound-Benachrichtigungen für Claude Code (und andere AI-Agents)"
}