Desktop notifications for Claude, Codex CLI and OpenCode, plus Gemini CLI on Linux/Windows (v1.47.1). Know when a task finishes, an agent needs input, or a tool needs approval. Claude and Codex also support sounds and click-to-focus.
Install Or Update
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:
| Platform | Version | Agents |
|---|---|---|
| Linux amd64 / arm64 | 1.47.1 | Claude, Codex, OpenCode, Gemini |
| Windows amd64 | 1.47.1 | Claude, Codex, OpenCode, Gemini |
| macOS amd64 / arm64 | 1.46.1 | Claude, Codex, OpenCode |
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. GitHub's global Latest remains 1.46.1 for older installers. See platform channels.
Non-interactive installation and optional notification tools
For Codex only:
(set -o pipefail; curl -fsSL https://agent-notifications.com/install.sh | bash -s -- --product codex)
Use --product claude or --product both for Claude or Claude + Codex. For Claude, Codex and OpenCode on any supported platform:
(set -o pipefail; curl -fsSL https://agent-notifications.com/install.sh | bash -s -- --products claude,codex,opencode --desktop)
On Linux/Windows, add ,gemini to --products for all four agents, or use --product gemini for Gemini only. For OpenCode/Gemini, choose --desktop, --webhook, or both; webhook destinations need separate configuration. These flags do not change Claude/Codex channels.
Claude/Codex setup also installs the agent-notify MCP server and agent-notifications skill so an agent can notify you during a task. Open a new session after setup. Use --skip-agent-notify for hooks only. Setup and recovery details.
Manual installation · Manual Codex registration · Uninstall · Troubleshooting
Features
- 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
Supported Agents
| Agent | Alerts | Sounds / click-to-focus | Details |
|---|---|---|---|
| Claude | Completions, reviews, questions, plans, session limits and API errors | Yes | Notification types |
| Codex CLI | Turn completion and tool permissions; questions and errors depend on host events or final-message detection | Yes | Setup and limits |
| OpenCode | Root-session completion, questions, permissions and errors | No | Setup and limits |
| Gemini CLI | Turn completion and tool permissions | No | Linux/Windows setup and qualification |
Published OpenCode support is tested with 1.18.33; published V2 support is not declared. The dual-API candidate targets 1.18.33, 2.0.0 and 2.0.21 with one installed plugin; final platform qualification, SDK publication and a clean registry install remain pending. Candidate setup and qualification 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 the OpenCode candidate 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.
Settings
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
Documentation
- 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.
Contributing
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.