Stateless webhook-to-push gateway for CodeIsland. Receives webhook events and forwards them as push notifications.

Bark

Forward CodeIsland webhook events to Bark for iOS push notifications.

Setup

In CodeIsland settings, enable Webhook Forwarding and set the URL to:

Behavior

• Notifications are sent with timeSensitive level for immediate delivery through Focus mode.
• Notification icon is automatically set based on the source agent (Claude, Codex, Gemini, etc.).
• Notifications are grouped by agent name in the iOS notification center.
• Push history is archived in Bark by default.

Request Body

The request body is the standard CodeIsland webhook payload:

{
  "event":      "Notification",
  "raw_event":  "notification",
  "session_id": "...",
  "source":     "claude",
  "cwd":        "/path/to/project",
  "tool_name":  "Bash",
  "timestamp":  "2026-04-29T12:00:00.000Z",
  "raw":        { /* original hook event payload */ }
}

Response

{
  "ok":   true,
  "bark": { "code": 200, "message": "success" }
}

Parameters

Parameter	Location	Description
:token	URL path	Your Bark device key
server	Query string	Custom Bark server URL (optional, defaults to api.day.app)

cURL Example

curl -X POST /webhook/bark/YOUR_TOKEN \
  -H 'Content-Type: application/json' \
  -d '{
    "event": "Notification",
    "raw_event": "notification",
    "session_id": "abc-123",
    "source": "claude",
    "cwd": "/home/user/project",
    "tool_name": "",
    "timestamp": "2026-04-29T12:00:00.000Z",
    "raw": {"message": "Task completed"}
  }'

Agent Icons

Each supported agent has a dedicated icon served at /icons/<name>.png.