docs: Cookbooks tab for Stagehand workflows by antonvishal · Pull Request #2789 · browserbase/stagehand

antonvishal · 2026-08-20T20:05:46Z

Why

Humans and coding agents need browser workflows they can understand, reuse, and combine into new jobs.

These cookbooks are meant to be building blocks.

What

Add matching runnable projects under packages/cookbooks.
Keep the docs focused on the workflow and make each example easy for both humans and agents to understand and adapt.
Support TypeScript, Python, and Go for the core browser workflows.

Follow-ups

Simplify the clone/sparse-checkout setup into a one-command start
Add more cookbooks by combining existing patterns into new workflows

changeset-bot · 2026-08-20T20:05:54Z

⚠️ No Changeset found

Latest commit: 5d32c83

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

github-actions · 2026-08-20T20:05:59Z

This PR is from an external contributor and must be approved by a stagehand team member with write access before CI can run.
Approving the latest commit mirrors it into an internal PR owned by the approver.
If new commits are pushed later, the internal PR stays open but is marked stale until someone approves the latest external commit and refreshes it.

…ontent

… clarity and consistency

# Conflicts: # packages/docs/docs.json

charlypoly

Hi @antonvishal, thank you for this 🙌🏼

I think this is a core missing piece of our docs, so let's make it happen!

A couple of things I'd like to change:

The navigation is a bit overcomplicated as it stands, we should add hierarchy (categories) once we reach a critical number of cookbooks (>10-15)
Each cookbook should come as both a prompt and a folder in the repo to checkout, I'm not sure people spend time copy-pasting these days
We need to revisit some of them that are closer to snippets than cookbook (not covering a specific enough use cases): Multi-page Workflows, Extract a paginated catalog, Compare pages in parallel. Either we extend them or we revisit the menu to have 2 categories: Cookbook and Snippets/Patterns

antonvishal · 2026-09-24T11:48:49Z

Hi @antonvishal, thank you for this 🙌🏼

I think this is a core missing piece of our docs, so let's make it happen!

A couple of things I'd like to change:

The navigation is a bit overcomplicated as it stands, we should add hierarchy (categories) once we reach a critical number of cookbooks (>10-15)

Each cookbook should come as both a prompt and a folder in the repo to checkout, I'm not sure people spend time copy-pasting these days

We need to revisit some of them that are closer to snippets than cookbook (not covering a specific enough use cases): Multi-page Workflows, Extract a paginated catalog, Compare pages in parallel. Either we extend them or we revisit the menu to have 2 categories: Cookbook and Snippets/Patterns

Hey @charlypoly , I’ve kept the Examples navigation flat, added a prompt and runnable repo folder for each cookbook, and expanded the pages into a consistent guide format. I’ve attached a screenshot of the updated cookbook. How does the page look? Any other edits you’d like first?

socket-security · 2026-09-24T12:04:13Z

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	npm/@ai-sdk/openai@4.0.73
	npm/@types/node@24.13.6
	npm/@types/node@24.19.1
	npm/tsx@4.23.15
	golang/github.com/browserbase/stagehand/packages/sdk-go/v4@v4.1.0
	npm/@aws-sdk/lib-storage@3.1145.0
	npm/files-sdk@2.6.0
	npm/@browserbasehq/sdk@2.21.0
	npm/@aws-sdk/s3-presigned-post@3.1145.0
	npm/@aws-sdk/s3-request-presigner@3.1145.0
	npm/@aws-sdk/client-s3@3.1145.0
	pypi/stagehand@4.1.0
	npm/ai@7.0.112
	pypi/python-dotenv@1.2.4
	pypi/browserbase@1.20.0
	pypi/pydantic@2.13.5
	npm/@browserbasehq/stagehand@4.1.0

View full report

# Conflicts: # packages/docs/docs.json

# Conflicts: # packages/examples/README.md

…option

…RBASE_API_KEY and OPENAI_API_KEY in .env setup

…d updated environment variable details

Co-authored-by: Cursor <cursoragent@cursor.com> # Conflicts: # packages/docs/docs.json

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

