AgentNotify receives hook events from OpenCode, Claude Code, and Codex, formats short action-focused notifications on the server, logs safe event summaries, and pushes them to your phone or desktop via Bark or ntfy.
- Receives raw hook events from OpenCode, Claude Code, and Codex.
- Formats short, action-focused notifications server-side (permission requests, prompts, errors, long-task completion).
- Prefixes notification titles with the project name when the agent provides a working directory.
- Keeps short tasks quiet and only pings when a session has run long enough to matter.
- Tames rapid notify-handle-continue loops with a session-scoped cooldown for permission/question alerts.
- Provides per-tool
/agent-notifyswitches for session, timed, and persistent muting. - Pushes through Bark (iPhone / Apple Watch) or ntfy (cross-platform).
| Agent | How it connects | Forwards |
|---|---|---|
| OpenCode | plugin example | permission / question / session-error / idle-completion events |
| Claude Code | command hook + adapter | UserPromptSubmit, selected Notification, Stop, StopFailure |
| Codex | command hook + adapter | UserPromptSubmit, PermissionRequest, Stop |
The adapter is fail-safe: server errors never block the agent. Long-task completion is tracked in the AgentNotify server, so adapters stay stateless.
| Platform / Device | Bark | ntfy |
|---|---|---|
| iPhone / Apple Watch | ✅ recommended | ✅ |
| Android | ❌ | ✅ recommended |
| macOS desktop | ❌ | ✅ |
| Windows desktop | ❌ | ✅ |
| Linux desktop | ❌ | ✅ |
| Web browser | ❌ | ✅ |
Human manual:
End-to-end deployment manual for AI coding agents:
AI-assisted setup is recommended to start from a local project directory. First manually clone this repository and enter the project root:
git clone git@github.com:LetTTGACO/agent-notify.git
cd agent-notifyThen start your AI agent in that directory and send it this:
Follow this manual to set up and configure AgentNotify:
https://raw.githubusercontent.com/LetTTGACO/agent-notify/refs/heads/main/docs/ai-operation-manual.md
MIT © LetTTGACO