Skip to content

[STG-1680] docs: show bb CLI usage alongside curl in search, fetch, functions skills#55

Open
shrey150 wants to merge 4 commits intomainfrom
shrey/cli-first-docs
Open

[STG-1680] docs: show bb CLI usage alongside curl in search, fetch, functions skills#55
shrey150 wants to merge 4 commits intomainfrom
shrey/cli-first-docs

Conversation

@shrey150
Copy link
Copy Markdown
Contributor

@shrey150 shrey150 commented Mar 25, 2026

Summary

  • Adds bb CLI examples to search, fetch, and functions skills so agents try the CLI first
  • CLI examples appear before cURL in SKILL.md, REFERENCE.md, and EXAMPLES.md
  • Adds "The CLI is the preferred interface" section to browserbase-cli SKILL.md with a mapping (bb search vs curl, bb fetch vs curl, etc.)
  • Removes redundant bullet from browserbase-cli that sent agents away to the fetch skill

Test plan

  • Verify bb search, bb fetch, bb functions invoke commands shown match current CLI flags
  • Confirm no existing cURL or SDK examples were removed — only CLI alternatives added alongside them

🤖 Generated with Claude Code


Note

Low Risk
Low risk documentation-only updates that reframe examples around the bb CLI; the main risk is minor confusion if any referenced flags drift from the current CLI.

Overview
Updates the Browserbase fetch, search, and functions skill docs to prefer the bb CLI over raw API curl/SDK examples, rewriting examples and references around bb fetch, bb search, and bb functions invoke (including --output, --num-results, --allow-redirects, --proxies, and --check-status).

Adds an explicit “CLI is the preferred interface” section to browserbase-cli/SKILL.md mapping common API endpoints to their bb equivalents, and trims/adjusts related guidance and security notes (e.g., --allow-insecure-ssl).

Written by Cursor Bugbot for commit cc1a919. This will update automatically on new commits. Configure here.

@shrey150 shrey150 changed the title docs: show bb CLI usage alongside curl in search, fetch, functions skills [STG-1680] docs: show bb CLI usage alongside curl in search, fetch, functions skills Mar 25, 2026
shrey150 and others added 2 commits March 25, 2026 21:27
Update SKILL.md and REFERENCE.md to reflect new browse env local
behavior: auto-discovers existing Chrome with remote debugging,
--isolated flag, and explicit CDP target (port or URL).

Sister PR to browserbase/stagehand#1886.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
… functions skills

Each skill now leads with `bb` CLI examples so agents try the CLI first. cURL
and SDK examples are kept for reference but the CLI is presented as the
quickest path.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@shrey150 shrey150 force-pushed the shrey/cli-first-docs branch from de29bef to 26f9acb Compare March 26, 2026 04:27
shrey150 and others added 2 commits March 26, 2026 15:54
The --isolated flag, port/CDP URL arguments to `browse env local`,
auto-discovery of running Chrome, and localStrategy/localSource status
fields do not exist in the released browse-cli (0.2.0) or on main.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Removes all direct API (cURL) and SDK (Node.js/Python) code blocks from
fetch, search, and functions skills. Each skill now shows only `bb` CLI
usage, keeping the docs focused on the preferred interface.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant