Notify

ctx notify¶

Send fire-and-forget webhook notifications from skills, loops, and hooks.

ctx notify --event <name> [--session-id <id>] "message"

Flags:

Behavior:

• No webhook configured: silent no-op (exit 0)
• Webhook set but event not in events list: silent no-op (exit 0)
• Webhook set and event matches: fire-and-forget HTTP POST
• HTTP errors silently ignored (no retry)

Examples:

ctx notify --event loop "Loop completed after 5 iterations"
ctx notify -e nudge -s session-abc "Context checkpoint at prompt #20"

ctx notify setup¶

Configure the webhook URL interactively. The URL is encrypted with AES-256-GCM using the encryption key and stored in .context/.notify.enc.

Examples:

ctx notify setup

The encrypted file is safe to commit. The key (~/.ctx/.ctx.key) lives outside the project and is never committed.

ctx notify test¶

Send a test notification and report the HTTP response status.

Examples:

ctx notify test

Payload format (JSON POST):

{
  "event": "loop",
  "message": "Loop completed after 5 iterations",
  "session_id": "abc123-...",
  "timestamp": "2026-02-22T14:30:00Z",
  "project": "ctx"
}

See also: Webhook Notifications recipe.