TypeScript launch options take timeout in seconds, not Python's api_timeout alias. Create a context when BROWSERBASE_CONTEXT_ID is unset. Co-authored-by: Cursor <cursoragent@cursor.com>

…and examples

charlypoly

🚀

github-actions · 2026-10-06T09:10:12Z

This PR was approved by @charlypoly and mirrored to #3116. All further discussion should happen on that PR.

@charlypoly

Mirrored from external contributor PR #2789 after approval by @charlypoly. Original author: @antonvishal Original PR: #2789 Approved source head SHA: `5d32c83ec49a1d1dfb1ce40d42a74593196635bc` @antonvishal, please continue any follow-up discussion on this mirrored PR. When the external PR gets new commits, this same internal PR will be marked stale until the latest external commit is approved and refreshed here. ## Original description ## Why Humans and coding agents need browser workflows they can understand, reuse, and combine into new jobs. These cookbooks are meant to be building blocks. ## What - Add matching runnable projects under `packages/cookbooks`. - Keep the docs focused on the workflow and make each example easy for both humans and agents to understand and adapt. - Support TypeScript, Python, and Go for the core browser workflows. ## Follow-ups - [ ] Simplify the clone/sparse-checkout setup into a one-command start - [ ] Add more cookbooks by combining existing patterns into new workflows <img width="3008" height="1656" alt="BetterShot_2026-10-03-21-28-28" src="https://github.com/user-attachments/assets/5a9d7d59-4fdf-4fa6-a755-3378fbdab194" />   --- ## Summary by cubic Adds a Cookbooks tab to the docs with five runnable browser workflow examples (persisted login, paginated catalog export, files to bucket, form submission approval, and an AI SDK research agent), each with an agent prompt, setup instructions, and source code. Reorganizes the existing example projects under `packages/examples/showcase` so cookbooks get their own directory, and updates the `justfile`, `.gitignore`, and code ownership accordingly. The new `just cookbook` command runs any cookbook from the repo root. **Migration** - `just cookbook` runs cookbooks that previously lived under `packages/examples`; the old `just cookbook <slug>` path for showcase scripts is now `just showcase-script`. - `.env` files for showcase examples now live in `packages/examples/showcase/.env` instead of `packages/examples/.env`. - The `saas-pricing-monitor` example script was removed as part of the showcase reorg; its workflow still exists under the showcase directory. <sup>Written for commit 40562dc. Summary will update on new commits.</sup> <a href="https://cubic.dev/pr/browserbase/stagehand/pull/3116?utm_source=github" target="_blank" rel="noopener noreferrer" data-no-image-dialog="true"><picture><source media="(prefers-color-scheme: dark)" srcset="https://www.cubic.dev/buttons/review-in-cubic-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://www.cubic.dev/buttons/review-in-cubic-light.svg"><img alt="Review in cubic" src="https://www.cubic.dev/buttons/review-in-cubic-dark.svg"></picture></a>  --------- Co-authored-by: Vishal Anton <vishalanton@appexert.com> Co-authored-by: VIshal Anton <166398166+antonvishal@users.noreply.github.com> Co-authored-by: Charly Poly <charly@browserbase.com> Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com> Co-authored-by: Cursor <cursoragent@cursor.com> Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

github-actions · 2026-10-06T09:27:39Z

The mirrored PR #3116 has been merged into main. This original external contributor PR will stay closed as completed.

@charlypoly

