Browser CLI - PraisonAI Documentation

Control browser automation for AI agents directly from the CLI. Launch Chrome, navigate pages, take screenshots, run browser agents, and more.

Commands

praisonai browser <command> [OPTIONS]

Command	Description
`start`	Start the browser automation server
`launch`	Launch Chrome with extension and optionally run a goal
`run`	Run browser agent with a goal
`navigate`	Navigate a browser tab to a URL
`screenshot`	Capture a screenshot of a browser tab
`pages`	List all browser pages/tabs
`tabs`	List and manage browser tabs
`dom`	Get DOM tree from a browser page
`content`	Read page content as text
`console`	Get console logs from a page
`js`	Execute JavaScript in a page
`execute`	Execute JavaScript in a browser tab
`sessions`	List browser automation sessions
`history`	Show step-by-step history for a session
`clear`	Clear session history
`doctor`	Browser health diagnostics
`chrome`	Chrome browser management
`extension`	Chrome extension management
`benchmark`	Browser automation benchmarks

Doctor

Check browser health and configuration:

praisonai browser doctor

Launch

Launch Chrome with the PraisonAI extension:

praisonai browser launch

With a goal to execute:

praisonai browser launch --goal "Search for AI news"

Run

Run a browser agent with a specific goal:

praisonai browser run "Search for the latest AI news and summarize"

Navigate

Navigate a browser tab to a URL:

praisonai browser navigate https://example.com

Screenshot

Capture a screenshot of the current page:

praisonai browser screenshot

With options:

praisonai browser screenshot --output screenshot.png

Pages

List all open browser pages/tabs:

praisonai browser pages

DOM

Get the DOM tree from a browser page:

praisonai browser dom

Content

Read page content as text:

praisonai browser content

JS / Execute

Execute JavaScript in a browser page:

praisonai browser js "document.title"

praisonai browser execute "document.querySelector('h1').innerText"

Sessions

List browser automation sessions:

praisonai browser sessions

History

Show step-by-step history for a session:

praisonai browser history <session_id>

Examples

Web Scraping Workflow

# Launch browser
praisonai browser launch

# Navigate to page
praisonai browser navigate https://news.ycombinator.com

# Get page content
praisonai browser content

# Take screenshot for verification
praisonai browser screenshot --output hn.png

Using Browser Agent

# Run agent with a goal
praisonai browser run "Go to Hacker News and find the top 3 stories about AI"

Browser Health Check

# Check if browser is properly configured
praisonai browser doctor

Chrome Management

Start Server

praisonai browser start

Chrome Subcommands

praisonai browser chrome <subcommand>

Extension Subcommands

praisonai browser extension <subcommand>

Environment Variables

Variable	Description
`BROWSER_HEADLESS`	Run headless by default (`true`/`false`)
`BROWSER_TIMEOUT`	Default timeout in seconds

Bot CLI

Deploy messaging bots

Sandbox CLI

Sandbox container management

CLI

​Commands

​Doctor

​Launch

​Run

​Navigate

​Screenshot

​Pages

​DOM

​Content

​JS / Execute

​Sessions

​History

​Examples

​Web Scraping Workflow

​Using Browser Agent

​Browser Health Check

​Chrome Management

​Start Server

​Chrome Subcommands

​Extension Subcommands

​Environment Variables

​Related