docs: remove Browserbase project ID references

[shrey150]

Summary

• Remove all BROWSERBASE_PROJECT_ID / projectId references from v3 docs, SDK docs, integration guides, migration guides, and CLI README (30 files)
• Only BROWSERBASE_API_KEY is required — projectId is optional in all code control paths (conditionally included via spread patterns, never validated as required)
• Preserves unrelated GCP project ID references in models.mdx

Test plan

• Verify docs site builds without errors
• Spot-check code examples still make sense without projectId
• Confirm no broken references or formatting issues

🤖 Generated with Claude Code

---

Summary by cubic

Removed all BROWSERBASE_PROJECT_ID/projectId references across v3 docs so setup only requires BROWSERBASE_API_KEY. Also updated Anthropic model references to anthropic/claude-sonnet-4-6 across examples and guides.

• Migration

  • Remove BROWSERBASE_PROJECT_ID from env files, deployment configs, session params, and env var lists; keep BROWSERBASE_API_KEY only.
  • Existing code passing projectId still works; it’s optional and not required.
  • Unrelated GCP project ID mentions remain unchanged.

• Refactors

  • Replaced all anthropic/claude-sonnet-4-20250514 references with anthropic/claude-sonnet-4-6 across v3 docs (agent examples, warnings, best practices).
  • Simplified MCP config by removing the CardGroup wrapper around a single card.

^{Written for commit 7a1688d. Summary will update on new commits. Review in cubic}

[mintlify]

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

Project	Status	Preview	Updated (UTC)
stagehand	🟢 Ready	View Preview	Apr 5, 2026, 8:47 PM

[changeset-bot]

⚠️ No Changeset found

Latest commit: 7a1688d

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]

1 issue found across 30 files

Confidence score: 5/5

• This looks low risk to merge: the only issue is a documentation layout mismatch in packages/docs/v3/integrations/mcp/configuration.mdx, not application logic.
• The reported change (<CardGroup cols={2}> with a single remaining card) is a minor presentation cleanup with limited user impact.
• Pay close attention to packages/docs/v3/integrations/mcp/configuration.mdx - align the CardGroup wrapper/column count with the single-card content to avoid awkward docs rendering.

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="packages/docs/v3/integrations/mcp/configuration.mdx">

<violation number="1" location="packages/docs/v3/integrations/mcp/configuration.mdx:28">
P3: `<CardGroup cols={2}>` now contains only one card after the `BROWSERBASE_PROJECT_ID` card was removed. Either remove the `CardGroup` wrapper or change to `cols={1}`.</violation>
</file>

Architecture diagram

sequenceDiagram
    participant App as "User Application"
    participant Env as "Environment (.env)"
    participant SDK as "Stagehand SDK"
    participant BB_API as "Browserbase API"
    participant Browser as "Remote Browser"
    participant LLM as "LLM Provider (OpenAI/Anthropic/Gemini)"

    Note over App,Env: Configuration Phase
    App->>Env: CHANGED - Load BROWSERBASE_API_KEY
    Note right of Env: BROWSERBASE_PROJECT_ID is now optional

    App->>SDK: new Stagehand({ env: "BROWSERBASE", apiKey })
    
    Note over SDK,BB_API: Session Initialization
    SDK->>SDK: CHANGED - Construct session params (omit projectId if missing)
    
    SDK->>BB_API: POST /sessions (Headers: x-api-key)
    alt Optional Project Selection
        SDK->>BB_API: Include projectId in payload (if manually provided)
    else Default Project
        SDK->>BB_API: Payload without projectId
    end
    
    BB_API-->>SDK: Session ID & Connect URL
    
    Note over SDK,Browser: Execution Loop
    SDK->>Browser: Connect via WebSocket (CDP)
    
    loop Task Execution (act / extract / observe)
        SDK->>Browser: Fetch DOM / Screenshot
        Browser-->>SDK: Page State
        
        SDK->>LLM: Send context + prompt
        LLM-->>SDK: Structured Action/Data
        
        SDK->>Browser: Execute Playwright/Puppeteer commands
    end

    SDK-->>App: Return Result

Loading

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review, or fix all with cubic.}

[cubic-dev-ai]

1 issue found across 2 files (changes from recent commits).

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="packages/docs/v3/references/agent.mdx">

<violation number="1" location="packages/docs/v3/references/agent.mdx:488">
P2: This model name was updated to `claude-sonnet-4-6` here but four other occurrences of `claude-sonnet-4-20250514` remain in this file (lines 66, 135, 535, 715). Since the dated Sonnet 4 variant retires by May 2026, consider updating the remaining references for consistency — particularly the nearby "Advanced Model Config" example at line 535.

(Based on your team's feedback about using claude-sonnet-4-6 instead of the dated Sonnet 4 variant.) [FEEDBACK_USED]</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review, or fix all with cubic.}