Start with Flue. Reach for the SDK when you need the runtime.

Flue 2.1 on Cloudflare

Build an autonomous TypeScript agent with a programmable hooks-based harness, Pi model providers, durable conversations, tools, skills, subagents, channels, and optional sandboxes.

npx @flue/cli@2.1.0 init my-agent --target cloudflare
cd my-agent
npm install
npm run check:types
npm run dev
npm run deploy

• Use Flue first for a new autonomous agent. Move to Agents SDK when you need non-Pi harnesses or SDK-specific lifecycle and communication primitives.
• The Cloudflare target composes Flue's generated agent classes with the Cloudflare Agents SDK runtime.

Agents Starter

Start a real-time React chat agent with AI SDK models, Workers AI, state sync, tool calls, durable approvals, scheduling, vision, and WebSockets.

npm create cloudflare@latest -- --template cloudflare/agents-starter
cd agents-starter
npm install
npm run dev
npm run deploy

• Choose this when you do not want the Pi harness or need direct Agents SDK APIs and lifecycle control.

Codex App Server

Run Codex in a Cloudflare Sandbox behind a WebSocket middleman, with a streaming UI, composable policy handlers, restricted egress, and secret injection outside the container.

git clone --depth 1 https://github.com/cloudflare/sandbox-sdk
cd sandbox-sdk/examples/codex-app-server
cp .dev.vars.example .dev.vars
npm install
npm run dev
npm run deploy

• Requires a Workers Paid plan, Docker, and an OpenAI credential.

Concurrent workflows with approval

Launch durable concurrent jobs from an Agent, stream progress into synchronized state, and pause for human approval without losing execution history.

git clone --depth 1 https://github.com/cloudflare/agents
cd agents/examples/workflows
npm install
npm run types
npm run start

Agents as Tools

Delegate to subagents, fan out work in parallel, detach long-running tasks, stream progress, cancel runs, and inspect durable milestones.

git clone --depth 1 https://github.com/cloudflare/agents
cd agents/examples/agents-as-tools
npm install
npm start

• The example's search and file-inspection tools are simulated; replace them with real tools for a project.

Browser Live View

Automate a persistent browser session, expose its live view, hand control to a human for blocked steps, and resume the agent after intervention.

git clone --depth 1 https://github.com/cloudflare/agents
cd agents
pnpm install
cd examples/browser-live-view
pnpm start

Voice Agent

Add speech-to-text, model turns, tool calls, and text-to-speech over a real-time WebSocket connection.

npm create cloudflare@latest voice-agent -- --template cloudflare/agents-starter
cd voice-agent
npm install @cloudflare/voice
npm run dev

Agent with AI Search

Provision an AI Search instance, index content, and expose retrieval as a model tool from a stateful chat agent.

npm create cloudflare@latest -- ai-search-agent
cd ai-search-agent
npm i agents @cloudflare/ai-chat ai workers-ai-provider zod
npx wrangler types
npm run dev

Stateless MCP Worker

Publish tools through the current stateless MCP handler path on Workers, with Streamable HTTP and no protocol session Durable Object.

git clone --depth 1 https://github.com/cloudflare/agents
cd agents/examples/mcp-worker
pnpm install
pnpm start

Agent Skills

Give an agent a catalog of instructions and resources that it activates only when a task matches, instead of putting every capability into every prompt.

git clone --depth 1 https://github.com/cloudflare/agents
cd agents/examples/agent-skills
npm install
npm start

Code Interpreter

Use Workers AI function calling to write and execute Python in an isolated Sandbox with file operations and structured results.

git clone --depth 1 https://github.com/cloudflare/sandbox-sdk
cd sandbox-sdk/examples/code-interpreter
npm install
npm run dev

VibeSDK

Use a production-grade text-to-app platform built with Think, project Durable Objects, Artifacts, Dynamic Workers, Facets, and AI Gateway.