Notifications

Get notified when your AI agent reaches a checkpoint — whether a task is complete or needs your attention.

Overview

Checkpoint notifications keep you informed about your AI agent's progress. While working in Claude Code, you can tell your AI "notify me when done" and receive updates through your preferred channels.

How It Works

SuperClawd uses a two-layer notification model:

Two-layer notification model

Per-request: Tell your AI "notify me when done" to enable notifications for that specific task.
Global: Choose which channels (Desktop, Webhook) receive notifications in Settings.

Notification Channels

Checkpoint notifications support two channels:

Desktop — A native OS notification banner from the CLI on the machine you're working on. No setup required.
Webhook — An HTTP POST to a URL you configure. Route it to Slack, Discord, or custom systems via an incoming webhook.

Configure notification channels →

Notification Types

Your AI sends two types of checkpoint notifications:

Completion — Task completed successfully. Your AI finished what you asked.
Attention Needed — AI needs your input. A decision, clarification, or approval is required to continue.

Pricing

Checkpoint notifications are free.

Notifications are free

Neither the desktop banner nor the webhook delivery costs credits, on any plan — including the free tier. A rate limit of 10 notifications per minute prevents accidental spam.

Using Notifications

Once configured, simply tell your AI to notify you:

Example prompts

"Refactor this module and notify me when done"

"Fix these bugs, let me know when you need my input"

"Run the tests and notify me of the results"

Your AI will use the notify_checkpoint tool to send notifications through your configured channels when the task completes or needs attention.