grandamenium OpenCLI — Turn Websites Into CLI Commands
Converts any website into a deterministic CLI by driving Chrome's live session. No credentials stored — reuses whatever Chrome is already logged into.
Prerequisites (One-Time Setup)
OpenCLI requires a Chrome extension to bridge between the CLI and the browser.
1. Install the Browser Bridge extension
# Check if already set up
opencli doctor
If not connected:
- Download the extension from: https://github.com/jackwener/opencli/releases (look for
browser-bridge-extension.zip) - Open Chrome →
chrome://extensions→ enable Developer Mode - Click Load unpacked → select the extracted extension folder
- Run
opencli doctor— should show[OK] Extension: connected
2. Log into target sites in Chrome
OpenCLI uses Chrome's existing session. Navigate to the target site in Chrome and log in before running any command.
3. Verify
opencli doctor
# Expected:
# [OK] Daemon: running on port 19825
# [OK] Extension: connected
# [OK] Connectivity: ok
Core Commands
| Command | What it does |
|---|---|
opencli doctor |
Diagnose extension connectivity |
opencli explore <url> |
Discover APIs, data stores, and recommended strategies |
opencli generate <url> |
One-shot: explore → synthesize → verify → register adapter |
opencli cascade <url> |
Probe public endpoints before committing to session-based approach |
opencli browser |
Direct page control — navigate, click, type, extract |
opencli record <url> |
Capture API calls from live session → generate YAML candidates |
opencli list |
List all available adapters (87+ built-in) |
Adapter Generation Workflow
Use this to build a new adapter for any site:
# Step 1: Explore — discover what the site exposes
opencli explore https://app.example.com \
--goal "read maintenance work orders and their comments"
# Step 2: Generate — build and register the adapter
opencli generate https://app.example.com \
--goal "list open work orders with latest comment"
# Step 3: Use it
opencli <adapter-name> list-orders
opencli <adapter-name> get-comments --meld-id 12345
Record-then-synthesize (alternative for complex auth flows)
# Record API calls from your live session
opencli record https://app.example.com
# Perform the actions manually in Chrome while recording
# Stop recording — synthesize converts captured calls to adapter
opencli synthesize propertymeld
Property Meld Adapter Blueprint
Goal: Read meld comments (replacing pm-get-comments.py Playwright script)
Status: Blueprint ready. Requires Chrome extension setup + PropertyMeld login in Chrome to complete.
When extension is connected, run:
# Explore what PropertyMeld exposes
opencli explore https://app.propertymeld.com \
--goal "read meld work orders and associated comments/notes"
# Generate the adapter
opencli generate https://app.propertymeld.com \
--goal "list open melds with latest comment for triage"
Expected adapter commands (once generated):
# List open melds
opencli propertymeld list-melds --status open
# Get comments on a specific meld
opencli propertymeld get-comments --meld-id 12345
# Triage summary (all open melds with latest comment)
opencli propertymeld triage --format json
PropertyMeld API endpoints to target during recording
Based on existing Playwright scripts, these endpoints carry the relevant data:
| Endpoint | Data |
|---|---|
/api/v2/melds/ |
Work order list, status, assignee, property |
/api/v2/melds/{id}/comments/ |
Meld comments and notes |
/api/v2/melds/{id}/ |
Single meld detail |
Tip: Use opencli record while navigating the Melds page and opening a meld — it captures the actual API calls Chrome makes, which is more reliable than guessing endpoints.
Browser Control (no adapter needed)
For one-off browser interactions without building an adapter:
# Open a session
opencli browser
# Navigate
> navigate https://app.propertymeld.com/melds/
# Extract text from current page
> extract .meld-list-item
# Click a button
> click "View Details"
# Wait for element
> wait .comments-panel
# Get structured data
> extract table --format json
Using Built-In Adapters
87+ adapters ship out of the box:
opencli list # see all
opencli gh pr list # GitHub (wraps gh CLI)
opencli obsidian list # Obsidian vault
Output Formats
All commands support structured output:
opencli propertymeld list-melds --format json
opencli propertymeld list-melds --format csv
opencli propertymeld list-melds --format table # default
Notes
- Session-backed: if Chrome logs out, commands return empty data
- Zero LLM cost at runtime — adapters are pre-compiled YAML + JS
- Additive: does not replace existing Playwright scripts; use alongside them
opencli cascadefirst if unsure whether the site has public API endpoints (no extension needed for public routes)
OpenCLI v1.7.3. Daemon runs on port 19825. opencli doctor is the first debugging step for any connectivity issue.