Browser Tools

Enable browser control with the --browser flag:

lukan --browser

Browser Options

Flag	Description
`--browser-visible`	Launch Chrome with visible window
`--browser-user-profile`	Use default Chrome profile
`--browser-cdp <url>`	Connect to existing Chrome via CDP
`--browser-allow-internal`	Allow navigation to internal/private URLs

Available Tools

Tool	Description
`BrowserNavigate`	Navigate to a URL
`BrowserNewTab`	Open a new tab
`BrowserSnapshot`	Take an accessibility tree snapshot (compact mode available)
`BrowserScreenshot`	Take a JPEG screenshot of the current page
`BrowserClick`	Click an element by reference number
`BrowserType`	Type text into an input field
`BrowserEvaluate`	Evaluate JavaScript (with security blocklist)
`BrowserSavePDF`	Save the current page as a PDF file
`BrowserTabs`	List open tabs
`BrowserSwitchTab`	Switch between tabs

Usage Examples

// Navigate to a page
BrowserNavigate({ url: "https://example.com" })

// Take a screenshot
BrowserScreenshot({})

// Click an element (use selector from snapshot)
BrowserClick({ selector: "#submit-button" })

// Type in an input
BrowserType({ selector: "#search-input", text: "search query" })

// Evaluate JavaScript
BrowserEvaluate({ script: "return document.title" })

// Switch tabs
BrowserSwitchTab({ tabIndex: 1 })

// Save page as PDF
BrowserSavePDF({ path: "output.pdf" })

Connecting to Existing Chrome

Instead of launching a new Chrome instance, connect to one already running:

# Start Chrome with remote debugging
google-chrome --remote-debugging-port=9222

# Connect Lukan to it
lukan --browser --browser-cdp http://localhost:9222

This is useful when you need to continue a session that was already authenticated.

CLI

Configuration

Extensions

Advanced

Browser Options

Available Tools

Usage Examples

Connecting to Existing Chrome

​Browser Options

​Available Tools

​Usage Examples

​Connecting to Existing Chrome

Browser Options

Available Tools

Usage Examples

Connecting to Existing Chrome