The Cloudflare Agents repository provides a TypeScript SDK for building and deploying AI agents on Cloudflare's infrastructure. Agents are persistent, stateful execution environments powered by Cloudflare Durable Objects, enabling developers to create long-lived, intelligent applications that maintain their own state, storage, and lifecycle. Each agent can operate independently with built-in support for real-time communication, scheduling, AI model integration, and more. A key architectural advantage is that agents automatically hibernate when idle and activate on demand, allowing millions of concurrent agents to run cost-effectively since inactive agents incur no charges.
The core SDK encompasses a comprehensive feature set designed for production agentic workloads. Persistent state automatically syncs across all connected clients and survives restarts. Type-safe RPC is enabled through callable methods decorated with the @callable() decorator. The framework supports sub-agents through parent-child Durable Object composition via facets and nested routing. Agents can execute as tools themselves with streaming child timelines, and the platform includes one-time, recurring, and cron-based task scheduling. Real-time bidirectional communication occurs through WebSocket connections with lifecycle hooks, while AI chat functionality provides message persistence and resumable streaming. The SDK acts as both MCP servers and clients across multiple transport protocols, exposes browser-side tools to agents via WebMCP, and supports durable multi-step workflows with human-in-the-loop approval capabilities.
The repository is organized into multiple specialized packages. The core agents package contains the Agent class, routing, state management, scheduling, MCP, email, workflows, x402 payments, and browser agent support. The ai-chat package provides higher-level AI chat abstractions with persistent messages and tool execution. The think package offers an opinionated chat agent base with agentic loops and stream resumption. Additional packages handle code mode execution where LLMs generate executable TypeScript, sandboxed execution with virtual filesystems, voice pipelines with STT and TTS, runtime Workers bundling, and Hono middleware integration.
The repository includes over 30 self-contained examples demonstrating various capabilities including a kitchen-sink playground showcasing all features, multiple chat and assistant implementations, MCP server and client patterns, code mode and sandbox examples, voice agents, workflow approvals, authentication, payments, email integration, and game implementations. Examples also cover integration with the OpenAI Agents SDK.
According to GitGenius activity tracking, the repository shows strong engagement with a median issue and pull request response latency of 1.9 hours across 592 tracked items, though mean latency reaches 135 hours indicating some complex discussions. The most active issue labels are enhancement with 91 items, bug with 55 items, and mcp with 41 items. Primary contributors include threepointone with 1066 tracked events, whoiskatrin with 571 events, and mattzcarey with 194 events. The repository overlaps with other Cloudflare projects including workers-sdk, and external projects like gitpod and opencode based on shared contributor networks.
Development uses Node 24 or higher with pnpm workspaces and Nx for task orchestration. The project is classified across edge computing, serverless, distributed systems, and developer tools domains. While external pull requests are not currently accepted due to rapid SDK evolution, the maintainers actively encourage bug reports, feature requests, and community discussion through GitHub issues and discussions.
