Browser-side TypeScript library (@cloudflare/speedtest) that measures connection quality against Cloudflare's edge. Powers speed.cloudflare.com. Uses Vitest with two test projects: - Unit tests (tests/unit/*/.test.ts) — pure function tests for utils, config, and Results. Run in Node, no browser needed. Fast. - E2E tests (tests/e2e/*.test.ts) — runs a realistic speed test in a real Chromium browser via Vitest Browser Mode + Playwright. Tests the full library integration (fetch, PerformanceResourceTiming, module loading) with multiple measurement phases (latency, download, upload), loaded latency, AIM scoring,…
@cloudflare/telescope is a TypeScript browser performance testing library and CLI built on Playwright. It launches real browsers (Chrome, Chrome Beta, Canary, Firefox, Safari, Edge), collects HAR files, Web Vitals, and…
@cloudflare/telescope is a TypeScript browser performance testing library and CLI built on Playwright. It launches real browsers (Chrome, Chrome Beta, Canary, Firefox, Safari, Edge), collects HAR files, Web Vitals, and…
telescope-web is an Astro + Cloudflare Workers web application that serves as the Telescope results UI. It is a fully independent project from the core packages/telescope/ library — do not…
Guidance for AI coding agents working in this package. @cloudflare/waterfall is a standalone, framework-free web component that renders an HTTP Archive (HAR) waterfall chart. It lives at /waterfall/ in the…
Guides cloudflare/cloudflare-os-starter setup, Cloudflare Access, deployment.jsonc, storage, AI, observability, custom Gatekeepers, deployment, verification, troubleshooting, rollback, and pinned-submodule upgrades. Use only for deployments created from the Cloudflare OS Deployment Starter, not standalone Cloudflare OS checkouts.
STOP. Your knowledge of Cloudflare Workers APIs and limits may be outdated. Always retrieve current documentation before any Workers, KV, R2, D1, Durable Objects, Queues, Vectorize, AI, or Agents SDK task. For all limits and quotas, retrieve from the product's /platform/limits/ page. eg. /workers/platform/limits Run wrangler types after changing bindings in wrangler.jsonc. https://developers.cloudflare.com/workers/runtime-apis/nodejs/ Retrieve API references and limits from: /kv/ · /r2/ · /d1/ · /durable-objects/ · /workers-ai/ · /agents/ · /sandbox/ · /containers/
Guidelines for AI agents working on the @cloudflare/containers package. This is the @cloudflare/containers npm package — a TypeScript library that wraps Cloudflare's container-enabled Durable Objects. It provides lifecycle management, HTTP/WebSocket proxying, outbound interception, scheduling, and load balancing utilities on top of the Cloudflare Workers runtime. Key exports (src/index.ts): Add a new file to the .changeset directory representing a new version when wrapping up changes so they get released. Do NOT change CHANGELOG.md, that is codegenerated on a release MR that…
Add new Prometheus metrics to the Cloudflare exporter. Use when adding metrics, implementing new GraphQL/REST queries, or extending metric coverage. Covers the full workflow from schema discovery through client implementation and README updates.
These instructions apply to the entire repository. - Complete application blueprints live alongside examples as top-level directories. catalog.yaml and the local blueprint.yaml identify them. - Preserve existing example paths unless…
These instructions apply to cloud-gaming/. Keep this a complete but small Realtime SFU application: one Freedoom Container, multiple viewers, and one controlling browser tab. Do not turn it into a…
Start with README.md. The main integration reference is firmware/docs/sfu.md; ESP32, the playlist, and HTTPS-to-Worker are the working implementation's choices. Run Makefile commands from esp32-radio/. Read the references for the component…
This is a Rust application on ESP-IDF for the validated ESP32-S3 N32R16V. Read README.md and docs/ffi.md before changing hardware ownership or transport. Check ../ERRATA.md for known integration issues. Keep portable…
This directory owns the React frontend and Cloudflare backend. Use Tailwind v4 utilities for layout, typography, controls, and responsive behavior. Keep custom CSS focused on theme tokens and drawing effects.…
Keep this a complete but small Realtime SFU room: multiple browser participants, one Durable Object per room, and explicit authentication, authorization, reconnect, and cleanup. Do not turn it into a…
Subdirectory AGENTS.md files provide package-specific context (key classes, where-to-look tables, local conventions and anti-patterns). This repository (workers-py) contains three Python packages that are used for Cloudflare Python Workers. There is…
django-cf is a Python package that lets a Django application run on Cloudflare Workers and use Cloudflare products as Django backends. It is published to PyPI as django-cf and imported…
workers-runtime-sdk is a Python package that provides utilities for running Python code in a Cloudflare Worker environment. This package provides utilities for:
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