[STG-1741] feat(cli): add global flags for Browserbase session parameters

Merged
SH
8mo ago
+129-10

Summary

  • Add global CLI flags for commonly used Browserbase session parameters to the browse CLI
  • Users no longer need external tools or workarounds to configure advancedStealth, proxies, solveCaptchas, etc.
  • Flags are remote-mode only and trigger daemon restart when changed

New flags

FlagDescription
--proxiesEnable Browserbase proxy
--advanced-stealthEnable advanced stealth mode
--solve-captchas / --no-solve-captchasToggle CAPTCHA solving
--region <region>Session region
--keep-aliveKeep session alive after disconnection
--session-timeout <seconds>Session timeout
--block-adsEnable ad blocking

Examples

browse --proxies --advanced-stealth open https://example.com
browse --region us-east-1 --solve-captchas open https://example.com

Session flags are validated to only work in remote mode and will error with a helpful message if used in local mode.

Linear: https://linear.app/browserbase/issue/STG-1741/featcli-add-global-flags-for-browserbase-session-parameters

Test plan

  • browse --help shows new flags with "(remote only)" descriptions
  • browse --proxies open https://example.com (in remote mode) creates session with proxy enabled
  • browse --advanced-stealth --solve-captchas open https://example.com configures both settings
  • browse --proxies open https://example.com (in local mode) errors with helpful message
  • Changing flags restarts the daemon automatically
  • browse status shows active session params
  • Build succeeds

🤖 Generated with Claude Code


Summary by cubic

Add global flags to browse to configure Browserbase session settings in remote mode (proxies, stealth, CAPTCHA solving, region, keep-alive, timeouts) without JSON. Settings persist per session, trigger a daemon restart when changed, and appear as sessionParams in browse status JSON; also fixes lint errors. Addresses Linear STG-1741.

  • New Features
    • Flags: --proxies, --advanced-stealth, --solve-captchas/--no-solve-captchas, --block-ads, --region <region>, --keep-alive, --session-timeout <seconds>; remote-only with a clear error in local mode