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

Merged
GI
2mo ago
+9897-195

Mirrored from external contributor PR #2789 after approval by @charlypoly.

Original author: @antonvishal
Original PR: https://github.com/browserbase/stagehand/pull/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
BetterShot_2026-10-03-21-28-28

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.