Agent NotificationsFOR YOUR CODING AGENTS
GitHub ↗

LESS WATCHING. MORE BUILDING.

Stay in flow
We'll get your attention

Let your agent work. Know when it's done.
Desktop notifications and webhooks for Claude, Codex CLI, OpenCode, Gemini CLI, Cursor CLI, Qoder and Pi. Agent and platform limits apply. Pi: sounds and terminal focus in the local TUI.

Open source · Runs locally

YOUR AGENT HAS AN UPDATE

❓ Question

now
Claude · main · checkout-service

What would you like to name the test file in /tmp/?

📋 Plan

now
Claude · main · patient-portal

Plan: Create test file in /tmp/

✅ Install notifications

now
Codex CLI · main · payments-api

Done. Installation now comes right after the hero.

✏️ 3 edited ⏱ 35s
macOSLinuxWindows

Set up notifications

Follow the steps below to add notifications to Claude.

Choose the computer where your agent runs

Choose a target operating system to reveal your command. Mobile and unknown browsers need an explicit choice.

Compare agent features
FeatureClaudeCodex CLIOpenCodeGemini CLImacOS / Linux / WindowsCursor CLIQoderPi
CompletedSupportedSupportedSupportedSupportedSupported with limitationsSupportedSupported
QuestionSupportedSupported with limitationsSupportedNot supportedNot supportedSupportedSupported
Permission RequestSupportedSupportedSupportedSupportedNot supportedSupportedNot supported
ReviewSupportedNot supportedNot supportedNot supportedNot supportedNot supportedNot supported
PlanSupportedNot supportedNot supportedNot supportedNot supportedSupportedNot supported
Session Limit ReachedSupportedSupported with limitationsNot supportedNot supportedNot supportedSupported with limitationsNot supported
ErrorsSupportedSupported with limitationsSupportedNot supportedNot supportedSupportedSupported
SoundsSupportedSupportedSupported with limitationsSupported with limitationsSupported with limitationsSupported with limitationsSupported with limitations
Click-to-focusSupported with limitationsSupported with limitationsNot supportedNot supportedNot supportedNot supportedSupported with limitations
WebhooksSupportedSupportedSupportedSupportedSupportedSupportedSupported

✓ Supported · ✕ Not supported · ✓* Supported with limitations

Cursor CLI: informational Stop alerts and optional webhooks on Linux amd64, macOS arm64 and Windows amd64. No Cursor IDE or click-to-focus support. The installer validates the selected CLI and user profile. Cursor CLI installation ↗

Gemini CLI versions are not restricted. Available on macOS / Linux / Windows. Tested versions and platform coverage are documented in the Gemini guide. Gemini setup and limits ↗

Pi standalone: final completion, blocking extension UI questions and final errors. Sound and click-to-focus require a local TUI; enabled webhooks also work in JSON, print and RPC. Pi setup, sound and terminal focus ↗

Qoder: completion, question, permission, plan and teammate alerts with optional webhooks. Choose Qoder alongside other agents in the common installer; a notification click cannot open the exact existing chat. Qoder setup and hooks ↗

Compatibility details

* Codex questions depend on the active mode; errors and limits are detected from the final message. Click-to-focus depends on your OS and terminal. OpenCode, Gemini CLI and Cursor CLI: opt-in OS-default sound via notifications.desktop.systemSound=true; no custom audio or click-to-focus. Qoder: StopFailure errors and rate limits; five MP3 assets bundled, native audible playback unverified.

Claude permission prompts appear as Question alerts. Codex question hooks are experimental; error and limit detection uses final-message heuristics. See the linked guides for qualification details.

OpenCode: completion, question, permission and error alerts for root sessions. No click-to-focus.

Gemini CLI (macOS / Linux / Windows): turn-completed and tool-permission alerts. A completed turn does not imply success or a final answer. No click-to-focus, question, error, plan, review or nested-agent parity.

Codex CLI: Requires a published stable plugin release ≥1.42.0. Codex CLI ↗

OpenCode: OpenCode CLI versions are not restricted. Tested versions and platform coverage are documented in the setup guide. What is OpenCode V2? ↗

OpenCode setup and limitations ↗

THE RIGHT SIGNAL. AT THE RIGHT TIME.

Keep your focus
Lose the constant checking

CLICK TO FOCUS

Return with one click

Click a notification to return to its terminal, editor or tab where supported. Claude, Codex CLI and Pi only; support depends on your terminal and OS.

SOUND CONTROLS

A sound for every moment

Pick sounds, set the volume, and choose an audio device. Keep the signals you want and quiet the rest. Claude, Codex CLI and Pi only.

WEBHOOK INTEGRATIONS

