Browserless CLI
The Browserless CLI (@browserless.io/cli) captures cookies, localStorage, and IndexedDB from a local Chromium-based browser and uploads them as reusable cloud profiles. It also provides an interactive agent chat and configuration management.
All extraction happens locally. Only the filtered result is sent to Browserless.
With the CLI, you can:
- Capture auth state from a browser you already use (Chrome, Edge, Brave, etc.) without writing code.
- Manage cloud profiles: list, rename, delete, and refresh them from the terminal.
- Filter sensitive domains locally before upload.
- Chat with the hosted Browserless agent in an interactive REPL.
- A Browserless API token from your account dashboard
- Node.js >= 24
- A Chromium-based browser installed locally (Chrome, Edge, Brave, or Chromium)
Use the CLI when you want to capture auth state from a browser you already use without writing code. Use the CDP method when you need programmatic control over the login flow.
Installation
npm install -g @browserless.io/cli
Requires Node.js >= 24.
After installing, run browserless with no arguments to see the full command tree.
Quickstart
Capture your Chrome login state and upload it as a cloud profile in one command:
browserless auth login YOUR_API_TOKEN
browserless profile upload --browser chrome --profile Default --name my-session
That's it. Pass ?profile=my-session on any Browserless connection URL to reuse that auth state.
Further reading
- Authentication — store and manage your API token
- Capture pipeline — how the local extraction works
- Profile commands — upload, refresh, inspect, list, show, rename, delete
- Browser sources — discover local browsers and register custom ones
- Domain filtering — exclude sensitive domains before upload
- Agent — interactive chat with the hosted Browserless agent
- Configuration — settings, global flags, environment variables, exit codes