@browserbasehq/browse-cli 0.1.4 → 0.2.0-alpha-a9424ff2eb7bbde3cca93ae8d3a0fbe240335504

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Browserbase, Inc.
+Copyright (c) 2024 Browserbase Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -155,8 +155,37 @@ Captured requests are saved as directories:
 browse start          # Explicitly start daemon
 browse stop [--force] # Stop daemon
 browse status         # Check daemon status
+browse env [target]   # Show or switch environment: local | remote
 ```
 
+### Environment Switching (Local vs Remote)
+
+Use environment switching when an agent should keep the same command flow, but the
+browser runtime needs to change:
+
+- `local` runs Chrome on your machine (best for local debugging/dev loops)
+- `remote` runs a Browserbase session (best for anti-bot hardening and cloud runs)
+
+```bash
+# Show active environment (if running) and desired environment for next start
+browse env
+
+# Switch current session to Browserbase (restarts daemon if needed)
+browse env remote
+
+# Switch back to local Chrome
+browse env local
+```
+
+Behavior details:
+
+- Environment is scoped per `--session`
+- `browse env <target>` persists an override and restarts the daemon
+- `browse stop` clears the override so next start falls back to env-var-based auto detection
+- Auto detection defaults to:
+  - `remote` when `BROWSERBASE_API_KEY` and `BROWSERBASE_PROJECT_ID` are set
+  - `local` otherwise
+
 ## Global Options
 
 | Option | Description |
@@ -172,6 +201,8 @@ browse status         # Check daemon status
 | Variable | Description |
 |----------|-------------|
 | `BROWSE_SESSION` | Default session name (alternative to `--session`) |
+| `BROWSERBASE_API_KEY` | Browserbase API key (required for `browse env remote`) |
+| `BROWSERBASE_PROJECT_ID` | Browserbase project ID (required for `browse env remote`) |
 
 ## Element References
 
@@ -286,18 +317,18 @@ Windows support requires WSL or TCP socket implementation.
 ```bash
 # Clone and setup (in monorepo)
 cd packages/cli
-npm install          # Install dependencies first!
-npm run build        # Build the CLI
+pnpm install         # Install dependencies first!
+pnpm run build       # Build the CLI
 
 # Run without building (for development)
-npm run dev -- <command>
+pnpm run dev -- <command>
 
 # Or with tsx directly
 npx tsx src/index.ts <command>
 
 # Run linting and formatting
-npm run lint
-npm run format
+pnpm run lint
+pnpm run format
 ```
 
 ## License