debug-os-worker
OfficialPinpoint Cloudflare OS worker failures fast.
Software Engineering#observability#cloudflare#orpc#request tracing#production incident#code correlation#worker debugging
Authoriterate
Version1.0.0
Installs0
System Documentation
What problem does it solve?
Debugging production or preview 500s in the Cloudflare OS worker is difficult because you need evidence across observability events and then map that evidence back to the exact handler code.
Core Features & Use Cases
- Query Worker observability events: Retrieve recent events (typically 20–50) and filter by service/trigger, message, requestId, error text, and level.
- Narrow to error-focused signals: Isolate likely root causes by filtering for error-level events or distinctive message fragments from alerts.
- Correlate failures to code paths: Trace findings to the relevant sections of apps/os source code, especially entry.workerd.ts, apps/os/src/orpc/, and apps/os/src/domains/.
Quick Start
Use the debug-os-worker skill to query the last 30 minutes of deployed worker events for environment OS, filter to the specific error message or requestId from your alert, then identify the corresponding handler code under apps/os/src/.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: debug-os-worker Download link: https://github.com/iterate/iterate/archive/main.zip#debug-os-worker Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.