unchainedsky-cli

Browser automation CLI over local Chrome CDP — DDM-first methodology for LLM agents.

Install

# With uv (recommended)
uv tool install unchainedsky-cli[agent]

# Or pip
pip install unchainedsky-cli[agent]

# Or brew
brew install --HEAD unchainedsky/tap/unchainedsky-cli

The [agent] extra includes the Anthropic SDK for the interactive Claude agent. Omit it if you only need the CLI tools.

Quick Start

# Launch Chrome and browse
unchained launch https://news.ycombinator.com

# Navigate returns page layout + intel probe automatically
unchained navigate https://example.com

# Search page text
unchained ddm --text --find "price"

# Element details at coordinates
unchained ddm --at 694,584

# Start the interactive Claude agent
export ANTHROPIC_API_KEY=sk-ant-...
unchained agent "find the cheapest flight to NYC"

Launch Options

# Sandboxed profile (default — clean, isolated)
unchained launch

# Existing Chrome profile (with cookies, logins, extensions)
unchained --port 9333 launch --use-profile --profile "Profile 3" https://x.com

# Headless with stealth (auto-enables fingerprint evasion)
unchained launch --headless https://example.com

# Stealth mode (visible window, bot detection evasion)
unchained launch --stealth https://example.com

# Multiple profiles on different ports
unchained --port 9222 launch --profile work
unchained --port 9333 launch --use-profile --profile "Profile 3"
unchained --port 9444 launch --use-profile --profile "Profile 8"

Commands

Browser Lifecycle

Navigation & Interaction

Page Intelligence

Data & Tabs

Agent

DDM-First Methodology

Every browsing task follows this pipeline:

1. ORIENT — navigate and click return DDM layout inline. Read it. Don't call ddm separately.
2. IDENTIFY — ddm --at x,y on elements you need details about.
3. CLASSIFY — Check the Intel probe in navigate output. If js_global > 50%, use intel --stores. If host_attrs > 50%, use intel --extract.
4. ACT — Click coordinates from DDM, type text, or run JS.
5. VERIFY — Check the layout changed after actions.
6. EXTRACT — Use ddm --text, intel --extract, or js based on page type.

Token Comparison

Global Options

--port PORT    Chrome remote debugging port (default: 9222, env: UNCHAINED_PORT)
--tab TAB_ID   Target tab ID, alias, or 'auto' (default: auto)
--json         Output raw JSON

Environment Variables

Build Binaries

DDM and Intel can be compiled to native binaries (protects proprietary algorithms):

pip install nuitka ordered-set
python build_binaries.py --install

Binaries are installed to ~/.unchained/bin/. The CLI automatically uses them when available, falling back to the Python engine otherwise.

Requirements

• Python 3.10+
• Google Chrome, Chromium, or Microsoft Edge