Skip to content

[Agents] Think works in a @cloudflare/computer Workspace; @cloudflare/shell deprecated - #34473

Merged
mattzcarey merged 3 commits into
productionfrom
agents-shell-deprecation-changelog
Oct 20, 2026
Merged

mattzcarey merged 3 commits into
productionfrom
agents-shell-deprecation-changelog

Conversation

@mattzcarey

@mattzcarey mattzcarey commented Oct 20, 2026 •

Copy link
Copy Markdown
Member

Adds a changelog entry for Think moving to a @cloudflare/computer Workspace and @cloudflare/shell being deprecated, and updates the Think docs to match. The Think tools page now covers Computer's workspace tools, exec backends, ws:tools, and upgrading from Shell. The getting started, configuration, Agent Skills, Code Mode AI SDK and browser pages no longer use @cloudflare/shell.

The code is merged in cloudflare/agents (#2559 to #2565) and ships in @cloudflare/think 0.21.0 and @cloudflare/shell 0.5.0 with the Version Packages PR:

  • @cloudflare/shell is deprecated, and Computer's tools replace Think's built-in tools. workspaceBash, createWorkspaceTools and @cloudflare/think/tools/workspace are removed with no replacement; the Workspace's backends decide what exec offers.
  • createExecuteTool is deprecated in favour of exec with ws:tools.
  • Shell data is not moved, so users copy it with the migration guide, which is live on main.

This replaces #34297, rebased on today's production with the changelog dated 2026-10-20. Merge it once cloudflare/agents#2588 has published.

pnpm run check:astro passes with 0 errors, warnings or hints.

@mattzcarey
mattzcarey requested review from a team, irvinebroque and rita3ko as code owners October 20, 2026 15:35
@github-actions github-actions Bot added product:changelog product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. labels Oct 20, 2026
@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Oct 20, 2026 •

Copy link
Copy Markdown
Contributor

AI Review

✅ Reviewed efa8ce5 · 2 findings · incremental

👉 Fix in your agent 👈
Fix the following review findings in PR #34473 (https://github.com/cloudflare/cloudflare-docs/pull/34473).

Before making changes, review each finding and present a brief summary table:
- For each finding, state whether you agree, disagree, or need clarification.
- If you disagree, explain why.
- If you need clarification before deciding, ask those questions.
- Then share your plan for which issues to tackle and in what order.

After triaging, follow this order:
1. Post a comment on this PR for any findings you are skipping, with the finding ID and your reasoning.
2. Then commit the fixes for the legitimate findings.

The comment must come before the commit because the next review reads PR comments.

## Style Guide
- S-1b1c4ed1 | src/content/docs/agents/harnesses/think/tools.mdx:49 | Use `<PackageManagers>` for package install command
  The raw ` ```sh ` block contains only the command `npm install @cloudflare/computer`. Per the code-blocks rules, package-manager install commands should use `<PackageManagers>` instead of a bare code fence.
- S-0f0cc898 | src/content/docs/agents/harnesses/think/tools.mdx:124 | Use `<TypeScriptExample>` for Workers-style code
  This bare ` ```js ` fence exports a `default` handler (code the model runs in a Worker via `exec`). Per the code-blocks rules, ` ```js `/` ```ts ` fences containing Workers-style code should use `<TypeScriptExample>` instead of a bare fence.

Style Guide

  • src/content/docs/agents/harnesses/think/tools.mdx:49 · Use <PackageManagers> for package install command

    The raw ```sh block contains only the command npm install @cloudflare/computer. Per the code-blocks rules, package-manager install commands should use &lt;PackageManagers&gt; instead of a bare code fence.

  • src/content/docs/agents/harnesses/think/tools.mdx:124 · Use <TypeScriptExample> for Workers-style code

    This bare ```js fence exports a default handler (code the model runs in a Worker via exec). Per the code-blocks rules, ```js/```ts fences containing Workers-style code should use &lt;TypeScriptExample&gt; instead of a bare fence.

Commands
  • /review Run a review now.
  • /full-review Review the entire PR diff.
  • /disable-auto-review Stop automatic reviews.
  • /rebase Rebase against production.

@github-actions

github-actions Bot commented Oct 20, 2026 •

Copy link
Copy Markdown
Contributor

Worker Preview URL: https://gh-agents-shell-deprecation-changelog.previews.developers.cloudflare.com
Worker Preview Deployment URL: https://bd2aa407.previews.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/agents/harnesses/think/tools/ https://gh-agents-shell-deprecation-changelog.previews.developers.cloudflare.com/agents/harnesses/think/tools/
https://developers.cloudflare.com/changelog/post/2026-10-20-think-computer-workspace/ https://gh-agents-shell-deprecation-changelog.previews.developers.cloudflare.com/changelog/post/2026-10-20-think-computer-workspace/
https://developers.cloudflare.com/agents/harnesses/think/configuration/ https://gh-agents-shell-deprecation-changelog.previews.developers.cloudflare.com/agents/harnesses/think/configuration/
https://developers.cloudflare.com/agents/tools/codemode/ai-sdk/ https://gh-agents-shell-deprecation-changelog.previews.developers.cloudflare.com/agents/tools/codemode/ai-sdk/
https://developers.cloudflare.com/agents/harnesses/think/getting-started/ https://gh-agents-shell-deprecation-changelog.previews.developers.cloudflare.com/agents/harnesses/think/getting-started/
https://developers.cloudflare.com/agents/tools/browser/ https://gh-agents-shell-deprecation-changelog.previews.developers.cloudflare.com/agents/tools/browser/
https://developers.cloudflare.com/agents/harnesses/think/ https://gh-agents-shell-deprecation-changelog.previews.developers.cloudflare.com/agents/harnesses/think/
https://developers.cloudflare.com/agents/runtime/execution/agent-skills/ https://gh-agents-shell-deprecation-changelog.previews.developers.cloudflare.com/agents/runtime/execution/agent-skills/

Comment thread src/content/changelog/agents/2026-10-20-think-computer-workspace.mdx Outdated
Comment thread src/content/changelog/agents/2026-10-20-think-computer-workspace.mdx Outdated
Comment thread src/content/changelog/agents/2026-10-20-think-computer-workspace.mdx Outdated
Comment thread src/content/changelog/agents/2026-10-20-think-computer-workspace.mdx Outdated
Comment thread src/content/changelog/agents/2026-10-20-think-computer-workspace.mdx Outdated
@cloudflare-workers-and-pages

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

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://agents-shell-deprecation-changelog.previews.developers.cloudflare.com (commit 5a08903)

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://c05e0fc2.previews.developers.cloudflare.com 5a08903 2026-10-20T16:25:30.964Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://de0890b2.previews.developers.cloudflare.com efa8ce5 2026-10-20T16:33:50.039Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://df48cb2a.previews.developers.cloudflare.com d385e8d 2026-10-20T15:53:35.646Z Visit the dashboard ↗

mattzcarey and others added 2 commits October 20, 2026 17:07
Co-authored-by: Aron <263346377+aron-cf@users.noreply.github.com>
@mattzcarey
mattzcarey enabled auto-merge October 20, 2026 16:26
@mattzcarey
mattzcarey added this pull request to the merge queue Oct 20, 2026
Merged via the queue into production with commit 355f5a2 Oct 20, 2026
17 checks passed
@mattzcarey
mattzcarey deleted the agents-shell-deprecation-changelog branch October 20, 2026 16:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. product:changelog size/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants