CLOUD BROWSER CLI

Cloud Browser control from your terminal.

Create persistent Chrome browsers, pause and resume profiles, and issue CDP or Live View links for the tools your agents already use.

Download releases Read the CLI docs

macOS · Linux · Windows · amd64 and arm64

TERMINAL

# Download a release
open https://github.com/langyishipit/cloudbrowser/releases

# Authenticate once
cloudbrowser auth login

# Create a persistent Chrome browser
cloudbrowser create --name research

# Create a CDP link
cloudbrowser links create br_123 --audience cdp --output url

ISOLATE

One browser per Agent

Give parallel Codex, Claude Code or Cursor sessions separate Chrome profiles, cookies and login state.

CONNECT

Use the clients you know

Create a CDP link once, then connect Playwright, Playwright CLI, agent-browser, Puppeteer or another Chrome client.

RESUME

Pick up the profile later

Pause a browser when work is done, resume it when the next task begins, and keep the same browser identity.

01 · CREATE

Start a persistent browser

Ask the CLI to create an isolated Chrome profile and wait until it is ready.

COMMAND

cloudbrowser create --name research --wait

Browser created
ID: br_123
Status: running
Name: research

02 · CONNECT

Create a CDP link

Return one URL for the Agent client that should use this browser.

COMMAND

cloudbrowser links create br_123 --audience cdp --output url

wss://cloudbrowser.tv/connect/br_123?token=••••••

03 · PAUSE

Stop runtime when idle

Pause the browser and preserve its profile for the next session.

COMMAND

cloudbrowser pause br_123

br_123 paused
Profile preserved.

04 · MANAGE

Control access

List saved links, reveal a URL again as owner, or revoke access.

COMMAND

cloudbrowser links list br_123

ID          AUDIENCE   PERMISSION  STATUS
grant_123   cdp        control     active

AGENT SETUP PROMPT

Give this to your Agent

It explains how to install the CLI, sign in and create a browser without exposing a connection secret.

You can use CloudBrowser.TV, a persistent isolated Chrome browser for agents.

Install the CLI from https://cloudbrowser.tv/downloads.
Authenticate with:
cloudbrowser auth login

Then create a browser for this task:
cloudbrowser create --name <task-name> --wait --output json

Create a CDP link:
cloudbrowser links create <browser-id> --audience cdp --output url

Use the returned CDP URL with Playwright, Playwright CLI, agent-browser, Puppeteer, or another Chrome CDP client. The user can watch and operate the same browser from the CloudBrowser.TV console.

MACOS

macOS archive

Choose the arm64 or amd64 archive from the public GitHub release.

Choose a macOS release

LINUX

Direct download

Download the archive for your CPU, verify its checksum, and place the binary on your PATH.

Choose a Linux release

WINDOWS

PowerShell or Scoop

Use the Windows archive or install through Scoop when the bucket is available.

Choose a Windows release

BUILT FOR AGENTS

One command creates the handoff.

The CLI creates the link and exits. Playwright, agent-browser, Puppeteer or another CDP client connects directly to Chrome, so every Agent session can use its own isolated browser.

cloudbrowser links list br_123

cloudbrowser links reveal br_123 grant_123 --output url

cloudbrowser links revoke br_123 grant_123 --yes