anotifier / slack

Slack alerts when your agent finishes.

Your AI agent runs for minutes while you're already in Slack. anotifier posts to the channel of your choice the moment Claude Code, Codex, Cursor, or Gemini CLI finishes a task or stops to ask for input.

$ npx anotifier@latest setup
[ SET UP SLACK ]

Wired up in a minute.

anotifier talks to Slack through a standard Incoming Webhook — no bot, no OAuth app, no scopes to manage. Point it at a channel and you're done.

SlackIn your Slack workspace, add an Incoming Webhook for the channel you want alerts in, then copy the webhook URL it gives you.
configRun npx anotifier@latest config webhook and answer the prompts: enable the webhook, paste the URL, and enter slack as the format. Or add the block below to ~/.anotifier/config.json yourself.
testFire a sample message with anotifier test webhook — it should land in the channel within a second.
[ CONFIG ]

One block in your config.

anotifier reads a single JSON file at ~/.anotifier/config.json. Drop this in and every supported agent uses it.

{
  "webhook": {
    "enabled": true,
    "url": "https://hooks.slack.com/services/...",
    "format": "slack"
  }
}

Need auth? Add "authorization": "Bearer <token>" to the webhook block and anotifier sends it as the Authorization header.

[ SAFE BY DEFAULT ]

Your webhook is a secret, and stays one.

[+] Secrets stay secret Webhook URLs and bot tokens are never logged in full — only the URL's origin is recorded on failure.
[+] Never in the way Delivery errors go to ~/.anotifier/errors.log and never interrupt or slow the agent.
[+] Per-event off switch Silence a single event with events.task_complete.webhookEnabled: false.
[+] Rich Claude Code content Webhooks can carry what Claude actually said; other agents get generic text.
[ FAQ ]

Slack questions, answered.

How do I send Claude Code notifications to Slack?

Create a Slack Incoming Webhook for a channel, paste its URL into ~/.anotifier/config.json with format: "slack", and anotifier posts there whenever an agent finishes or needs input. Run anotifier test webhook to confirm it works.

Is my Slack webhook URL kept private?

Yes. The webhook URL is a secret, so anotifier never logs it in full — delivery failures record only the URL's origin, and errors go to ~/.anotifier/errors.log without ever interrupting the agent.

Which agents can post to Slack?

All of them. Claude Code, Codex CLI, Cursor, Gemini CLI, and agents inside VS Code share one config, so every finish and input request routes to the same Slack channel.

Will the Slack message show what the agent said?

For Claude Code, the webhook carries the real text — the question for a needs-input event, or the last assistant message on task-complete. Other agents send a generic completion message.

[ WORKS WITH EVERY AGENT ]

One config, every agent.

anotifier routes the same Slack notification from every agent it supports:

Claude Code notificationsCodex CLI notificationsCursor notificationsGemini CLI notificationsAntigravity CLI notificationsVS Code notifications
[ ALSO SEND TO ]

Prefer a different destination?

anotifier can post the same alerts to discord, telegram, or phone push.

Every config key for this channel is in the docs.

Full feature tour, demo video, and install options on the anotifier home page.