Skip to content

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

Open
mattzcarey wants to merge 5 commits into
docs/agents-tools-restructurefrom
docs/agents-code-mode
Open

mattzcarey wants to merge 5 commits into
docs/agents-tools-restructurefrom
docs/agents-code-mode

Conversation

@mattzcarey

@mattzcarey mattzcarey commented Nov 9, 2026 •

Copy link
Copy Markdown
Member

Code Mode moves out of Tools. A new concept page, /agents/concepts/code-mode/, explains why models write code instead of calling tools one at a time. A new Runtime section, /agents/runtime/code-mode/, covers how 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 --> Backend["CodemodeBackend"]
    Backend --> DW["Dynamic Worker"]
Loading
  • Concept: 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.
  • Runtime > Code Mode: Computer (recommended), containers, skill scripts (moved from skills/execution), and a page that maps @cloudflare/codemode (createCodeTool(), DynamicWorkerExecutor, connectors, the durable runtime) to Computer.
  • Computer pages use @cloudflare/computer 0.10: CodemodeBackend from @cloudflare/computer/backends/codemode, and codemode:* host modules.
  • The human-in-the-loop Code Mode section uses ctx.interrupt() in place of the durable runtime from @cloudflare/codemode.
  • The AI Search human-in-the-loop tutorial is rebuilt on Computer: 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.
  • Think pages only get link updates here. Their move to Computer 0.10 is in [Agents] Fix Think samples and add a Think memory and context page #35055.

Builds on #35056 (Workspace rename). Computer and tutorial samples typecheck against @cloudflare/computer@0.10.0. nimbus-docs lint and bin/validate-redirects.ts pass, and the pages compile as MDX. Replaces #34745.

@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 Nov 9, 2026
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Nov 9, 2026 •

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://docs-agents-code-mode.previews.developers.cloudflare.com (commit aefa2c4)

This URL reflects your latest Preview deployment

Preview Deployments by commit

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

View logs ↗
aa750ef 2026-11-11T11:14:55.329Z View logs ↗
  • Build: Failed ❌

View logs ↗
ca4ef7f 2026-11-10T12:07:10.935Z View logs ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://2bd9de32.previews.developers.cloudflare.com aefa2c4 2026-11-09T19:47:28.948Z Visit the dashboard ↗

@mattzcarey

Copy link
Copy Markdown
Member Author

/draft-never-stale

@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 Nov 10, 2026 •

Copy link
Copy Markdown
Contributor

CI run failed: build logs

@github-actions

Copy link
Copy Markdown
Contributor

Worker Preview URL: https://gh-docs-agents-code-mode.previews.developers.cloudflare.com
Worker Preview Deployment URL: https://a3420cb0.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-code-mode.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-code-mode.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-code-mode.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-code-mode.previews.developers.cloudflare.com/agents/tools/codemode/how-it-works/
https://developers.cloudflare.com/agents/runtime/code-mode/computer/ https://gh-docs-agents-code-mode.previews.developers.cloudflare.com/agents/runtime/code-mode/computer/
https://developers.cloudflare.com/agents/tools/codemode/durable-runtime/ https://gh-docs-agents-code-mode.previews.developers.cloudflare.com/agents/tools/codemode/durable-runtime/
https://developers.cloudflare.com/agents/tools/codemode/ai-sdk/ https://gh-docs-agents-code-mode.previews.developers.cloudflare.com/agents/tools/codemode/ai-sdk/
https://developers.cloudflare.com/agents/tools/codemode/openapi/ https://gh-docs-agents-code-mode.previews.developers.cloudflare.com/agents/tools/codemode/openapi/
https://developers.cloudflare.com/agents/tools/codemode/browser/ https://gh-docs-agents-code-mode.previews.developers.cloudflare.com/agents/tools/codemode/browser/
https://developers.cloudflare.com/agents/tools/codemode/mcp/ https://gh-docs-agents-code-mode.previews.developers.cloudflare.com/agents/tools/codemode/mcp/
https://developers.cloudflare.com/agents/runtime/code-mode/executor/ https://gh-docs-agents-code-mode.previews.developers.cloudflare.com/agents/runtime/code-mode/executor/
https://developers.cloudflare.com/agents/tools/codemode/tanstack-ai/ https://gh-docs-agents-code-mode.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-code-mode.previews.developers.cloudflare.com/agents/concepts/agentic-patterns/human-in-the-loop/
https://developers.cloudflare.com/agents/concepts/code-mode/ https://gh-docs-agents-code-mode.previews.developers.cloudflare.com/agents/concepts/code-mode/
https://developers.cloudflare.com/agents/runtime/code-mode/legacy/ https://gh-docs-agents-code-mode.previews.developers.cloudflare.com/agents/runtime/code-mode/legacy/

