Workers Development

cloudflare/skills/skills/workers-development

by cloudflare6eb6c781aa9b6438e0c7307bd102788a75fe1a6dNo license3.2K starsListed Nov 7, 2026Updated Nov 7, 2026Repository updated today

Run, inspect, and debug Cloudflare Workers during local development with cf dev, wrangler dev, or the Cloudflare Vite plugin, using Local Explorer to read and seed binding data and query local traces and logs. Also routes production debugging to Workers observability. Use for debugging requests whether or not the project uses Wrangler.

AI-generated overview

Guides running, inspecting and debugging Cloudflare Workers locally with cf dev, Wrangler or the Vite plugin, plus production observability.

What it does
Explains how to start a Worker's local dev server using the project's existing tooling, then inspect or seed local binding data (KV, R2, D1, Durable Objects, Workflows, Cron) through the Local Explorer UI and its OpenAPI-described API. It covers reading captured local traces and logs before adding logging, checking which bindings are remote, and routing deployed-Worker debugging to Workers observability or the Cloudflare MCP server. It produces guidance and commands rather than files.
When to use it
Use when developing or debugging a Cloudflare Worker locally and you need to run the dev server, inspect or seed binding data, or read local traces and logs. Also useful when debugging a deployed Worker's logs, traces or metrics.
Requirements
A Cloudflare Workers project with its own dev tooling (cf, Wrangler, or the Cloudflare Vite plugin) and a running local dev server; network access for docs and, for deployed debugging, Cloudflare account access and optionally the Cloudflare MCP server. Instructions only, no bundled scripts.

Workers development and debugging

Use the project's existing tooling, scripts, and configuration. Installed help, the Local Explorer API schema, and current docs describe the supported operations; read them rather than guessing endpoints or flags.

NeedTools and discovery
Run locallyUse the project's existing dev command: cf dev in a cf project, otherwise the Wrangler or Cloudflare Vite dev script. See local development.
Inspect or seed local binding dataLocal Explorer is a UI and API for local KV, R2, D1, SQLite-backed Durable Objects, and Workflows, and can trigger Cron handlers. Open /cdn-cgi/local/explorer on the dev server's origin.
Debug local requestsLocal Explorer captures traces and logs from every local invocation, including binding operations, without code changes. Check traces before adding logging.
Debug a deployed WorkerChoose logs, traces, or metrics with Workers observability, or the cloudflare skill's observability reference when installed. If the Cloudflare MCP server is connected (bundled with this plugin), use search to find the Workers Observability API operations, then execute to call them, scoped to the target account, Worker, and time window.

Use the Local Explorer API

When the dev server detects an AI agent, including under cf dev, it prints a hint with the API URL and relevant endpoints. Fetch the OpenAPI specification from /cdn-cgi/local/explorer/api on the dev server's origin, then extract only the operations the task needs. If no hint appears, request that URL directly. If the API or an operation is missing, compare the installed Wrangler or Vite plugin version against the requirements in the Local Explorer docs.

Bindings are simulated locally by default, but a binding set to remote: true reaches the real deployed resource while the Worker runs locally. Traces also capture those remote calls. Identify which bindings are remote before seeding or writing data.

Skill feedback

If the user reports that this skill gave incorrect or outdated guidance, or is missing information, read references/skill-feedback.md [blocked].

Source and attribution

Source:cloudflare/skillsinskills/workers-developmentat commit6eb6c78

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Add a badge to your README

Show readers this skill is listed on SourceWeft. The badge links to this page.

Preview of the “Listed on SourceWeft” badge
[![Listed on SourceWeft](https://sourceweft.com/badge/skills/gh-cloudflare-skills-workers-development-skills-workers-development-aae70b66896f63b2.svg)](https://sourceweft.com/skills/gh-cloudflare-skills-workers-development-skills-workers-development-aae70b66896f63b2?utm_source=readme&utm_medium=badge)

Report or request removal