Documentation

Notification Channels

Configure how you receive checkpoint notifications. Enable one or more channels to stay informed through your preferred methods.

Desktop

Receive a native OS notification banner on the machine you're working on. The banner is emitted by the SuperClawd CLI — no setup required and it costs nothing.

Just tell your AI to notify you

Desktop banners come from the CLI on the machine running your session. There's nothing to enable — when your AI reaches a checkpoint, the banner appears.

Webhook

Send notifications to any HTTPS URL. Integrate with Slack, Discord, or build custom integrations with your own systems.

Step 1: Configure Webhook URL

  1. Go to Settings → Webhooks
  2. Enter your webhook URL (must be HTTPS)
  3. Click Save

Step 2: Enable Webhook Notifications

  1. Go to Settings → Notifications
  2. Enable Webhook under Checkpoint Notifications
  3. Click Save

Step 3: Test Your Webhook

  1. In Settings → Webhooks, click Send Test
  2. Verify your endpoint received the test notification

Payload Format

SuperClawd sends a JSON payload with the following structure:

json
{
  "event": "checkpoint_notification",
  "type": "completion",
  "text": "Task completed: Refactored authentication module",
  "content": "Task completed: Refactored authentication module",
  "sessionId": "abc-123",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

Platform Guides

For step-by-step integration guides with popular platforms:

Using Both Channels

You can use Desktop and Webhook together. When a checkpoint is reached, a desktop banner appears and a webhook POST is sent to your configured URL.

Common configurations:

  • Desktop only — Zero setup, good when you're at your machine
  • Webhook only — Route all notifications to Slack/Discord or custom systems
  • Desktop + Webhook — A local banner plus a record in your team channel
Notifications are free

Checkpoint notifications cost no credits on any plan, including the free tier — whether you use one channel or both.