Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.praison.ai/llms.txt

Use this file to discover all available pages before exploring further.

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]
CommandDescription
startStart the browser automation server
launchLaunch Chrome with extension and optionally run a goal
runRun browser agent with a goal
navigateNavigate a browser tab to a URL
screenshotCapture a screenshot of a browser tab
pagesList all browser pages/tabs
tabsList and manage browser tabs
domGet DOM tree from a browser page
contentRead page content as text
consoleGet console logs from a page
jsExecute JavaScript in a page
executeExecute JavaScript in a browser tab
sessionsList browser automation sessions
historyShow step-by-step history for a session
clearClear session history
doctorBrowser health diagnostics
chromeChrome browser management
extensionChrome extension management
benchmarkBrowser 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 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

VariableDescription
BROWSER_HEADLESSRun headless by default (true/false)
BROWSER_TIMEOUTDefault timeout in seconds

Bot CLI

Deploy messaging bots

Sandbox CLI

Sandbox container management