The workerd binary and its server. :workerd (workerd.rs, this package) is a Rust binary over three crates in this directory: This package keeps the config schema (workerd.capnp, compiled-bindings.capnp), the config compiler, the WorkerdApi and the C++ libraries the factory is built from (alarm scheduler, channel tokens, container client, facet tree index, fallback service, actor IDs, JSON logger, V8 platform), and their C++ unit tests. The Rust/C++ boundary. The factory keeps everything that touches the isolate: compiling a worker (WorkerdApi, compatibility…
9.1k8mo agoReviewMountCreate a free account to mount
WPT fetch/api runs in two cells, one per streams implementation: Both cells pin the same compatibility flags otherwise (strip_bom_in_read_all_text). Most entries in either config are fetch API divergences that apply to both implementations (missing CORS, cache modes, redirect handling, header validation, unimplemented methods, ...). They are duplicated in both configs and kept identical. Subtests whose result depends on the streams implementation. A row here means the two configs differ for that subtest: it is an expectedFailures or disabledTests entry in…
9.1k8mo agoReviewMountCreate a free account to mount
Generates @cloudflare/workers-types .d.ts files from C++ and Rust JSG RTTI (via jsg/rtti.capnp) + hand-written defines/*.d.ts. Rust descriptions come from TypeInfo and typed module registration in src/rust/jsg/; internal module registration does not make a type an ambient root. A workerd-hosted Worker extracts RTTI at runtime per compat-date; TypeScript transforms post-process into ambient and importable outputs. CI validates generated-snapshot/ matches. - Structure.tsName / StructureType.tsName supply the emitted declaration and reference name. When empty, the generator derives the name from fullyQualifiedName, which remains…
9.1k8mo agoReviewMountCreate a free account to mount
Internal design records — the "why" behind decisions in this repo and its libraries. This is the Diátaxis explanation quadrant: architecture rationale, tradeoffs, and alternatives considered. Living documents that describe how a concept or subsystem works right now. Named by topic: state.md, mcp.md, visuals.md. These are the primary entry point — a contributor looking for "how does state work" should open one file and get the full picture. Design docs get updated as the implementation evolves. They always reflect the…
Steady3 mentions in 2 weeks
No other project uses it yet
6k12d agoReviewMountCreate a free account to mount
User-facing documentation for the Agents SDK monorepo. Each package owns the directory under docs/ matching its unscoped package name. These markdown files are manually synced to developers.cloudflare.com/agents/ where applicable. We follow Diátaxis to keep docs focused. Every doc should have a clear primary type: The fourth Diátaxis type — explanation ("understand why") — lives in /design, not here. If you're writing about why something was designed a certain way, put it there. If you're writing about how to use something,…
Steady3 mentions in 2 weeks
No other project uses it yet
6k12d agoReviewMountCreate a free account to mount
How to write, change and check Gardener tasks (.gardener/tasks/*/TASK.md), the AI maintenance tasks this repository runs from GitHub Actions. Use before creating or editing anything under .gardener/.
Steady3 mentions in 2 weeks
1 project uses a version of this
6k12d agoReviewMountCreate a free account to mount
Harness Durable Objects for testing Lifecycle capabilities — the lower-level sibling of ../agents/ (which holds Agent-level fixture classes). One file per capability, all registered in the shared workers project (../worker.ts + ../wrangler.jsonc), all driving real Durable Objects. - harness.ts — the generic tier's bare CapabilityHarnessObject. Its driver, withCapabilityHarness() (in ../shared/capability-harness.ts), binds per-test-constructed capabilities to a real Lifecycle over real SQLite storage — a new capability gets isolation tests with zero new wiring. - lifecycle.ts — fixtures for the Lifecycle core…
Steady3 mentions in 2 weeks
No other project uses it yet
6k12d agoReviewMountCreate a free account to mount
Author Cloudflare Worker Bundler-compatible apps that build and preview correctly inside a space. Use this skill whenever you scaffold, modify, or deploy a project that will be built with `@cloudflare/worker-bundler` (i.e. anything served from `/space/:name/preview/:branch/`). Covers wrangler config, project layout, static asset rules, server entry conventions, npm dependency limits, and the most common cause of blank previews (JSX in browser scripts).
5.4k4mo agoReviewMountCreate a free account to mount
Marketing landing page and conversion-focused product page reference. Use this skill when building hero sections, feature grids, pricing pages, testimonials, CTAs, footers, navigation bars, or any public-facing marketing surface. Covers a warm, professional, developer-friendly design language (cream backgrounds, generous whitespace, pill CTAs, corner-bracket card decorations) and a complete token set, animation system, and copy-paste component snippets. NOT for product/dashboard UIs — use frontend-design-saas for those.
5.4k4mo agoReviewMountCreate a free account to mount
S-tier SaaS dashboard and product UI reference. Use this skill when building application shells, data tables, settings panels, billing pages, dashboards, auth flows, admin tools, or any internal/customer-facing SaaS product UI. Inspired by Stripe, Linear, Vercel, Airbnb, Notion. Covers neutral-led design tokens, sidebar+content shells, dense data UIs, form-heavy configuration pages, command palettes, empty states, and the accessibility (WCAG AA+) bar these products clear.
5.4k4mo agoReviewMountCreate a free account to mount
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.
This file helps AI agents understand the structure, tooling, and conventions of the cloudflare-docs repository so they can make correct, buildable changes. This is the source for developers.cloudflare.com. It is…
5.4k2mo agoReviewMountCreate a free account to mount
Use when contributing to the Cloudflare Docs repository — writing or editing documentation pages, choosing content types or components, adding changelog entries, reviewing docs, or learning how to contribute.
5.4k2mo agoReviewMountCreate a free account to mount
Creates and updates pull requests and merge requests for cloudflare-docs changes. Covers title conventions, branch naming, request body structure, and documentation checklist templates. Load when asked to open, create, submit, update, or edit a PR or MR, or write a PR or MR title or description.
5.4k2mo agoReviewMountCreate a free account to mount
This file helps AI coding agents work effectively in the Cloudflare Workers SDK monorepo. Prefer authoritative configuration and documentation over copying details into this file: copied versions, rule lists, and counts become stale. - Use pnpm, not npm or yarn. - Use the Node.js and pnpm versions declared in package.json. - Install dependencies with pnpm install. - Run commands from the workspace root unless package documentation says otherwise. - Before changing a package, read its AGENTS.md if it has one.…
4.7k6mo agoReviewMountCreate a free account to mount
Plain text files in a repository that tell a coding agent how the project works: commands to run, conventions to follow and things to avoid. CLAUDE.md, AGENTS.md, cursor rules and skills are the common kinds.
CLAUDE.md or AGENTS.md?
CLAUDE.md is read by Claude Code. AGENTS.md is an open format that Codex, Cursor and other agents read. Many projects keep one and point the other at it.
What is a skill?
A folder with a SKILL.md that describes one capability, such as filling PDFs or reviewing code. The agent loads it only when the task calls for it.
Can I search my own team's files too?
Your agents already can, over MCP, limited to the files you're allowed to read. Searching them from this page is coming.
CloudflareAGENTS.md