Turn Browser Actions into CLI Commands

Powered by LLM and Chrome CDP, cliany-site automatically explores web workflows and generates reusable CLI commands. Control any website like calling a script.

Get Started View on GitHub →
✓ Connecting to Chrome CDP...
✓ Analyzing page structure...
✓ LLM planning workflow...
✓ CLI commands generated to ~/.cliany-site/adapters/github.com/

{"success": true, "data": {"results": [...]}}

Core Features

4 core capabilities + 12 extended capabilities

Start with the core four, then enable advanced capabilities on demand.

01 CORE

Zero-Intrusion Exploration

Injection-free AXTree exploration to quickly locate automatable paths.

02 CORE

LLM-Driven Code Generation

Turn page semantics directly into executable CLI commands.

03 CORE

Standard JSON Output

Unified {success,data,error} output for easy automation integration.

04 CORE

Persistent Sessions

Reuse one login across commands to eliminate repetitive operations.

🩹

Smart Self-Healing

AXTree snapshot diffing, hot-patch selectors without re-exploring.

✅

Static Verification

Verify adapter schema, signature, and dependency integrity without launching a browser.

📜

Self-Describing Contract

--explain outputs a machine-readable Agent contract for automation integration.

⚛️

Atom Commands System

Generated commands reuse atomic operations instead of inlined CDP, shared across adapters.

🔒

Metadata Schema v2

Enforces v2 metadata; legacy adapters auto-rejected with re-explore hint.

Extended Capabilities (12)

Hide complexity by default, unlock it when needed.

  • Dynamic Adapter Loading
  • Chrome Auto-Management
  • Incremental Adapter Merge
  • Atomic Command System
  • Smart Recording Validation
  • TUI Management Interface
  • Headless & Remote Browser
  • YAML Workflow Orchestration
  • Data-Driven Batch Execution
  • Python SDK & HTTP API
  • Security Hardening
  • Adapter Marketplace

Real-World Use Cases

Explore once, own your CLI forever

🔥

GitHub as Your CLI

Tired of repetitive clicks on GitHub? Search repos and view READMEs directly from your terminal.

Browser → Search → Click repo → View README

5 steps · ~30s

Single command, structured JSON, pipe-friendly

1 command · Instant
✓ Adapter generated at ~/.cliany-site/adapters/github.com/
{"success": true, "data": {"results": [...]}}
CONCEPT
💡

No API? Build Your Own

Stuck with a legacy CRM with no API? Generate a dedicated CLI for any web portal in minutes.

Login → CRM → Search → Details → Orders → Filter

7 steps · ~2m

Extract structured data with pipes

1 command · Instant
$ cliany-site crm.company.com search-customer --name "John Doe" --json | jq '.orders[:5]'
{"success": true, "data": {"name": "John Doe", "orders": [...]}}
CONCEPT
🚀

Team Toolbox

Stop wasting time on internal portal onboarding. Explore once, share adapters, and level up the whole team.

10+ docs + constant "where is this?" questions

Fragmented knowledge · High friction

Install shared adapters for instant access

Unified CLI · Zero learning curve
$ cliany-site market install ./team-toolkit.cliany-adapter.tar.gz
✓ Installed: jira.company.com, confluence.company.com, jenkins.company.com

$ cliany-site jira.company.com create-ticket --title "fix login bug" --json
{"success": true, "data": {"id": "PROJ-1234"}}

How It Works

Three steps from web pages to CLI commands

1

Explore

Specify a target URL and task description — the LLM automatically analyzes page structure and plans the action path.

cliany-site explore "https://github.com" "search repos"
2

Generate

Transform exploration results into Python/Click CLI tools, automatically saved to the local adapter directory.

~/.cliany-site/adapters/github.com/commands.py
3

Run

Replay workflows with generated CLI commands. Fuzzy matching ensures stable execution even after minor page changes.

cliany-site github.com search --query "browser-use" --json

CLI Reference

$ cliany-site doctor --json
{"success": true, "data": {"cdp": true, "llm": true}}

$ cliany-site login "https://github.com" --json
✓ Waiting for browser login...
✓ Session saved to ~/.cliany-site/sessions/

$ cliany-site explore "https://github.com" "Search repos and view README" --json
✓ Exploration complete, adapter generated

$ cliany-site list --json
{"success": true, "data": {"adapters": ["github.com"]}}

$ cliany-site github.com search --query "browser-use" --json
{"success": true, "data": {"results": [...]}}

Quick Start

Set up in five minutes

Step 1: Install

# PyPI install (recommended)
pip install cliany-site

# Or install from source
git clone https://github.com/pearjelly/cliany.site.git
cd cliany-site
pip install -e .

Step 2: Configure LLM

export CLIANY_LLM_PROVIDER=anthropic
export CLIANY_ANTHROPIC_API_KEY="sk-ant-..."

Step 3: Chrome Setup

# Auto-detect and launch (recommended, no manual setup)
cliany-site doctor --json

# Or manually start CDP (advanced users)
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
  --remote-debugging-port=9222 \
  --user-data-dir=/tmp/chrome-debug

Step 4: Start Exploring

cliany-site doctor --json
cliany-site explore "https://github.com" "search repos" --json