browserbase#3116) Mirrored from external contributor PR browserbase#2789 after approval by @charlypoly. Original author: @antonvishal Original PR: browserbase#2789 Approved source head SHA: `5d32c83ec49a1d1dfb1ce40d42a74593196635bc` @antonvishal, please continue any follow-up discussion on this mirrored PR. When the external PR gets new commits, this same internal PR will be marked stale until the latest external commit is approved and refreshed here. ## Original description ## Why Humans and coding agents need browser workflows they can understand, reuse, and combine into new jobs. These cookbooks are meant to be building blocks. ## What - Add matching runnable projects under `packages/cookbooks`. - Keep the docs focused on the workflow and make each example easy for both humans and agents to understand and adapt. - Support TypeScript, Python, and Go for the core browser workflows. ## Follow-ups - [ ] Simplify the clone/sparse-checkout setup into a one-command start - [ ] Add more cookbooks by combining existing patterns into new workflows <img width="3008" height="1656" alt="BetterShot_2026-10-03-21-28-28" src="https://github.com/user-attachments/assets/5a9d7d59-4fdf-4fa6-a755-3378fbdab194" />   --- ## Summary by cubic Adds a Cookbooks tab to the docs with five runnable browser workflow examples (persisted login, paginated catalog export, files to bucket, form submission approval, and an AI SDK research agent), each with an agent prompt, setup instructions, and source code. Reorganizes the existing example projects under `packages/examples/showcase` so cookbooks get their own directory, and updates the `justfile`, `.gitignore`, and code ownership accordingly. The new `just cookbook` command runs any cookbook from the repo root. **Migration** - `just cookbook` runs cookbooks that previously lived under `packages/examples`; the old `just cookbook <slug>` path for showcase scripts is now `just showcase-script`. - `.env` files for showcase examples now live in `packages/examples/showcase/.env` instead of `packages/examples/.env`. - The `saas-pricing-monitor` example script was removed as part of the showcase reorg; its workflow still exists under the showcase directory. <sup>Written for commit 40562dc. Summary will update on new commits.</sup> <a href="https://cubic.dev/pr/browserbase/stagehand/pull/3116?utm_source=github" target="_blank" rel="noopener noreferrer" data-no-image-dialog="true"><picture><source media="(prefers-color-scheme: dark)" srcset="https://www.cubic.dev/buttons/review-in-cubic-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://www.cubic.dev/buttons/review-in-cubic-light.svg"><img alt="Review in cubic" src="https://www.cubic.dev/buttons/review-in-cubic-dark.svg"></picture></a>  --------- Co-authored-by: Vishal Anton <vishalanton@appexert.com> Co-authored-by: VIshal Anton <166398166+antonvishal@users.noreply.github.com> Co-authored-by: Charly Poly <charly@browserbase.com> Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com> Co-authored-by: Cursor <cursoragent@cursor.com> Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

github-actions Bot added external-contributor Tracks PRs mirrored from external contributor forks. external-contributor:awaiting-approval Waiting for a stagehand team member to approve the latest external commit. labels Aug 20, 2026

feat(docs): add Examples cookbook tab with standardized recipes

a4de127

antonvishal force-pushed the docs/examples branch from 6d33677 to a4de127 Compare August 21, 2026 18:53

antonvishal added 2 commits August 31, 2026 21:27

feat(docs): update examples section with new recipes and reorganize c…

c99ff89

…ontent

refactor(docs): update agent prompts and descriptions in examples for…

67599d2

… clarity and consistency

antonvishal marked this pull request as ready for review August 31, 2026 16:21

antonvishal requested a review from a team as a code owner August 31, 2026 16:21

antonvishal changed the title ~~docs: mockup Examples tab for Stagehand cookbooks~~ docs: Examples tab for Stagehand cookbooks Sep 8, 2026

antonvishal added 2 commits September 23, 2026 17:02

docs: remove unused examples coming soon component

0866e85

Merge remote-tracking branch 'upstream/main' into docs/examples

0986399

# Conflicts: # packages/docs/docs.json

charlypoly requested review from Kylejeong2, charlypoly and shrey150 September 23, 2026 13:00

charlypoly reviewed Sep 23, 2026

View reviewed changes

antonvishal and others added 2 commits September 23, 2026 19:07

chore(docs): format docs.json with oxfmt

a5b4207

Merge branch 'browserbase:main' into docs/examples

9f965e0

Update example documentation and configurations

0f06b1e

antonvishal requested a review from charlypoly September 24, 2026 14:10

antonvishal added 3 commits September 28, 2026 22:51

Merge remote-tracking branch 'upstream/main' into docs/examples

a7f4436

# Conflicts: # packages/docs/docs.json

Merge remote-tracking branch 'upstream/main' into vishal/conflicts-2789

0368054

# Conflicts: # packages/examples/README.md

docs: rename SDK examples to cookbooks

0a4e4b1

