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/

{"ok": 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 {ok,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.

✂️

Smart DOM Pruning

4-layer AXTree pruning reduces LLM token usage by up to 50% for complex pages.

⚡

Lazy Adapter Registry

On-demand adapter loading accelerates CLI startup times significantly.

🔍

Diagnostic Mode

AI-powered root cause analysis for command execution failures.

📋

Metadata Schema v3

Enforces v3 metadata with `migrate` utility to auto-upgrade legacy adapters.

🔒

File Lock Protection

Concurrent-safe manifest and session writes via portalocker — no corruption under parallel processes.

🛡️

Tar Path Traversal Guard

Adapter import rejects archives with absolute paths, traversal segments, or symlink escapes.

🔄

Download Retry

Obscura binary downloads automatically retry on transient network failures with exponential back-off.

🗂️

Unified Error Codes

All error paths now carry machine-readable error codes and actionable fix hints in the JSON envelope.

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/
{"ok": true, "data": {"results": [...]}}
💡

Enterprise CRM: Login & Query

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

Login → CRM → Search → Details → Orders → Filter

5 steps · ~1m

Login once, then list-accounts --json

1 command · Instant
$ cliany-site login https://demo.suiteondemand.com/
✓ Session saved for demo.suiteondemand.com

$ cliany-site demo.suiteondemand.com list-accounts --limit 5 --json
{"ok": true, "data": {"accounts": [...], "count": 5}}
🚀

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 issues.apache.org list-issues --project SPARK --limit 5 --json
{"ok": true, "data": {"issues": [...]}}

$ cliany-site cwiki.apache.org search-pages --space SPARK --query "release" --json
{"ok": true, "data": {"results": [...]}}

$ cliany-site builds.apache.org list-jobs --json
{"ok": true, "data": {"jobs": [...]}}

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
{"ok": 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
{"ok": true, "data": {"adapters": ["github.com"]}}

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

10-Minute Success Path

Run a real demo adapter first, then configure LLM to generate your own commands

Step 1: Install

# PyPI install (v0.12.0+)
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: Check Readiness

# Human-readable first-run summary
cliany-site doctor

# Machine-readable automation output
cliany-site doctor --json

# Optional live LLM provider preflight before explore
cliany-site doctor --llm-live --json

Step 3: Run a Demo Adapter

# Download adapter assets from GitHub Release v0.14.1
cliany-site market install ./issues.apache.org.cliany-adapter-v0.14.0.tar.gz
cliany-site verify issues.apache.org --json
cliany-site issues.apache.org list-issues --project SPARK --limit 5 --json

Step 4: Generate Your Own

# Configure LLM only when you are ready to explore
# Retryable provider outages return E_LLM_UNAVAILABLE
export CLIANY_LLM_PROVIDER=anthropic
export CLIANY_ANTHROPIC_API_KEY="sk-ant-..."
cliany-site explore "https://github.com" "search repos" --json

After Your First Success

Ran a real public workflow? Propose it through the Real Demo Case Proposal path so it can become a validated case with an offline JSON example.

  • Use the Real Demo Case Proposal issue template for public, read-only workflows; generate candidate promotion issues with cliany-site cases --case-id pypi-project-search --issue-template, including Acceptance Criteria.
  • Candidate cases should point to cases/manifest.json, cases/examples/, python scripts/validate_cases.py --strict, cliany-site cases --status candidate --promotion-plan with llm_live_preflight, cliany-site cases --json with primary_next_task_acceptance_criteria, and python scripts/plan_next_iteration.py --issues-dir /tmp/cliany-candidate-issues with Primary Acceptance Criteria.
  • First-time contributors can start from docs/good-first-issues.md for offline, locally verifiable tasks.

Maintainer Loop

Use the daily release loop, weekly maintainer loop, and release readiness next_actions to turn the roadmap into small verified releases.

  • Start from docs/weekly-maintainer-loop.md when choosing the next release slice.
  • Read next_actions from python scripts/release_readiness.py --json or python scripts/check_release_cadence.py --json.

Experimental: Obscura Browser Provider

Obscura is a lightweight alternative to Chrome, currently in experimental status. Chrome remains the default provider.

  • Explore Not Supported: Obscura does not yet support AXTree exploration. Use it for executing existing adapters.
  • Platforms: darwin-arm64, darwin-x86_64, linux-x86_64, windows-x86_64
  • Lifecycle Commands: install / use / status / clean / rollback / upgrade / doctor