777genius/agent-notifications

  
  
  
  
  
Desktop notifications for Claude, Codex CLI, OpenCode, Gemini CLI, Cursor CLI and Qoder on macOS, Linux and Windows. Supported architectures and events vary by agent; see the support table and linked setup guides. Claude and Codex also support sounds and click-to-focus.
## Install Or Update
Guided installer or run:
bash
(set -o pipefail; curl -fsSL https://agent-notifications.com/install.sh | bash)
Choose Claude, Codex CLI, OpenCode, Gemini CLI, Qoder, Cursor CLI, or a combination. Install the selected agent CLIs first and make them available on PATH. The installer also requires curl, Bash, and a working python3 or node on PATH; see agent/platform prerequisites. Run the same command to update.
The common Cursor/Qoder flow is available in platform release v1.49.11. It uses one product selection and channel confirmation, with UAP managing each integration. Fresh OpenCode/Gemini/Qoder/Cursor installs default to desktop on and webhooks off; updates without channel flags preserve each agent's saved choice, including disabled channels. Cursor CLI sends informational Stop alerts on qualified Linux amd64, macOS arm64 and Windows amd64 hosts; see its profile requirements and limits.
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: restart Gemini to reload its hooks.
Qoder: install the Qoder CLI first, then reload Qoder to activate its native plugin.
Cursor CLI: restart Cursor CLI to load its informational Stop observer.
The installer selects a release from the platform channels for your OS and architecture. See that page for current versions and the release notes for validation details and known limitations.
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.
Non-interactive installation and optional notification tools
For Codex only:
bash
(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:
bash
(set -o pipefail; curl -fsSL https://agent-notifications.com/install.sh | bash -s -- --products claude,codex,opencode --desktop)
On macOS/Linux/Windows, add ,gemini to --products for all four agents, or use --product gemini for Gemini only. Fresh OpenCode/Gemini setup defaults to desktop notifications with webhooks off; updates preserve saved channel choices when no channel flags are supplied. Explicit flags replace the channel pair: --desktop enables desktop only, --webhook enables webhooks only, and both enable both. Webhook destinations need separate configuration. These flags do not change Claude/Codex channels.
Claude/Codex setup also installs the agent-notifications MCP server and agent-notifications skill so an agent can notify you during a task. Open a new session after setup. When an existing managed MCP installation or binding is detected, automatic setup keeps absent clients off; use --agent-notify to add them explicitly. Use --skip-agent-notify to skip their setup for that run; it neither removes an existing MCP installation nor records a permanent opt-out. Setup and recovery details.