[docs]: add docs for ignoreDefaultArgs

[seanmcguire12]

what changed

• adds documentation for the localBrowserLaunchOptions.ignoreDefaultArgs param

---

Summary by cubic

Documented localBrowserLaunchOptions.ignoreDefaultArgs and listed the default Chrome args Stagehand adds for local launches. Added examples for removing all defaults or specific args using ignoreDefaultArgs: true or a string array (STG-2213).

^{Written for commit 9479f03. Summary will update on new commits.}

[changeset-bot]

⚠️ No Changeset found

Latest commit: 9479f03

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[cubic-dev-ai]

No issues found across 2 files

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

Architecture diagram

sequenceDiagram
    participant UserCode as User Application
    participant Stagehand as Stagehand.init()
    participant Launcher as Chrome Launcher
    participant Browser as Local Chrome
    
    UserCode->>Stagehand: new Stagehand({ localBrowserLaunchOptions })
    Stagehand->>Stagehand: Store ignoreDefaultArgs
    
    UserCode->>Stagehand: await stagehand.init()
    Stagehand->>Stagehand: Build final args list
    Note over Stagehand: Gather default Chrome args:<br/>--remote-allow-origins=*<br/>--no-first-run<br/>--no-default-browser-check<br/>--disable-dev-shm-usage<br/>--site-per-process
    
    alt ignoreDefaultArgs === true
        Stagehand->>Stagehand: Remove all default args<br/>(Stagehand + Chrome Launcher defaults)
    else ignoreDefaultArgs is string[]
        Stagehand->>Stagehand: Filter out matching default args<br/>by exact string comparison
    else ignoreDefaultArgs === false (default)
        Stagehand->>Stagehand: Keep all default args
    end
    
    Stagehand->>Stagehand: Prepend remaining default args<br/>before user-supplied args
    Stagehand->>Launcher: launch({ args: finalArgs, ... })
    Launcher->>Browser: Start Chrome with filtered args
    Browser-->>Launcher: Browser instance
    Launcher-->>Stagehand: Browser & CDP connection
    Stagehand-->>UserCode: Ready for automation

Loading

_{Re-trigger cubic}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
stagehand	🟢 Ready	View Preview	Jun 9, 2026, 8:07 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.