Execute JavaScript in page

| Variable | Description | Default |
|----------|-------------|---------|
| DEBUG_PORT | CDP debugging port | 9222 |
| BROWSER | Browser to use (chrome, brave, edge) | chrome |
| BROWSER_PATH | Custom browser executable path | (auto-detect) |

Examples

`bash


Start Brave with real profile

The cookies command provides session persistence for authenticated workflows:

$3

Save your browser cookies to a JSON file for later use:

`bash
browser-cdp cookies export # Saves to cookies.json
browser-cdp cookies export --path auth.json # Save to specific file
`

Output format:
`json
[
{
"name": "session_id",
"value": "abc123...",
"domain": "example.com",
"path": "/",
"httpOnly": true,
"secure": true,
"sameSite": "Strict",
"expires": 1735689600
}
]
`

$3

Load previously exported cookies into the browser:

`bash
browser-cdp cookies import auth.json
`

Useful for:
- Resuming authenticated sessions across browser restarts
- Sharing sessions across team members
- Preserving login state for automation workflows

$3

Delete all cookies from the browser:

`bash
browser-cdp cookies clear
`

Storage Command

The storage command provides localStorage and sessionStorage management:

$3

`bash
browser-cdp storage get authToken # Get from localStorage
browser-cdp storage set theme dark # Set in localStorage
browser-cdp storage set tempData "session" --session # Set in sessionStorage
`

$3

`bash
browser-cdp storage list # List localStorage keys
browser-cdp storage list --session # List sessionStorage keys
`

$3

Save storage to a JSON file for backup or restore:

`bash
browser-cdp storage export # Saves to storage.json
browser-cdp storage export --path app-state.json # Save to specific file
browser-cdp storage import app-state.json # Restore from file
`

Output format:
`json
{
"authToken": "eyJhbGciOiJIUzI1NiIs...",
"theme": "dark"
}
`

$3

`bash
browser-cdp storage clear # Clear localStorage
browser-cdp storage clear --session # Clear sessionStorage
`

$3

| Storage Type | Lifetime | Scope | Flag |
|--------------|----------|-------|------|
| localStorage | Permanent | Per origin | (default) |
| sessionStorage | Tab session | Per tab | --session |

Pre-started Browser

If you already have a browser running with CDP enabled, the CLI will connect to it:

`bash


Add to ~/.zshrc

| Browser | Command |
|---------|---------|
| Chrome | chrome (default) |
| Brave | brave |
| Edge | edge |

Platform Support

Works on macOS and Linux. Browser paths auto-detected per platform.

| Platform | Chrome Path | Config Path |
|----------|-------------|-------------|
| macOS | /Applications/Google Chrome.app/... | ~/Library/Application Support/Google/Chrome/ |
| Linux | /usr/bin/google-chrome | ~/.config/google-chrome/ |

Use BROWSER_PATH env var to override if your browser is installed elsewhere.

Why Real Browser?

| Aspect | browser-cdp | Playwright Test Mode |
|--------|-------------|---------------------|
| Browser | Your installed Chrome/Brave/etc | Bundled Chromium |
| Profile | Real cookies/logins by default | Fresh test profile |
| Detection | Not detectable as automation | Automation flags present |
| Use case | Real-world testing, scraping | Isolated E2E tests |

Development

`bash


Install dependencies

See Also

- dev-browser - Browser automation plugin for Claude Code with LLM-optimized DOM snapshots

License

MIT