What agents should know before contributing
cloudflare/workers-sdk
⛅️ Home to Wrangler, the CLI for Cloudflare Workers®
Read by Bluet from 3 files written for agents and 300 merged pull requests on 2026-09-25. Not reviewed by the maintainers.
Rules its files tell agents (6)
- AGENTS.md
shouldDo not assume every package-code change needs one.
Read .changeset/README.md to determine whether a changeset is required and how to write it. Do not assume every package-code change needs one.
- AGENTS.md
shouldDo not build shell commands with interpolated or concatenated untrusted input.
Do not build shell commands with interpolated or concatenated untrusted input. The custom workers-sdk/no-unsafe-command-execution oxlint rule enforces the repository's command-execution constraints.
- AGENTS.md
shouldoxfmt determines whitespace, quoting, import order, and package.json sorting.
oxfmt determines whitespace, quoting, import order, and package.json sorting. Do not reproduce those rules manually; run pnpm prettify.
- AGENTS.md
shouldComments should explain why; do not add comments that merely restate code.
- AGENTS.md
shouldDo not run credentialed E2E tests unless the task and environment support them.
Prefer the narrowest relevant test while developing, then run the broader package checks appropriate to the change. Do not run credentialed E2E tests unless the task and environment support them.
- AGENTS.md
shouldDo not edit generated files directly.
Do not edit generated files directly. Change their source or generator and regenerate them.
Decisions its pull requests settled (23)
- #15206[miniflare] Recover from a partially downloaded Chrome install
- #15192[wrangler] Fix kv bulk put corrupting binary values in local mode
- #15223[workers-auth] Recover from a partially installed keyring native binding
- #15239Prevent date-enabled Node.js compatibility from adding conflicting globals to generated runtime types
- #15242[miniflare] Terminate workerd when the parent receives SIGHUP
- #15252keep `wrangler dev` alive when a proxied request to the UserWorker fails transiently
- #15243Update the root AGENTS.md
- #15272[vitest-plugin] Add experimental `newConfig` option for `cloudflare.config.ts`
- #15296[wrangler] Pause automatic skills installation offers
- #15316[miniflare] Re-register a dev registry entry after the stale sweep removes it
- #15320detect an installed secret tool on Linux regardless of its exit status
- #15363[autoconfig] Resolve framework build commands for cf
- #15420[miniflare] fix: emit valid SQL literal for Infinity/-Infinity in D1 export
- #15453Remove Web Search binding and commands
- #15483[miniflare] Align workflow status endpoint schema with production
- #15485reject loopback bind failures during startup
- #15540[miniflare] Fix DevalueError when passing cross-realm Headers to proxied bindings
- #15519[vite-plugin-cloudflare] fix: preserve :authority and port in HTTP/2 requests
- #15563[pages-shared] Encode filenames in HTML redirects
- #15567[local-explorer-ui][miniflare] Improve resending of emails from local explorer
- #15707[vitest-plugin] Support nested D1 migration layouts in readD1Migrations
- #15712make D1 splitter.ts use sqlite's parser logic
- #15817Use CLOUDFLARE_PREVIEW_BUILD environment variable for preview delegation