infochanged

Agents - New persistent browser tool in the Agents SDK, with tabs and logins that last between turns

Announced: 2026-10-13
Tags: Agents
Severity: info, set by reef/rss-rule-v1
Source: https://developers.cloudflare.com/changelog/post/2026-10-13-persistent-browser/

The <a href="https://developers.cloudflare.com/agents/">Cloudflare Agents SDK</a> now provides a <code>browserTool</code> that gives your agent a <a href="https://developers.cloudflare.com/browser-run/">Browser Run</a> browser it can return to on later turns. Your agent can open a website, inspect a page, and come back to it with its tabs, cookies, and login session intact while the browser session remains alive. When you give <code>browserTool</code> to your agent, the model writes code that drives the browser through the <a href="https://developers.cloudflare.com/browser-run/cdp/">Chrome DevTools Protocol (CDP)</a>. Screenshots return as images that an image-capable model can inspect and your UI can display. To use <code>browserTool</code>, make sure you have <a href="https://github.com/cloudflare/agents/releases/tag/agents%400.28.0" target="_blank" rel="noopener">Agents SDK v0.28.0 ↗︎</a> or greater installed. Create a <code>Browser</code>, register it with your object's <a href="https://developers.cloudflare.com/agents/runtime/lifecycle/">Lifecycle</a>, and add the tool to a <a href="https://developers.cloudflare.com/agents/harnesses/pi/">Pi Durable</a> <a href="https://developers.cloudflare.com/agents/harnesses/pi/extensions/">extension registry</a> before opening the harness: <div><div data-nb-tabs data-nb-sync-key="workersExamples" class><div class="relative flex border-b border-border" role="tablist" data-nb-tabs-list></div><div class="mt-3"><div role="tabpanel" data-nb-tabs-content data-nb-tab-label="JavaScript" class><figure class="nb-code-figure" data-nb-lang="js"><pre class="astro-code astro-code-themes github-light github-dark nb-shiki-c6xiwz" tabindex="0" data-language="js" data-nb-lang="js"><code>import { Browser, browserRun } from "agents/browser"; import { browserTool } from "agents/browser/pi"; export class MyAgent extends DurableObject { // ... browser = new Browser({ provider: browserRun(this.env.BROWSER) }); harness = new PiHarness({ harness: async ({ storage, context }) => { this.registry.install({ name: "browser", tools: [ browserTool({ ctx: this.ctx, browser: this.browser, loader: this.env.LOADER, }), ], }); // ... return Harness.open( storage, { models, registry: this.registry }, context, ); }, }); lifecycle = Lifecycle.install(this).use(this.browser).use(this.harness); }</code></pre></figure></div><div role="tabpanel" data-nb-tabs-content data-nb-tab-label="TypeScript" class><figure class="nb-code-figure" data-nb-lang="ts"><pre class="astro-code astro-code-themes github-light github-dark nb-shiki-c6xiwz" tabindex="0" data-language="ts" data-nb-lang="ts"><code>import { Browser, browserRun } from "agents/browser"; import { browserTool } from "agents/browser/pi"; export class MyAgent extends DurableObject<Env> { // ... browser = new Browser({ provider: browserRun(this.env.BROWSER) }); harness = new PiHarness({ harness: async ({ storage, context }) => { this.registry.install({ name: "browser", tools: [ browserTool({ ctx: this.ctx, browser: this.browser, loader: this.env.LOADER, }), ], }); // ... return Harness.open( storage, { models, registry: this.registry }, context, ); }, }); lifecycle = Lifecycle.install(this).use(this.browser).use(this.harness); }</code></pre></figure></div></div></div><script type="module" src="https://developers.cloudflare.com/home/runner/work/cloudflare-docs/cloudflare-docs/src/components/ui/tabs/Tabs.astro?astro&type=script&index=0&lang.ts"></script></div> Each Pi conversation gets its own active tab by default. Cookies and logins remain shared within the browser. The browser stays alive between turns, including when the Durable Object hibernates. Its default idle timeout is 10 minutes. If the session expires or crashes, the tool creates a fresh browser and reports <code>restarted: true</code>. The old tabs and login state are gone. You can also use the persistent browser with the AI SDK and TanStack AI adapters, or connect another harness through the public Browser and CDP APIs. Refer to <a href="https://developers.cloudflare.com/agents/tools/browser/#return-to-the-same-browser">persistent browser tools</a> for the complete Pi Durable example, required bindings, and behavior when a tool call is interrupted.

The text above is the source's. reef added the severity, the dates it could read from the text, and the endpoints and scopes named in code.