\n\n\n\n**🤖 Agent skill** — `npx skills@latest add https://github.com/OpenSourceAGI/dev-tools-starter-agent --skill cloudflare-to-claude-fix` ([what it covers](../../skills/cloudflare-to-claude-fix/SKILL.md))\n\n\nA Cloudflare Workers **Queue consumer** that fires a **Claude Code routine** whenever a Workers build fails. Required Workers Paid and Claude Pro.\n\n---\n\n## Setup\n\n### 1. Clone / copy this project\n\n```bash\ngit clone \ncd cloudflare-to-claude-fix\nnpm install\n```\n\n### 2. Create the Cloudflare Queue\n\n```bash\n# Main queue\nwrangler queues create workers-build-events\n\n# Dead-letter queue (catches messages that fail all 3 retries)\nwrangler queues create workers-build-events-dlq\n```\n\n### 3. Enable Event Subscriptions on your target Worker\n\nIn the Cloudflare dashboard:\n\n1. Open **Workers & Pages** → select the Worker you want to monitor\n2. Go to **Settings** → **Event Subscriptions**\n3. Set the queue to `workers-build-events`\n4. Enable: **Build started**, **Build succeeded**, **Build failed**, **Build cancelled**\n\nThis Worker only acts on `status === \"failed\"` events; the rest are acknowledged and discarded.\n\n### 4. Create a Claude Code routine\n\n1. Go to [claude.ai/code/routines](https://claude.ai/code/routines)\n2. Click **New routine**\n3. Configure:\n - **Prompt:** e.g. *\"A Cloudflare Workers build has failed. The build ID, branch, commit, author and error log are below. Investigate the error, identify the root cause, and push a fix to the branch. Summarise what you changed.\"*\n - **Repository:** the repo that this Worker is deployed from\n4. Under **Select a trigger** → **Add another trigger** → choose **API**\n5. Click **Generate token** — copy the token (shown **once**)\n6. Copy the full fire URL shown in the modal (format: `https://api.anthropic.com/v1/claude_code/routines/trig_/fire`)\n\n### 5. Store secrets in Wrangler\n\n```bash\n# Required\nwrangler secret put ROUTINE_FIRE_URL\n# paste: https://api.anthropic.com/v1/claude_code/routines/trig_/fire\n\nwrangler secret put ROUTINE_FIRE_TOKEN\n# paste: sk-ant-oat01-...\n\n# Optional — post session link to Slack or Discord\nwrangler secret put NOTIFY_WEBHOOK_URL\n# paste: https://hooks.slack.com/services/... (Slack)\n# or: https://discord.com/api/webhooks/... (Discord)\n```\n\n> **Never** commit secrets to source control or paste them in plaintext anywhere.\n\n### 6. Deploy\n\n```bash\nwrangler deploy\n```\n\n---\n\n## How it works\n\n1. Cloudflare Builds publishes a `BuildEvent` message to `workers-build-events` when a build status changes.\n2. This consumer Worker receives the batch. Non-failure messages are `ack()`-ed immediately.\n3. For `status === \"failed\"` messages the Worker:\n - Formats the `build_id`, `worker_name`, `branch`, `commit_hash`, `author`, `timestamp`, and `error_messages` into a single plaintext block (≤ 65,536 chars).\n - POSTs that block to the Claude Code routine `/fire` endpoint.\n - If `NOTIFY_WEBHOOK_URL` is set, posts the resulting `claude_code_session_url` to Slack/Discord so your team can watch the live debugging session.\n4. If the fire request fails, the message is `retry()`-ed up to 3 times (configured in `wrangler.toml`). After 3 failures the message lands in `workers-build-events-dlq`.\n\n---\n\n## Claude Code routine `/fire` API quick-reference\n\n```\nPOST https://api.anthropic.com/v1/claude_code/routines/{routine_id}/fire\nAuthorization: Bearer sk-ant-oat01-...\nanthropic-version: 2023-06-01\nanthropic-beta: experimental-cc-routine-2026-04-01\nContent-Type: application/json\n\n{ \"text\": \"\" }\n```\n\n**Response:**\n\n```json\n{\n \"type\": \"routine_fire\",\n \"claude_code_session_id\": \"session_01...\",\n \"claude_code_session_url\": \"https://claude.ai/code/session_01...\"\n}\n```\n\n| Status | Cause |\n| ------- | -------------------------------------------------------------- |\n| `400` | Missing beta header, text > 65 536 chars, or routine is paused |\n| `401` | Wrong or missing bearer token |\n| `403` | Account doesn't have Claude Code on the web |\n| `404` | Routine ID not found |\n| `429` | Daily run allowance exhausted |\n\n---\n\n## Revoking / rotating the routine token\n\n1. Open [claude.ai/code/routines](https://claude.ai/code/routines) → edit the routine\n2. Click the API trigger → **Generate token** (this immediately revokes the old one)\n3. Update the secret: `wrangler secret put ROUTINE_FIRE_TOKEN`\n\n---\n\n## Local testing\n\nSend a synthetic failed-build message to the queue:\n\n```bash\nwrangler queues publish workers-build-events \\\n --message '{\n \"build_id\": \"build_test001\",\n \"status\": \"failed\",\n \"worker_name\": \"my-api\",\n \"branch\": \"feat/new-endpoint\",\n \"commit_hash\": \"abc1234\",\n \"author\": \"alex@example.com\",\n \"error_messages\": [\"Error: Cannot find module '\\''./utils'\\''\", \" at Object. (src/index.ts:3:1)\"],\n \"timestamp\": \"2026-05-01T19:00:00Z\"\n }'\n```\n\nThen tail logs to verify:\n\n```bash\nwrangler tail cloudflare-to-claude-fix\n```\n\n---\n\n---\n\n[](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)\n\nPlease star this repo for updates! 🌟\n","readmeFilename":"README.md"}
![](\"https://i.imgur.com/RQP3lma.png\")
![\"Documentation\"](\"https://img.shields.io/badge/Docs-blue?logo=ReadTheDocs&logoColor=white\"){kind=icon}
![\"GitHub](\"https://img.shields.io/github/stars/OpenSourceAGI/dev-tools-starter-agent\")
![\"NPM](\"https://img.shields.io/npm/dm/cloudflare-to-claude-fix.svg\")
\n ![\"npm](\"https://img.shields.io/npm/v/cloudflare-to-claude-fix.svg\")
\n ![\"NPM](\"https://img.shields.io/npm/dt/cloudflare-to-claude-fix.svg\")
\n ![\"TypeScript](\"https://img.shields.io/npm/types/cloudflare-to-claude-fix\")
![\"GitHub](\"https://img.shields.io/github/issues/OpenSourceAGI/dev-tools-starter-agent?logo=github\")
![\"Open](\"https://img.shields.io/github/issues-pr/OpenSourceAGI/dev-tools-starter-agent?logo=github&label=PRs\")
![\"Merged](\"https://img.shields.io/github/issues-pr-closed/OpenSourceAGI/dev-tools-starter-agent?logo=github&label=PRs%20merged&color=8957e5\")
![\"GitHub](\"https://img.shields.io/github/discussions/OpenSourceAGI/dev-tools-starter-agent\")
![\"GitHub](\"https://img.shields.io/github/last-commit/OpenSourceAGI/dev-tools-starter-agent.svg\")
\n ![\"Bun\"](\"https://img.shields.io/badge/Bun-14151A?logo=bun&logoColor=white\"){kind=icon}
![\"Cloudflare](\"https://img.shields.io/badge/Cloudflare%20Workers-F38020?logo=cloudflareworkers&logoColor=white\"){kind=icon}
![\"Vitest\"](\"https://img.shields.io/badge/Vitest-6E9F18?logo=vitest&logoColor=white\"){kind=icon}