@cli4ai/chrome
v1.1.4
Published
Chrome browser automation with managed browser instance
Downloads
1,372
Maintainers
Readme
@cli4ai/chrome
Official @cli4ai package • https://cli4ai.com • Install cli4ai:
npm i -g cli4ai
Chrome browser automation via Puppeteer. Launches a managed browser instance with persistent profile - no need to quit your existing browser or enable remote debugging.
Setup
npm i -g cli4ai
cli4ai add -g chromeUsage
# Navigate to a URL (auto-launches browser if not running)
cli4ai run chrome navigate https://example.com
# Run in headless mode (no visible window)
cli4ai run chrome --headless navigate https://example.com
# Screenshot
cli4ai run chrome screenshot output.png --full-page
# Get page text
cli4ai run chrome textCommands
Browser Management
cli4ai run chrome launch # Explicitly launch browser
cli4ai run chrome --headless launch # Launch in headless mode
cli4ai run chrome close # Close managed browser
cli4ai run chrome status # Check if browser is running
cli4ai run chrome tabs # List open tabsNavigation
cli4ai run chrome navigate <url> # Open URL
cli4ai run chrome navigate <url> --new-tab # Open in new tab
cli4ai run chrome navigate <url> --wait load # Wait for: load, domcontentloaded, networkidle0, networkidle2Interaction
cli4ai run chrome click <selector> # Click element
cli4ai run chrome type <selector> "text" # Type into input
cli4ai run chrome type <selector> "text" --clear # Clear first, then type
cli4ai run chrome wait <selector> # Wait for element
cli4ai run chrome wait <selector> --timeout 5000 # With timeout (ms)Content Extraction
cli4ai run chrome html # Get full page HTML
cli4ai run chrome html <selector> # Get element HTML
cli4ai run chrome text # Get page text content
cli4ai run chrome text <selector> # Get element text
cli4ai run chrome cookies # Get all cookies
cli4ai run chrome cookies example.com # Filter by domain
cli4ai run chrome eval "document.title" # Run JavaScriptScreenshots & PDF
cli4ai run chrome screenshot # Save screenshot.png
cli4ai run chrome screenshot output.png # Custom filename
cli4ai run chrome screenshot --full-page # Full page capture
cli4ai run chrome screenshot --selector "#hero" # Element screenshot
cli4ai run chrome pdf # Save page.pdf (headless)
cli4ai run chrome pdf output.pdf # Custom filenameHeadless Mode
Add --headless before any command to run without a visible browser window:
cli4ai run chrome --headless navigate https://example.com
cli4ai run chrome --headless screenshot
cli4ai run chrome --headless textHeadless mode is useful for:
- Automated scraping
- CI/CD pipelines
- Background tasks
Profile Persistence
Browser data (cookies, localStorage, logins) persists in ~/.cli4ai/chrome/profile/. This means:
- You stay logged into websites between sessions
- Browser extensions are preserved
- History and settings persist
Related
Other browser-dependent tools like @cli4ai/twitter and @cli4ai/linkedin can use the managed browser.
