Skip to main content
PeonPing works with any agentic IDE that supports hooks or event systems. Adapters translate IDE-specific events to the CESP standard (Coding Event Sound Pack Specification).

​
Supported IDEs

IDEIntegration TypeStatus
Claude CodeBuilt-in hooks✅ Native
AmpFilesystem watcher✅ Adapter
OpenCodeTypeScript plugin✅ Adapter
CursorBuilt-in hooks✅ Adapter
GitHub Copilothooks.json✅ Adapter
Gemini CLIsettings.json✅ Adapter
Kilo CLITypeScript plugin✅ Adapter
Windsurf, Kiro, Kimi Code, Antigravity, OpenClawVarious✅ Adapters

​
Architecture

All adapters follow a common pattern:
  1. Event capture — Listen for IDE-specific events (hooks, file changes, JSON-RPC)
  2. Event mapping — Translate events to CESP categories (session.start, task.complete, etc.)
  3. Sound playback — Call peon.sh or peon.ps1 with standardized JSON

​
Adapter Types

Hook registration (Claude Code, Cursor, GitHub Copilot, Gemini CLI) Register shell scripts in the IDE’s hook configuration. The IDE calls the script when events occur, passing context via stdin. TypeScript plugins (OpenCode, Kilo CLI) Native plugins that hook into the IDE’s event bus. Provide richer context and terminal integration. Filesystem watchers (Amp, Kimi Code, Antigravity) Background daemons that watch IDE data directories and emit events when files change.

​
CESP Event Mapping

All adapters map to these standard categories:
CESP CategoryTriggers
session.startIDE launches, first prompt submitted
task.completeAgent finishes turn, tool execution completes
task.errorTool fails, error occurs
input.requiredPermission prompt, user input needed
resource.limitRate limit hit, token quota exceeded
user.spam3+ prompts within 10 seconds

​
Platform Support

All adapters run on:
  • macOS — afplay for audio, JXA Cocoa overlays for notifications
  • Linux — pw-play/paplay/aplay for audio, notify-send for notifications
  • Windows — Native PowerShell with MediaPlayer and WinForms
  • WSL2 — PowerShell fallback via powershell.exe
  • SSH/Remote — HTTP relay to local machine (see remote development)

​
Next Steps

Claude Code

Built-in support via hooks.json

OpenCode

TypeScript plugin with terminal focus detection

GitHub Copilot

Repository hooks.json setup

Other IDEs

Windsurf, Kiro, Kimi Code, and more

Build docs developers (and LLMs) love

Get started for freeTalk to us