Skip to content

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

Draft
mattzcarey wants to merge 1 commit into
productionfrom
docs/agents-codemode-concepts
Draft

mattzcarey wants to merge 1 commit into
productionfrom
docs/agents-codemode-concepts

Conversation

@mattzcarey

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, MCP portals and AI Search now point to the new pages.

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

Copy link
Copy Markdown
Contributor

CI run failed: build logs

@github-actions

Copy link
Copy Markdown
Contributor

Worker Preview URL: https://gh-docs-agents-codemode-concepts.previews.developers.cloudflare.com
Worker Preview Deployment URL: https://b5f00aab.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/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/
https://developers.cloudflare.com/agents/tools/codemode/ https://gh-docs-agents-codemode-concepts.previews.developers.cloudflare.com/agents/tools/codemode/

@cloudflare-workers-and-pages

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

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

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://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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant