# Stagehand Python 4.5.0a0.dev1712 adds browser size option to browse CLI

published: 2026-11-18T06:05:25.657Z
topic: infrastructure
source: https://github.com/browserbase/stagehand/releases/tag/stagehand-python%404.5.0a0.dev1712
url: https://aiagentnews.io/stories/stagehand-python-4-5-0a0-dev1712-adds-browser-size-option-to-browse-cli

Browserbase's stagehand-python 4.5.0a0.dev1712 release adds a --size flag to the browse CLI for cloud session creation. The flag accepts regular, large or xlarge, and an explicit value overrides any size set in --body.

The change adds a --size option to browse cloud sessions create, which accepts regular, large or xlarge. When the flag is left out, session creation behaves as it did before.

An explicit --size takes precedence over the size field in a --body payload. The release also adds help text, a README example and a release changeset for the new option.

According to the release notes, the change was checked against a local fake API for all three sizes, an omitted size, --body handling and rejection of invalid sizes, and 11 focused tests pass.

## Why it matters if you build agents

Developers who create Browserbase sessions from scripts or agent pipelines can now request a browser size directly from the CLI instead of editing a request body.

If your tooling already sets size inside --body, check whether an explicit --size flag would override it in your runs.
