Skip to content

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

Open
shrey150 wants to merge 3 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 3 commits intomainfrom
shrey/cli-first-docs

Conversation

@shrey150
Copy link
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 mainly reorder/add CLI snippets; risk is limited to potential mismatch between documented CLI flags and the actual bb interface.

Overview
Updates Browserbase skill docs to prefer the bb CLI over direct HTTP calls by adding CLI-first examples and references for fetch, search, and functions invoke.

Adds a new “CLI is the preferred interface” section in skills/browserbase-cli/SKILL.md that maps common API operations (search/fetch/functions/resources) to their bb equivalents, and refreshes tips/best-practices text to include the relevant CLI flags (e.g., --output, --allow-redirects, --proxies, --num-results).

Written by Cursor Bugbot for commit 630ac23. 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
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>
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