Skip to content
Agents tracked: 258 Downloads (7d): 219M up 6.1% GitHub stars: 5.5M VS Code installs: 148M Releases (7d): 293 Agent status: 2 with issues Updated Oct 7, 2026
AgentGid

Stagehand changelog: what's new each month

Every stable Stagehand release summarised by month: the highlights, new features, improvements, fixes and anything you need to act on. 3 months covered; the current month updates daily.

August 2026

4 releases: 0.9.6 → 3.7.3

August brought improved error messaging, coordinate handling fixes, and dependency updates across multiple releases. The month focused on reliability and clarity for users running browser automation sessions.

Highlights

  • Human-readable daemon connection errors now show the exact command needed to start a session.
  • Fixed coordinate normalization to match actual viewport dimensions in browser interactions.
  • Corrected xpath building logic for elements inside iframes across frames.
  • Updated MCP SDK and transitive dependencies for better compatibility.

New

  • BROWSELOADDOTENV option to control automatic .env file loading behavior.

Improved

  • Daemon socket connection errors now display actionable guidance instead of raw technical messages.
  • XPath coordinate handling improved for nested iframe elements.
  • Structured output now preserves the selected provider across operations.
  • useTouch parameter properly released on server in v3.
  • MCP SDK updated to version 1.30 with refreshed dependency versions.

Fixed

  • CUA coordinates are now normalized to match actual viewport dimensions.
  • XPath building logic fixed for coordinates inside iframes.
  • Cross-frame xpath construction corrected for proper element selection.

July 2026

3 releases: 3.7.0 → 3.7.4

July brought domain access controls, improved AI model flexibility, and refinements to the agent's interaction with web pages and messaging systems. The release focused on security, performance, and compatibility enhancements.

Highlights

  • New domain policy controls let you define which domains Stagehand can access or block.
  • Model selection now supports "auto" mode in the constructor and per-primitive overrides for flexible AI model routing.
  • Reduced noise from AI SDK warnings that were logged on every agent execution.
  • Fixed key combination handling to press modifier keys and actions as proper chords.
  • Added support for OpenAI Chat Completions API endpoint format.

New

  • Domain policy API with allowedDomains and blockedDomains configuration options.
  • Automatic popup closing when popups violate user-defined domain policies.
  • Support for "auto" model selection in the Stagehand constructor.
  • Per-primitive model overrides when running through the Stagehand API.
  • OpenAI Chat Completions endpoint format support.
  • OdysseysBench agent benchmark for evaluation.

Improved

  • Removed repetitive AI SDK warnings from hybrid and DOM agent execution.
  • Screenshot provider now uses declared media type when sending images to models.
  • Silenced system message warnings in act, extract, and observe operations.
  • UTF-16 snapshot text is now repaired before reaching model prompts.
  • Browse CLI skill sourcing improved for better package resolution.
  • Opt-out flag added for browse CLI .env auto-loading with warning.

Fixed

  • CUA keypress actions now correctly press key combinations as single chords.
  • Malformed UTF-16 snapshot text that could corrupt model prompts.
  • Screenshot provider callback interface to properly return ScreenshotProviderResult.
  • Browser skill evaluation sourcing from correct CLI packages directory.

June 2026

7 releases: 3.5.0 → 0.9.0

June brought significant improvements to model support, browser automation reliability, and developer experience. The month focused on enhanced extraction capabilities, better authentication options, and improved handling of complex browser scenarios.

Highlights

  • Added screenshot option to extract() to include viewport screenshots alongside accessibility trees for better extraction accuracy.
  • Introduced WebMCP support for enhanced protocol capabilities and browser automation.
  • Added support for Claude Fable 5 with native structured outputs and adaptive thinking modes.
  • Improved URL handling in action caching by normalizing query parameters to avoid duplicate cache entries.
  • Fixed XPath resolution for elements inside web components and shadow roots.

New

  • Screenshot option for extract() that sends viewport screenshots with accessibility tree data.
  • Native clipboard API support.
  • WebMCP protocol support in browser automation.
  • Azure OpenAI Microsoft Entra ID authentication support.
  • Claude Fable 5 support with native structured outputs and adaptive thinking effort levels including new 'xhigh' option.
  • Rubric-based verifier engine with normalized public rubric output.
  • Azure Entra model auth support.
  • Browse screenshot command now writes files by default instead of printing base64 to stdout.

Improved

  • Added ignoreDefaultArgs option to selectively remove Chrome launcher default flags when running locally.
  • Improved handling of rapidly opening and closing popups to prevent target closed errors.
  • Enhanced DOM.getDocument to retry on max depth exceeded with exponential backoff.
  • Normalized URLs in action cache key derivation by sorting query parameters before hashing.
  • Fixed XPath resolution for elements inside web components and shadow roots for deterministic action targeting.
  • Added canonical verifier evidence normalization for screenshots and text signals without requiring image dependencies.
  • Improved Windows compatibility for browse skills installation with proper quoting and timeout handling.
  • Local browser launches now include WebMCP testing and DevTools WebMCP support by default.

Fixed

  • Fixed Anthropic CUA tripleclick action mapping.
  • Fixed local browser launch options forwarding when attaching over CDP to respect viewport settings.
  • Fixed ToolSet import in core public exports.
  • Fixed shadow-root XPath resolution for deterministic actions targeting web component elements.
  • Fixed browse skills installation hanging on Windows by adding 180-second deadline with SIGTERM and SIGKILL.
  • Fixed unbounded installer stages for browse skills add command.

Summaries are written automatically from the official release notes (full changelog ↗); check the original notes before relying on a detail. Stagehand: pricing, features and alternatives · All changelogs