@mattzcarey
mattzcarey force-pushed the docs/agents-code-mode branch from aefa2c4 to ca4ef7f Compare November 10, 2026 12:02
@mattzcarey
mattzcarey marked this pull request as ready for review November 11, 2026 11:09
@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Nov 11, 2026 •

Copy link
Copy Markdown
Contributor

AI Review

✅ Reviewed aa750ef · 0 findings · incremental

Not reviewed (10)
  • src/content/docs/agents/model-context-protocol/guides/build-codemode-mcp-server.mdx — deleted file
  • src/content/docs/agents/tools/codemode/ai-sdk.mdx — deleted file
  • src/content/docs/agents/tools/codemode/api-reference.mdx — deleted file
  • src/content/docs/agents/tools/codemode/browser.mdx — deleted file
  • src/content/docs/agents/tools/codemode/durable-runtime.mdx — deleted file
  • src/content/docs/agents/tools/codemode/how-it-works.mdx — deleted file
  • src/content/docs/agents/tools/codemode/index.mdx — deleted file
  • src/content/docs/agents/tools/codemode/mcp.mdx — deleted file
  • src/content/docs/agents/tools/codemode/openapi.mdx — deleted file
  • src/content/docs/agents/tools/codemode/tanstack-ai.mdx — deleted file
Commands
  • /review Run a review now.
  • /full-review Review the entire PR diff.
  • /disable-auto-review Stop automatic reviews.
  • /rebase Rebase against production.

@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Nov 11, 2026 •

Copy link
Copy Markdown
Contributor

Review coverage

✅ All 7 ownership areas are covered.

✅ 7 areas already covered
Area Approved by
ai-search
1 file changed
irvinebroque
workers
1 file changed
irvinebroque
Other
1 file changed
/public/__redirects
irvinebroque
cloudflare-one
1 file changed
irvinebroque
dynamic-workers
1 file changed
irvinebroque
agents
37 files changed
irvinebroque
sandbox
3 files changed
irvinebroque
CODEOWNERS mappings for displayed areas (7)
Pattern Owners
/src/content/docs/ai-search/ @celso, @G4brym, @irvinebroque, @mchenco, @rita3ko, @cloudflare/product-owners
/src/content/docs/workers/ @GregBrimble, @irvinebroque, @korinne, @MattieTK, @mikenomitch, @vy-ton, @WalshyDev, @cloudflare/deploy-config, @cloudflare/dev-plat-leads, @cloudflare/workers-runtime-1, @cloudflare/wrangler, @cloudflare/product-owners
/public/__redirects @cloudflare/product-owners, @cloudflare/content-engineering
/src/content/docs/cloudflare-one/access-controls/ @asamborski, @kennyj42, @cloudflare/cf1-reviewers, @cloudflare/product-owners
/src/content/docs/dynamic-workers/ @GregBrimble, @irvinebroque, @korinne, @MattieTK, @mikenomitch, @WalshyDev, @cloudflare/deploy-config, @cloudflare/dev-plat-leads, @cloudflare/workers-runtime-1, @cloudflare/wrangler, @cloudflare/product-owners
/src/content/docs/agents/ @irvinebroque, @rita3ko, @cloudflare/ai-agents, @cloudflare/dev-plat-leads, @cloudflare/product-owners
/src/content/docs/sandbox/ @cloudflare/ai-agents, @cloudflare/product-owners

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.

2 participants