Your workflow, connected

Send updates to Slack, Discord, Telegram, Lark/Feishu and custom webhooks. Configure destinations for wherever you work.

Click-to-focus support depends on your terminal and OS. OpenCode: completion, question, permission and error alerts for root sessions. No click-to-focus. See platform details ↗

ONE CLICK. THE RIGHT WINDOW.

Built for your setup
Not just one terminal

Claude, Codex CLI and Pi only. Click-to-focus adapts to what you already run. Here is exactly how precise the click gets on each platform.

Terminal / IDEmacOSmacOSLinuxLinuxWindowsWindowsNotes
GhosttyGhostty Exact tab/pane Best-effort Not supportedNeeds Automation permission for exact tab focus.Mapped in the Linux daemon but not yet officially verified.
iTerm2iTerm2 Exact tab/pane Not supported Not supportedRequires enabling iTerm2's Python API, then a restart.
WarpWarp Exact tab/pane Exact tab/pane Exact tab/paneNo extra permissions needed — Warp resolves its own window, tab, and pane.
kittykitty Exact tab/pane Window-level Not supportedExact pane targeting needs kitty's remote control enabled.
WezTermWezTerm Exact tab/pane Exact tab/pane Not supportedTargets the exact pane through WezTerm's own CLI.
VS Code / InsidersVS Code / Insiders Window-level Window-level Window-level
CursorCursor Window-level Best-effort Window-levelFalls back to generic window matching, not a dedicated integration.
JetBrains IDEsJetBrains IDEs Window-level Window-level Window-levelmacOS detects it the same way as any other app, not with a dedicated integration.Linux detects the IDE via its process tree and product-info.json window class. The terminal tab inside it isn't selectable.
Apple TerminalApple Terminal Window-level Not supported Not supportedAlso the default fallback when no other terminal is detected.
AlacrittyAlacritty Window-level Window-level Not supported
HyperHyper Window-level Best-effort Not supportedFalls back to generic window matching, not a dedicated integration.
GNOME TerminalGNOME Terminal Not supported Window-level Not supported
KonsoleKonsole Not supported Window-level Not supported
TilixTilix Not supported Window-level Not supported
TerminatorTerminator Not supported Window-level Not supportedUses the exact window title for precise matching.
XFCE4 TerminalXFCE4 Terminal Not supported Window-level Not supported
MATE TerminalMATE Terminal Not supported Window-level Not supported
Windows TerminalWindows Terminal Not supported Not supported Window-level
Command Prompt / PowerShellCommand Prompt / PowerShell Not supported Not supported Window-level
ConEmuConEmu Not supported Not supported Window-level
tmuxtmux Exact tab/pane Not supported Not supportedAlso works inside iTerm2's -CC control mode.
zellijzellij Exact tab/pane Exact tab/pane Not supportedLinux targets the exact pane when the session exports it, otherwise falls back to the active tab by name.

Exact tab/pane focuses the precise split or tab. Window-level raises the whole app window. Best-effort means the plugin tries a generic match that may land on the wrong window.

Windows Terminal supports window-level focus. Warp can target an exact tab or pane on Windows; support varies by terminal.

Any other terminal still works through generic window matching. Override the detected app with a custom bundle ID on macOS.

Full permission & compositor details ↗

A FEW THINGS TO KNOW

Frequently asked questions

Everything you need to get back to work.

Do I need every agent installed?

Select any combination of Claude, Codex CLI, OpenCode, Gemini CLI, Cursor CLI, Qoder and Pi. Install the selected CLIs first. Cursor supports Linux amd64, macOS arm64 and Windows amd64; see its guide for host requirements.

Are Codex hooks installed automatically?

Yes. The installer registers the hooks and saves a stable runtime copy. Open /hooks in Codex to review and trust them. Changed definitions need review again.

Will an update reset my settings?

The installer preserves your shared configuration and foreign Codex hooks. Install and update use the same command. Restart the selected agent after updating.

Can I choose what makes a sound?

Yes. Configure sounds, volume, audio device and notification channels. Choose Configure in the guide for the steps specific to your agent. Claude, Codex CLI and Pi only.

Does click-to-focus work everywhere?

Support varies by OS and terminal. iTerm2 needs its Python API for precise tab targeting. Windows Terminal focuses a window; Warp can target an exact tab or pane. OpenCode: completion, question, permission and error alerts for root sessions. No click-to-focus. Check supported environments.

What if I don't get a notification?

Check your OS notification permissions and chosen channels. For Codex, confirm the hooks are trusted. Follow troubleshooting for platform-specific checks.

LET YOUR AGENT TAKE THE NEXT TURN

Your attention is valuable

Make every notification count ↗