Agent Notifications

Desktop notifications for Claude, Codex CLI and OpenCode, plus Gemini CLI on Linux/Windows. Know when a task finishes, an agent needs input, or a tool needs approval. Claude and Codex also support sounds and click-to-focus.

Guided installer or run:

curl -fsSL https://agent-notifications.com/install.sh | bash

Choose Claude, Codex CLI, OpenCode, Gemini CLI (Linux/Windows), or a combination. Install the selected agent CLIs first. Run the same command to update.

Windows: use Git Bash, not WSL, for a native Windows installation.

After setup:

• Claude: restart Claude.
• Codex: restart Codex, then review and trust the installed hooks in /hooks.
• OpenCode: restart OpenCode; on macOS, grant notification permission.
• Gemini CLI (Linux/Windows): restart Gemini to reload its hooks.

The installer selects a verified complete release for your platform:

Run the command once to migrate a normal Claude marketplace installation to its platform channel. Claude's plugin updater then follows that channel; rerun setup to update a standalone Codex bundle. Explicitly pinned/custom marketplace sources are retained.

Version 1.48.4 is GitHub's Latest and includes native binaries and portable packages for all five targets, plus the signed, notarized ClaudeNotifier.app helper for macOS. The installer selects this release from platform channels. Gemini CLI remains supported on Linux/Windows only.

(set -o pipefail; curl -fsSL https://agent-notifications.com/install.sh | bash -s -- --product codex)

(set -o pipefail; curl -fsSL https://agent-notifications.com/install.sh | bash -s -- --products claude,codex,opencode --desktop)

Manual installation · Manual Codex registration · Uninstall · Troubleshooting

• Task and attention alerts: completions, questions, tool approvals and more, depending on the agent. See the table below.
• Click-to-focus and sounds (Claude/Codex): return to the originating terminal or editor; choose built-in or custom sounds, volume and audio output. Supported terminals · Sound settings
• Useful context: Claude/Codex show project, git branch and native session names, with generated labels as fallback. OpenCode desktop alerts show native session names when available. Question alerts show the current question when supplied by the host. OpenCode webhooks retain generic text. Session context · OpenCode context
• Less noise: focus-aware delivery, delays, filters and optional subagent alerts. Configuration · Do Not Disturb
• Webhooks: Slack, Discord, Telegram, Lark/Feishu and custom endpoints. Integration guides
• Cross-platform: macOS (Intel/Apple Silicon), Linux (x64/ARM64) and Windows 10+ (x64). Agent and delivery limits are listed below. Platform details

Agent Notifications 1.48.1 on Linux/Windows and 1.48.3 on macOS supports OpenCode V1 and V2 with one installed plugin. Linux/Windows release qualification covers V1 1.18.33 and V2 2.0.21, plus V1 1.18.34 on Linux amd64. macOS has four installed basic-business/lifecycle checks across V1 1.18.33 and V2 2.0.21: Apple Silicon ran natively, while Intel binaries ran under Rosetta. These checks do not prove physical Intel execution, full native E2E or visible OpenCode banners for this release.

The self-contained bundle incorporates SDK 0.3.0 from its reviewed vendored tarball; separate SDK publication is not required. Setup, release reports and delivery limits. Gemini is tested with 0.62.0; a completed turn does not necessarily mean task success or a final answer. OpenCode/Gemini alerts require explicit desktop/webhook consent. Gemini alerts and OpenCode webhooks use generic text. OpenCode desktop alerts may include bounded native session titles and current question text.

For OpenCode on stock Windows V1, the original event age is not always independently verifiable. A delayed completion may notify once and recur after the 24-hour claim lifetime; filters, provenance, deduplication and limits still apply. One-shot opencode run delivery at host shutdown is best effort; use a persistent host for sustained delivery.

In Claude, run /claude-notifications-go:settings for the settings wizard or /claude-notifications-go:sounds to preview sounds.

Use the installed launcher to find or safely inspect settings. The commands below assume agent-notifications is on your PATH; otherwise, use its full path.

agent-notifications config path
agent-notifications config inspect --json

Settings are shared, with optional per-agent overrides. The claude-notifications alias and Claude's existing slash-command names remain supported.

Configuration reference · Per-agent overrides · Sound previews

• Installation, updates and removal
• Notification types and click-to-focus
• Webhooks
• Troubleshooting and plugin compatibility
• Architecture and local development
• Changelog

Built with Universal Agent Plugins. Build plugins for multiple AI agents.

See CONTRIBUTING.md for development and testing. Pull requests are subject to the Contributor License Agreement; contributors keep copyright.

GPL-3.0-or-later. See LICENSE and third-party notices.