Agent notifications, in VS Code.

VS Code never sees anotifier. npx anotifier@latest setup looks in your home folder for the agents you have installed and adds an anotifier entry to the hook file each one already reads. Nothing is installed into VS Code and nothing is added to its settings.

Open each agent once before you run setup, so its folder exists. Setup copies every file it changes to ~/.anotifier/backups/ first, and npx anotifier@latest uninstall removes only the entries it added.

The title is the project and the agent, such as my-app · Claude Code. The project is the name of the folder the agent was started in, so two VS Code windows on different folders read differently at a glance. For Claude Code the body is the start of Claude's last reply, up to 180 characters, or its own message when it needs you; phone push says my-app: Task complete instead. Codex CLI and Gemini CLI send my-app: Task complete or my-app: Needs your input. anotifier doesn't read a project folder from Cursor's event, so its alert is just Cursor and Task complete.

Every alert goes to each channel you have on: the desktop toast, phone push through ntfy, a Slack, Discord or Telegram webhook, and the terminal bell. Only Claude Code can quote its reply; the other agents always send the generic line.

The first Windows toast registers an agentfocus:// link handler in your user registry hive, and each toast carries one. A click opens it and a small script looks for a window to raise, in this order:

1. A terminal window whose title contains the project folder name: Windows Terminal, PowerShell, cmd, Warp, WezTerm, Alacritty, Hyper, ConEmu or tmux.
2. A window titled Visual Studio Code that contains the folder name. VS Code puts the open folder in its window title, which is why this works.
3. A window titled Cursor that contains the folder name.
4. Any other window whose title contains the folder name.
5. If none match, the nearest window owned by a parent process of the hook, looked up when the toast fired.

Cursor alerts carry no folder for anotifier, so their toasts have no click action at all, and neither do macOS, Linux and WSL toasts. To turn it off on Windows, set toast.clickToFocus to false in ~/.anotifier/config.json.

The notifications not working guide walks through every channel in the same way.

npx anotifier@latest test       # fire a test alert on every channel
npx anotifier@latest status     # show which agents and channels are set up
npx anotifier@latest doctor     # diagnose a channel that stays quiet
npx anotifier@latest uninstall  # remove the hooks setup added

test sends straight to your channels without going through VS Code, so it proves the channels work. uninstall removes only the entries anotifier added and restores your statusline (1.5.0 and later), and setup keeps a copy of every file it changes in ~/.anotifier/backups/.