opensourceagi/dev-tools-starter-agent/cloudflare-to-claude-fix

Working With cloudflare-to-claude-fix

The Worker in packages/cloudflare-to-claude-fix. It consumes Cloudflare Workers build events from a queue, and for status === "failed" it POSTs the failure context to a Claude Code routine's /fire endpoint so an agent starts debugging. Requires Workers Paid (queues) and a Claude plan with Claude Code on the web.

Setup

Five steps, in order — skipping any one produces a silent no-op rather than an error:

1. Queues — wrangler queues create workers-build-events and wrangler queues create workers-build-events-dlq.
2. Event Subscriptions on the Worker you want watched: Workers & Pages → Settings → Event Subscriptions → queue workers-build-events, with build started/succeeded/failed/cancelled enabled. This consumer acks and discards everything that isn't a failure.
3. A routine at claude.ai/code/routines, pointed at the repo that Worker deploys from, with an API trigger. Generate the token (shown once) and copy the fire URL.
4. Secrets — wrangler secret put ROUTINE_FIRE_URL, ROUTINE_FIRE_TOKEN, and optionally NOTIFY_WEBHOOK_URL (Slack or Discord incoming webhook). Never commit these.
5. Deploy — wrangler deploy.

What the consumer does

For each failed build it formats build_id, worker_name, branch, commit_hash, author, timestamp, and error_messages into one plaintext block (capped at 65,536 characters), POSTs it, and — if NOTIFY_WEBHOOK_URL is set — posts the returned claude_code_session_url to your chat channel. A failed POST calls retry(); after 3 attempts the message lands in the DLQ.

The /fire API

POST https://api.anthropic.com/v1/claude_code/routines/{routine_id}/fire
Authorization: Bearer sk-ant-oat01-…
anthropic-version: 2023-06-01
anthropic-beta: experimental-cc-routine-2026-04-01
Content-Type: application/json
 
{ "text": "<up to 65,536 chars>" }

Response: { "type": "routine_fire", "claude_code_session_id": …, "claude_code_session_url": … }.

Recipes

Local test — publish a synthetic failure and watch it flow:

wrangler queues publish workers-build-events --message '{"build_id":"build_test001","status":"failed","worker_name":"my-api","branch":"feat/x","commit_hash":"abc1234","author":"you@example.com","error_messages":["Error: Cannot find module ./utils"],"timestamp":"2026-05-01T19:00:00Z"}'
wrangler tail cloudflare-to-claude-fix

Rotate the token — regenerate it on the routine's API trigger (which immediately revokes the old one), then wrangler secret put ROUTINE_FIRE_TOKEN again.

Troubleshooting