[STG-1741] feat(cli): add global flags for Browserbase session parameters
Merged
SH
8mo ago+129+129+012345678901234567890123456789-10-10-01234567890123456789
Summary
- Add global CLI flags for commonly used Browserbase session parameters to the
browseCLI - 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
| Flag | Description |
|---|---|
--proxies | Enable Browserbase proxy |
--advanced-stealth | Enable advanced stealth mode |
--solve-captchas / --no-solve-captchas | Toggle CAPTCHA solving |
--region <region> | Session region |
--keep-alive | Keep session alive after disconnection |
--session-timeout <seconds> | Session timeout |
--block-ads | Enable 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.
Test plan
-
browse --helpshows 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.comconfigures both settings -
browse --proxies open https://example.com(in local mode) errors with helpful message - Changing flags restarts the daemon automatically
-
browse statusshows 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
- Flags: