Repository navigation
Added
- Why a channel failed, in the opt-in daily usage summary. Each channel's
ok/failcounts now come with areasonscount of the failures by a fixed category (timeout,spawn_error,exit_nonzero,no_tty,http_4xx,http_5xx,network,unsupported,other), so a toast that never appears can be told apart from a bell with no terminal. Only the category is counted, never a message, status code, exit code, path or URL;okandfailare unchanged and nothing is sent unless usage stats are on. - Skip alerts while you are looking at the agent (opt-in). New
suppressWhenFocused(defaultfalse, off) in~/.anotifier/config.json, oranotifier config focus: when it is on and the window running the agent (its terminal or editor) is the one in front, every alert (task complete, needs input, and a new session if you turned that alert on) is not sent on any channel (toast, ntfy, webhook, bell). Only an answer of "yes, in front" skips; an unknown answer (tmux, screen, zellij, ssh, Wayland, a probe that fails or times out) sends as usual. It is off by default because it needs a window probe before each alert, which adds about 1 s to each alert on Windows and WSL while it is on, and because another tab or pane of the same terminal window counts as in front. A window left in front while you are away still counts as in front, so the idle reminder is never suppressed. It can be turned on or off for one project in aprojectsrule. Usage-limit and context warnings and the update notice do not use it.anotifier statusshows it asWhen focused. - How long the turn took. A "task complete" notification now ends with the turn length when it is known, for example
app: Task complete (took 4m 12s)(also on the assistant's own words when rich content is on). Titles are unchanged. Works for Claude Code, Codex CLI and Gemini CLI, which give a hook at the start of a turn; Cursor and Antigravity CLI have no reliable start signal, so they show nothing. - Minimum duration filter. New
events.task_complete.minDurationSeconds(default0, off): a turn shorter than that many seconds sends no "task complete" alert. Permission prompts and every other needs-input notification are always sent, a turn of unknown length is never skipped, and the key is rejected on any event other thantask_complete. Set it inanotifier config eventsor~/.anotifier/config.json;anotifier statusshows it asMin duration. See the README section "Turn length and the minimum duration filter". - A timing hook that records when a turn started:
UserPromptSubmitfor Claude Code and Codex CLI,BeforeAgentfor Gemini CLI. It prints only{}, has a 5-second timeout, ignores every error, and keeps its state in~/.anotifier/turns.json. Re-runnpx anotifier setupafter upgrading to add it (the Claude Code plugin gets it fromhooks/hooks.json);anotifier uninstallremoves the hook and deletesturns.json(with its lock and any leftover temp file). Until it is wired, nothing is timed and nothing is filtered. - Your own sound files.
events.<event>.toastSoundcan now be the path of an audio file:~/sounds/done.wav, an absolute path, any value with a/or a backslash, or a name ending in.wav,.mp3,.aiff,.aif,.m4a,.aac,.ogg,.oga,.opusor.flac. It plays in the background:.wavand Windows Media formats on Windows (capped at 30 seconds, toast made silent),afplayon macOS (the notification is sent without a sound name),pw-play/paplay/aplayon Linux (the only sound Linux plays), Windows playback under WSL (toast made silent). A missing file leaves the default sound on Windows (on macOS the notification is sent as it is forDefault) and a player that cannot start is logged, both without the path; a file a player cannot decode stays silent on macOS and Linux.anotifier config soundschecks the file exists,anotifier test toastplays it, andanotifier doctorwarns about a missing one. - Per-project overrides. New
projectslist in~/.anotifier/config.json: each rule has an absolute or~/match(a folder, or a glob such as~/work/*/app; a rule whosematchis relative, such asfoo,./apporC:foo, is rejected and ignored, and a hook folder that is not absolute, such asfoo,./app,~/xorC:foo, matches no rule) and overrides the channel (ntfy,toast,terminalBell,webhook), sound, priority,minDurationSeconds,quietHours, per-event settings or source labels for hooks run in that folder or anything inside it. Rules are applied once per hook run, before quiet hours, the minimum duration filter and routing, so all of them see the same settings; a run with no folder in its hook input, or no matching rule, behaves exactly as before. If applying the rules ever fails, the error is written to~/.anotifier/errors.log(contextconfig:projects) and the hook carries on with your top-level settings. Rules live only in your own config file, never in a per-repo file, so a cloned repository cannot redirect your alerts. A Telegram rule that setsformatinheritschatIdfrom the top-levelwebhook.sentry,updateCheck,telemetryandusageAlertscannot be overridden.anotifier status,doctorandconfigstill show your top-level settings only. The statusline's context and usage-limit warnings apply them too, using the folder the session is in at each statusline refresh, from Claude Code's statusline input (workspace.current_dir, thenworkspace.project_dir, thencwd): a matching rule'scontextAlerts(enabled,threshold) changes the context warning for that session only, and itsntfy,toast,webhookandquietHourschange how both warnings are delivered. The usage-limit warning is account-wide with one shared state, so its thresholds and on/off switch stay global (usageAlertsis still not allowed in a rule). A rule that turns every channel off leaves the usage warning to your other chats. See the README section "Per-project overrides".
Fixed
- Cursor alerts now read Cursor's own hook input. Cursor sends
workspace_roots,conversation_idand, on thestophook, astatus(completed,abortedorerror); the hook read none of them. Now the first workspace root names the project, so a Cursor alert showsmy-app · Cursorin its title and a Windows click on the toast can focus the right window. The conversation id is the session id, so the double-fire guard is per conversation instead of one global lock: two chats finishing within 1.5 seconds both alert. A run that errored now saysTask failed(with thewarningntfy tag instead of the check) rather than "Task complete", still under yourevents.task_completesettings. The failed-run alert uses thewarningntfy tag in place of whateverevents.task_complete.ntfyTagsis set to. A run you aborted sends no alert at all, since you stopped it at the keyboard. Each field is used only when present and well-typed, and only for Cursor (other agents' payloads are read exactly as before); a payload without them alerts exactly as before. Windows Cursor sends workspace roots like/C:/Users/x/app; only the folder name (app) is used. Hook input that starts with a UTF-8 byte-order mark, which Cursor on Windows can send, is now parsed instead of being dropped as malformed. Nothing to re-run: setup already wires thestophook.
Changed
- Cursor's official app icon replaces the old cube icon (
assets/icons/cursor.png), shown on Windows and Linux notifications, in the README and on the site. - Message text for webhook and ntfy consumers. A "task complete" message can now end with
(took …)once the timing hook is wired, and Cursor alerts are titledmy-app · Cursor, sayTask failedwhen the run errored and send nothing for an aborted run. Anyone matching message text exactly should update.
What's Changed
- docs(landing): anotifier 1.7.1, session_start is off on the webhook by default by @AminDhouib in #95
- feat(approval): remote Allow/Deny from the phone for Claude Code Bash (experimental, not enabled by setup) by @AminDhouib in #96
- fix(brand): official logos for Cursor, Slack, Telegram and GitHub by @AminDhouib in #90
- feat(approval): setup warns when the ntfy account has no tier by @AminDhouib in #97
- feat(landing): first-party analytics through anotifier.io (PostHog /_t/n4q, gtag /gx4t) by @AminDhouib in #98
- seo(landing): Claude Code hooks security guide by @AminDhouib in #99
- seo(landing): ccnotify guide by @AminDhouib in #100
- fix(landing): guide overview link and icon alt use the agent's name by @AminDhouib in #101
- feat(landing): session replay on PostHog and Sentry (10%), person profile on conversion by @AminDhouib in #102
- fix(landing): Sentry session replay 10% → 5% by @AminDhouib in #104
- seo(landing): deepen /vscode/ and /discord/, link them from guides by @AminDhouib in #103
- fix(landing): Sentry session replay 5% → 10% by @AminDhouib in #105
- seo(landing): Codex CLI guide covers Windows and turning alerts off by @AminDhouib in #106
- seo(landing): Claude Code notification sound guide covers every event, Windows/WSL, no-sound fixes and muting by @AminDhouib in #107
- test(landing): fail if Cloudflare's Web Analytics beacon comes back by @AminDhouib in #108
- feat(landing): analytics consent prompt and /privacy/ page by @AminDhouib in #109
- fix(landing): stop Cloudflare injecting the GA4 tag before consent by @AminDhouib in #110
- fix(landing): relay Google Analytics through nginx, Tag Gateway off by @AminDhouib in #111
- feat(landing): hero shows a VS Code window with Claude Code and Codex, stacked toasts and a larger phone by @AminDhouib in #112
- fix(landing): load analytics for every visitor, no consent prompt by @AminDhouib in #113
- seo(landing): /claude-code/ answers "claude code notifier": options compared, manual hooks, FAQs by @AminDhouib in #114
- fix(landing): dark scrollbar on command rows, no layout shift from the background layer by @AminDhouib in #115
- feat: minimum turn duration for completion alerts, and how long the turn took by @AminDhouib in #116
- feat(landing): home page sweep with a branded icon set, less generic styling, no hero layout shift by @AminDhouib in #120
- seo(landing): Cursor guide answers 'cursor notification when done' with built-in options, hooks.json, phone and fixes by @AminDhouib in #117
- fix(cursor): read workspace_roots, conversation_id and stop status from Cursor's hook input by @AminDhouib in #118
- feat: per-event custom sound files (toastSound can be a path to an audio file) by @AminDhouib in #119
- feat(config): per-project override rules in the user config (loader only, not wired yet) by @AminDhouib in #121
- feat(focus): detect whether the agent's own window is in the foreground (not wired yet) by @AminDhouib in #124
- fix(landing): keep automated browsers out of analytics and send GA4 events by beacon by @AminDhouib in #122
- seo(landing): bump sitemap lastmod for / and /docs/ to their 2026-10-15 edits by @AminDhouib in #123
- ci: liveness check of the production URLs every 15 minutes by @AminDhouib in #125
- feat(config): apply per-project override rules to notifications (T-2371) by @AminDhouib in #126
- seo(landing): Windows & WSL guide answers "claude code windows notification" with native, WSL, Focus Assist and test sections by @AminDhouib in #127
- seo(landing): Claude Code notifications hub answers "claude code notification(s)" (iteration 16, T-2651) by @AminDhouib in #128
- fix(config): ignore non-absolute project paths, log resolver failures by @AminDhouib in #129
- feat(landing): split Codex CLI and Codex sound guides by search intent by @AminDhouib in #130
- seo(landing): auto-compact guide answers what it is, autoCompactEnabled and /compact vs /clear by @AminDhouib in #131
- feat(focus): opt-in suppressWhenFocused skips alerts while the agent's window is in front (T-2369) by @AminDhouib in #132
- seo(landing): ntfy guide answers "claude code ntfy" with setup, private topics, self-hosting and troubleshooting by @AminDhouib in #133
- test(sentry): live delivery test gets its own 10 s timeout and skips on runner latency by @AminDhouib in #134
- feat(config): project rules apply to statusline context and usage alerts (T-2709) by @AminDhouib in #135
- test(focus): hanging-probe test survives a loaded machine by @AminDhouib in #137
- seo(landing): sitemap lastmod matches each page's last content change by @AminDhouib in #136
- seo(landing): Gemini CLI guide answers "gemini cli notification" with the built-in alert, hooks, sound and phone by @AminDhouib in #139
- ci: skip the live agent E2Es on PRs that only change landing/ by @AminDhouib in #142
- seo(landing): Antigravity CLI notifications guide targets the notifications setting, hooks, sound and phone alerts by @AminDhouib in #140
- fix(landing): scope Antigravity no-needs-input claims to hooks and point to the notifications setting by @AminDhouib in #141
- seo(landing): permission notifications guide covers one hook for several types, a notification_type script and hook-never-fires fixes by @AminDhouib in #143
- seo(landing): hooks security guide is the one page for Claude Code hook security; explainer links to it by @AminDhouib in #144
- seo(landing): Codex CLI guide title leads with "Codex CLI Notifications" by @AminDhouib in #145
- seo(landing): guides hub explains which guide to read and links the uncrawled agent and integration pages by @AminDhouib in #146
- seo(landing): Codex mute-notifications section and Claude preferredNotifChannel FAQ by @AminDhouib in #147
- Add direct notify-when-done and play-a-sound answers to the two Codex guides by @AminDhouib in #148
- seo(landing): /claude-code/ answers the 'Claude Code notifier' search directly by @AminDhouib in #150
- seo(landing): Claude sound guide answers how to mute Claude Code by @AminDhouib in #149
- seo(landing): Antigravity guide answers Antigravity notifications for the app and the CLI by @AminDhouib in #151
- seo(landing): Cursor guide answers how to get notified when Cursor is done by @AminDhouib in #152
- feat(landing): footer says anotifier is independent and names trademark owners by @AminDhouib in #153
- seo(landing): Cursor guide says user-level hooks don't run in cloud agents by @AminDhouib in #154
- ci: run the live Sentry delivery test on one leg only by @AminDhouib in #155
- feat(telemetry): count why a channel failed in the daily summary by @AminDhouib in #156
- Build the landing image once on GitHub-hosted runners and publish a Dokploy release (native pull mode) by @AminDhouib in #159
- fix(landing): next 15.5.28 (RCE) + zod 4.6.7 by @AminDhouib in #158
- ci: pin dokploy-release to v2.0.0 by @AminDhouib in #160
- fix(landing): ccnotify guide drops the deleted daniil4545/ccnotify repo by @AminDhouib in #162
- seo(landing): WSL guide covers VS Code powershell.exe terminal exit-code errors by @AminDhouib in #161
- seo(landing): Antigravity guide answers the IDE-on-Windows notification question by @AminDhouib in #163
- test(landing): retry live-site requests that die at the network level by @AminDhouib in #164
- chore(release): prepare 1.8.0 changelog, README and site docs by @AminDhouib in #138
Full Changelog: v1.7.1...v1.8.0