Repository navigation
[Claimed #2789] docs: Cookbooks tab for Stagehand workflows - #3116
Merged
Merged
Conversation
… clarity and consistency
# Conflicts: # packages/docs/docs.json
# Conflicts: # packages/docs/docs.json
# Conflicts: # packages/examples/README.md
…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>
…89' into external-contributor-pr-2789
github-actions
Bot
added
external-contributor
Contributor
Author
|
This mirrored PR has been merged into |
2 tasks
|
|
Review the following changes in direct dependencies. Learn more about Socket for GitHub. |
charlypoly
approved these changes
Oct 6, 2026
github-actions
Bot
added
external-contributor:completed
antonvishal
added a commit
to antonvishal/stagehand
that referenced
this pull request
Oct 7, 2026
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" /> <!-- external-contributor-pr:owned source-pr=2789 source-sha=5d32c83ec49a1d1dfb1ce40d42a74593196635bc claimer=charlypoly --> <!-- This is an auto-generated description by cubic. --> --- ## 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> <!-- End of auto-generated description by cubic. --> --------- 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>
![https://www.cubic.dev/buttons/review-in-cubic-dark.svg"><source](https://www.cubic.dev/buttons/review-in-cubic-dark.svg"><source){kind=link}
![https://www.cubic.dev/buttons/review-in-cubic-light.svg"><img](https://www.cubic.dev/buttons/review-in-cubic-light.svg"><img){kind=link}
![https://www.cubic.dev/buttons/review-in-cubic-dark.svg"></picture></a](https://www.cubic.dev/buttons/review-in-cubic-dark.svg"></picture></a){kind=link}
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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
packages/cookbooks.Follow-ups
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/showcaseso cookbooks get their own directory, and updates thejustfile,.gitignore, and code ownership accordingly. The newjust cookbookcommand runs any cookbook from the repo root.Migration
just cookbookruns cookbooks that previously lived underpackages/examples; the oldjust cookbook <slug>path for showcase scripts is nowjust showcase-script..envfiles for showcase examples now live inpackages/examples/showcase/.envinstead ofpackages/examples/.env.saas-pricing-monitorexample script was removed as part of the showcase reorg; its workflow still exists under the showcase directory.Written for commit 40562dc. Summary will update on new commits.