Computer Use Agents

What is a Computer Use Agent?

You might’ve heard of Gemini Computer Use, Claude Computer Use, or OpenAI’s Computer Using Agent. These are powerful tools that can convert natural language into actions on the computer. However, you’d otherwise need to write your own code to convert these actions into Playwright commands. Stagehand not only handles the execution of Computer Use outputs, but also lets you hot-swap between Google, OpenAI, Anthropic, and Microsoft models with one line of code. You can find more information on the performance of different computer use models by visiting our evals page.

How to use a Computer Use Agent in Stagehand

Stagehand lets you use Computer Use Agents with one line of code:

Deprecation Notice: The cua: true option is deprecated and will be removed in a future version. Use mode: "cua" instead.

IMPORTANT! Configure your browser dimensionsComputer Use Agents will often return XY-coordinates to click on the screen, so you’ll need to configure your browser dimensions.If not specified, the default browser dimensions are 1288 x 711. You can also configure the browser dimensions in the browserbaseSessionCreateParams or localBrowserLaunchOptions options.

Configuring browser dimensions

Browser configuration differs by environment:

BROWSERBASE
LOCAL

import { Stagehand } from "@browserbasehq/stagehand";

const stagehand = new Stagehand({
	env: "BROWSERBASE",
    model: "google/gemini-2.5-flash",
  
    browserbaseSessionCreateParams: {
      browserSettings: {
		blockAds: true,
        viewport: {
          width: 1288,
          height: 711,
        },
      },
  	},
});

await stagehand.init();

import { Stagehand } from "@browserbasehq/stagehand";

const stagehand = new Stagehand({
  env: "LOCAL",
  localBrowserLaunchOptions: {
    headless: false,
    viewport: {
      width: 1288,
      height: 711,
    },
  }
});

await stagehand.init();

Direct your Computer Use Agent

Call execute on the agent to assign a task to the agent.

await page.goto("https://www.google.com/");
const agent = stagehand.agent({
    mode: "cua",
    model: {
        modelName: "google/gemini-2.5-computer-use-preview-10-2025",
        apiKey: process.env.GOOGLE_GENERATIVE_AI_API_KEY
    },
    systemPrompt: "You are a helpful assistant...",
});

await agent.execute({
    instruction: "Go to Hacker News and find the most controversial post from today, then read the top 3 comments and summarize the debate.",
    maxSteps: 20,
    highlightCursor: true
})

await page.goto("https://www.google.com/");
const agent = stagehand.agent({
    mode: "cua",
    model: {
        modelName: "openai/computer-use-preview",
        apiKey: process.env.OPENAI_API_KEY
    },
    systemPrompt: "You are a helpful assistant...",
});

await agent.execute({
    instruction: "Go to Hacker News and find the most controversial post from today, then read the top 3 comments and summarize the debate.",
    maxSteps: 20,
    highlightCursor: true
})

await page.goto("https://www.google.com/");
const agent = stagehand.agent({
    mode: "cua",
    model: {
        modelName: "anthropic/claude-sonnet-4-6",
        apiKey: process.env.ANTHROPIC_API_KEY
    },
    systemPrompt: "You are a helpful assistant...",
});

await agent.execute({
    instruction: "Go to Hacker News and find the most controversial post from today, then read the top 3 comments and summarize the debate.",
    maxSteps: 20,
    highlightCursor: true
})

You can define the maximum number of steps the agent can take with maxSteps:

await agent.execute({
	instructions: "Apply for a library card at the San Francisco Public Library",
	maxSteps: 10,
});

Select Your Computer Use Model

Stagehand supports computer use models from Google, Anthropic, OpenAI, and Microsoft. You can find all supported models on the models page.

Google
Anthropic
OpenAI

const agent = stagehand.agent({
    mode: "cua",
    model: "google/gemini-2.5-computer-use-preview-10-2025",
    // GOOGLE_GENERATIVE_AI_API_KEY is auto-loaded - set in your .env
});

const agent = stagehand.agent({
    mode: "cua",
    model: "anthropic/claude-sonnet-4-6",
    // ANTHROPIC_API_KEY is auto-loaded - set in your .env
});

const agent = stagehand.agent({
    mode: "cua",
    model: "openai/computer-use-preview",
    // OPENAI_API_KEY is auto-loaded - set in your .env
});

View or run the example templates here

First Steps

The Basics

Configuration

Best Practices

Integrations

Reference

Migration Guides

Computer Use Agents

What is a Computer Use Agent?

How to use a Computer Use Agent in Stagehand

Configuring browser dimensions

Direct your Computer Use Agent

Select Your Computer Use Model

​What is a Computer Use Agent?

​How to use a Computer Use Agent in Stagehand

​Configuring browser dimensions

​Direct your Computer Use Agent

​Select Your Computer Use Model

What is a Computer Use Agent?

How to use a Computer Use Agent in Stagehand

Configuring browser dimensions

Direct your Computer Use Agent

Select Your Computer Use Model