antonvishal changed the title ~~docs: Examples tab for Stagehand cookbooks~~ docs: Cookbooks tab for Stagehand workflows Oct 2, 2026

antonvishal marked this pull request as draft October 2, 2026 08:07

antonvishal added 2 commits October 3, 2026 18:55

chore: cookbooks

652c4a0

chore: remove cookbooks workflow

950007f

antonvishal added 3 commits October 3, 2026 21:04

docs: update paginated catalog instructions to include local browser …

fd89987

…option

docs: update README and cookbook documentation to include both BROWSE…

ff4d728

…RBASE_API_KEY and OPENAI_API_KEY in .env setup

docs: enhance README files for cookbooks with clearer instructions an…

437f8af

…d updated environment variable details

antonvishal marked this pull request as ready for review October 3, 2026 16:09

Merge remote-tracking branch 'upstream/main' into docs/examples

f9f64f8

Co-authored-by: Cursor <cursoragent@cursor.com> # Conflicts: # packages/docs/docs.json

charlypoly assigned pkiv and antonvishal and unassigned pkiv Oct 5, 2026

antonvishal and others added 2 commits October 5, 2026 20:03

Refactor examples and cookbooks structure

7858da2

docs: use active voice in cookbook pages

222a34b

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

charlypoly requested changes Oct 6, 2026

View reviewed changes

antonvishal and others added 2 commits October 6, 2026 14:11

fix(examples): use session timeout and auto-create Browserbase contexts

f93d271

TypeScript launch options take timeout in seconds, not Python's api_timeout alias. Create a context when BROWSERBASE_CONTEXT_ID is unset. Co-authored-by: Cursor <cursoragent@cursor.com>

fix: update model version from GPT-6 to GPT-5.6 in various cookbooks …

5d32c83

…and examples

antonvishal requested a review from charlypoly October 6, 2026 09:01

charlypoly approved these changes Oct 6, 2026

View reviewed changes

github-actions Bot mentioned this pull request Oct 6, 2026

[Claimed #2789] docs: Cookbooks tab for Stagehand workflows #3116

Merged

2 tasks

github-actions Bot added external-contributor:mirrored An internal mirrored PR currently exists for this external contributor PR. and removed external-contributor:awaiting-approval Waiting for a stagehand team member to approve the latest external commit. labels Oct 6, 2026

github-actions Bot closed this Oct 6, 2026

github-actions Bot added external-contributor:completed The mirrored PR has been merged and the external contributor flow is complete. and removed external-contributor:mirrored An internal mirrored PR currently exists for this external contributor PR. labels Oct 6, 2026

Navigation Menu

Repository navigation

docs: Cookbooks tab for Stagehand workflows - #2789

docs: Cookbooks tab for Stagehand workflows#2789
antonvishal wants to merge 21 commits into
browserbase:mainfrom
antonvishal:docs/examples

antonvishal commented Aug 20, 2026 •

edited

Loading

Uh oh!

changeset-bot Bot commented Aug 20, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Aug 20, 2026

Uh oh!

charlypoly left a comment

Uh oh!

antonvishal commented Sep 24, 2026 •

edited

Loading

Uh oh!

socket-security Bot commented Sep 24, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

charlypoly left a comment

Uh oh!

github-actions Bot commented Oct 6, 2026

Uh oh!

github-actions Bot commented Oct 6, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

antonvishal commented Aug 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Why

What

Follow-ups

Uh oh!

changeset-bot Bot commented Aug 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

github-actions Bot commented Aug 20, 2026

Uh oh!

charlypoly left a comment

Choose a reason for hiding this comment

Uh oh!

antonvishal commented Sep 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

socket-security Bot commented Sep 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

charlypoly left a comment

Choose a reason for hiding this comment

Uh oh!

github-actions Bot commented Oct 6, 2026

Uh oh!

github-actions Bot commented Oct 6, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

antonvishal commented Aug 20, 2026 •

edited

Loading

changeset-bot Bot commented Aug 20, 2026 •

edited

Loading

antonvishal commented Sep 24, 2026 •

edited

Loading

socket-security Bot commented Sep 24, 2026 •

edited

Loading