Skip to content

[Agents] Move Code Mode to a concept and a Runtime section - #34745

Draft
mattzcarey wants to merge 2 commits into
productionfrom
docs/agents-codemode-concepts
Draft

mattzcarey wants to merge 2 commits into
productionfrom
docs/agents-codemode-concepts

Conversation

@mattzcarey

@mattzcarey mattzcarey commented Oct 29, 2026 •

Copy link
Copy Markdown
Member

Code Mode moves out of Tools. A new concept page, /agents/concepts/code-mode/, explains why we let models write code. A new Runtime section, /agents/runtime/code-mode/, lists the ways to run that code. The nine tools/codemode/* guides and the Code Mode MCP server guide are removed, with redirects.

flowchart LR
    Model["Model writes code"] -->|"exec"| Computer["@cloudflare/computer<br/>Workspace, codemode:* modules"]
    Computer --> Exec["@cloudflare/codemode<br/>WorkerJavaScriptBackend"]
    Exec --> DW["Dynamic Worker"]
Loading

@cloudflare/codemode now holds only the executor, and the old API is frozen (cloudflare/agents#2609). Computer runs code on that executor, and tools reach the code as codemode:* modules (cloudflare/computer#283). The docs now follow that split:

  • Concept: models write better code than tool calls, code is a compact plan, tools become modules (which is how an agent gets many more tools), and the sandbox is kept apart from the credentials. It covers client-side Code Mode, which runs in the agent and is the recommended path, and server-side Code Mode with search/execute, linking to cloudflare/mcp and the codemode-mcp-openapi example.
  • Runtime > Code Mode: Computer (recommended), the executor used on its own, containers, skill scripts (moved from skills/execution), and a legacy page that maps each frozen export to its replacement.
  • ws: becomes codemode: in the Computer and Think pages. The human-in-the-loop Code Mode section now uses ctx.interrupt() in place of the legacy durable runtime. Links in Sandbox, Dynamic Workers, Worker Loader and MCP portals now point to the new pages.
  • The AI Search human-in-the-loop tutorial is rewritten on Computer. It now uses a Durable Object with the Lifecycle, a codemode:kb host module that calls ctx.interrupt() before each save, and a rollback that deletes saves recorded in SQLite. I deployed the tutorial code to the agents account and ran the approve, reject and rollback paths against real AI Search and Workers AI.

Merge this after cloudflare/agents#2609 and cloudflare/computer#283 are released. The legacy page links to docs/codemode/legacy*.md, which only exist once #2609 lands.

astro build passes, bin/validate-redirects.ts passes, and every internal link and anchor in the changed files resolves in dist.

@github-actions github-actions Bot added product:workers Related to Workers product product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. product:ai-search product:sandbox product:dynamic-workers product:access labels Oct 29, 2026
@github-actions

Copy link
Copy Markdown
Contributor

This PR changes current filenames or deletes current files. Make sure you have redirects set up to cover the following paths:

  • /agents/model-context-protocol/guides/build-codemode-mcp-server/
  • /agents/skills/execution/
  • /agents/tools/codemode/ai-sdk/
  • /agents/tools/codemode/api-reference/
  • /agents/tools/codemode/browser/
  • /agents/tools/codemode/durable-runtime/
  • /agents/tools/codemode/how-it-works/
  • /agents/tools/codemode/
  • /agents/tools/codemode/mcp/
  • /agents/tools/codemode/openapi/
  • /agents/tools/codemode/tanstack-ai/
@github-actions

github-actions Bot commented Oct 29, 2026 •

Copy link
Copy Markdown
Contributor

CI run failed: build logs

@github-actions

github-actions Bot commented Oct 29, 2026 •

Copy link
Copy Markdown
Contributor

Worker Preview URL: https://gh-docs-agents-codemode-concepts.previews.developers.cloudflare.com
Worker Preview Deployment URL: https://4d560711.previews.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/agents/tools/codemode/api-reference/ https://gh-docs-agents-codemode-concepts.previews.developers.cloudflare.com/agents/tools/codemode/api-reference/
https://developers.cloudflare.com/ai-search/how-to/human-in-the-loop-knowledge-base/ https://gh-docs-agents-codemode-concepts.previews.developers.cloudflare.com/ai-search/how-to/human-in-the-loop-knowledge-base/
https://developers.cloudflare.com/agents/model-context-protocol/guides/build-codemode-mcp-server/ https://gh-docs-agents-codemode-concepts.previews.developers.cloudflare.com/agents/model-context-protocol/guides/build-codemode-mcp-server/
https://developers.cloudflare.com/agents/tools/codemode/how-it-works/ https://gh-docs-agents-codemode-concepts.previews.developers.cloudflare.com/agents/tools/codemode/how-it-works/
https://developers.cloudflare.com/agents/runtime/code-mode/computer/ https://gh-docs-agents-codemode-concepts.previews.developers.cloudflare.com/agents/runtime/code-mode/computer/
https://developers.cloudflare.com/agents/tools/codemode/durable-runtime/ https://gh-docs-agents-codemode-concepts.previews.developers.cloudflare.com/agents/tools/codemode/durable-runtime/
https://developers.cloudflare.com/agents/tools/codemode/ai-sdk/ https://gh-docs-agents-codemode-concepts.previews.developers.cloudflare.com/agents/tools/codemode/ai-sdk/
https://developers.cloudflare.com/agents/tools/codemode/openapi/ https://gh-docs-agents-codemode-concepts.previews.developers.cloudflare.com/agents/tools/codemode/openapi/
https://developers.cloudflare.com/agents/tools/codemode/browser/ https://gh-docs-agents-codemode-concepts.previews.developers.cloudflare.com/agents/tools/codemode/browser/
https://developers.cloudflare.com/agents/tools/codemode/mcp/ https://gh-docs-agents-codemode-concepts.previews.developers.cloudflare.com/agents/tools/codemode/mcp/
https://developers.cloudflare.com/agents/runtime/code-mode/executor/ https://gh-docs-agents-codemode-concepts.previews.developers.cloudflare.com/agents/runtime/code-mode/executor/
https://developers.cloudflare.com/agents/tools/codemode/tanstack-ai/ https://gh-docs-agents-codemode-concepts.previews.developers.cloudflare.com/agents/tools/codemode/tanstack-ai/
https://developers.cloudflare.com/agents/concepts/agentic-patterns/human-in-the-loop/ https://gh-docs-agents-codemode-concepts.previews.developers.cloudflare.com/agents/concepts/agentic-patterns/human-in-the-loop/
https://developers.cloudflare.com/agents/concepts/code-mode/ https://gh-docs-agents-codemode-concepts.previews.developers.cloudflare.com/agents/concepts/code-mode/
https://developers.cloudflare.com/agents/runtime/code-mode/legacy/ https://gh-docs-agents-codemode-concepts.previews.developers.cloudflare.com/agents/runtime/code-mode/legacy/
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Oct 29, 2026 •

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://docs-agents-codemode-concepts.previews.developers.cloudflare.com (commit 8d47fff)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://f8b5dbd3.previews.developers.cloudflare.com 8d47fff 2026-10-29T21:44:53.724Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://23285d9f.previews.developers.cloudflare.com 9850590 2026-10-29T19:05:32.193Z Visit the dashboard ↗
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:access product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. product:ai-search product:dynamic-workers product:sandbox product:workers Related to Workers product size/xl

1 participant