"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/
Python
docs: add SKILL.md for CLI-Anything Hub registration
Scott667ff112e207
diff --git a/SKILL.md b/SKILL.mdnew file mode 100644index 000000000..8e428b66d--- /dev/null+++ b/SKILL.md@@ -0,0 +1,165 @@+# SKILL: CloakBrowser CLI++> Agent-friendly CLI for CloakBrowser — stealth Chromium that passes every bot detection test.++## Identity++- **Name**: cloakbrowser-cli+- **Display Name**: CloakBrowser CLI+- **Entry Point**: `cloak`+- **Install**: `npm install -g @dreamor/cloakbrowser-cli cloakbrowser playwright-core`+- **Package Manager**: npm+- **npm Package**: `@dreamor/cloakbrowser-cli`+- **Category**: web / browser-automation+- **Requires**: Node.js >= 20, cloakbrowser >= 0.3.0, playwright-core >= 1.40.0+- **Homepage**: https://github.com/dreamor/cloakbrowser-cli+- **Source**: https://github.com/dreamor/cloakbrowser-cli++## What It Does++CloakBrowser CLI (`cloak`) wraps the CloakBrowser stealth Chromium browser with a structured, agent-friendly command surface. It covers all CloakBrowser features: launch options, fingerprint flags, humanize behaviors, page operations, content extraction, cookies, storage, network, multi-page sessions, and a CDP server gateway.++AI agents can drive a real browser from any shell — fetch pages, fill forms, click elements, take screenshots, extract content, manage sessions, and bypass fingerprint detection — all with JSON output designed for programmatic consumption.++## Two Modes++### One-shot (no daemon)++Best for "fetch this URL and give me the markdown / a screenshot":++```bash+cloak fetch https://example.com --markdown --pretty+cloak fetch https://target.com --humanize --proxy=http://u:p@host:port --text+cloak scrape https://example.com --selector="h1" --multi+```++### Daemon + Long Session++Best for "log in, click around, scrape over several pages":++```bash+cloak daemon start+SID=$(cloak session new --humanize | jq -r .data.session_id)+cloak goto $SID https://demo.fingerprint.com+cloak wait $SID --selector="#visitor-id"+cloak text $SID --selector="#visitor-id"+cloak screenshot $SID --path=./fp.png --full-page+cloak session close $SID+```++## Command Reference++### Daemon++| Command | Description |+|---------|-------------|+| `cloak daemon start` | Spawn the daemon detached |+| `cloak daemon stop` | Stop and free all sessions |+| `cloak daemon status` | Show pid, uptime, session count |+| `cloak daemon ping` | Round-trip health check |+| `cloak daemon methods` | List all 60+ RPC methods |++### Sessions++| Command | Description |+|---------|-------------|+| `cloak session new [opts]` | Create session, returns `{session_id, page_id}` |+| `cloak session list` | List active sessions |+| `cloak session info <id>` | Session details |+| `cloak session close <id>` | Close + free resources |+| `cloak session save-state <id> <path>` | Dump storageState JSON |++### Navigation++`cloak goto <sid> <url>` · `back` · `forward` · `reload` · `url` · `title`++### Content Extraction++`content` (HTML) · `text` (innerText) · `html` · `attr` · `markdown` · `screenshot` · `pdf`++### Interaction (humanize-aware)++`click` · `dblclick` · `fill` · `type` · `press` · `hover` · `focus` · `blur` · `scroll` · `select` · `check` · `uncheck` · `upload` · `drag` · `dispatch`++### Wait / Snapshot / Frames++`cloak wait <sid> [--selector] [--text] [--url] [--state] [--timeout]` · `sleep` · `snapshot` (a11y tree with uids) · `frames` · `a11y`++### Cookies / Storage++`cloak cookies get|set|clear` · `cloak storage save|load` · `cloak local-storage get|set|clear` · `cloak session-storage get|set|clear`++### Network++`cloak request <sid> <url> [--method] [--header] [--body|--json|--form]`++### One-shot Helpers++`cloak fetch <url> [opts] [--text] [--html] [--markdown] [--screenshot]` · `cloak scrape <url> --selector <sel> [--multi] [--attr]`++### Binary Management++`cloak binary install|info|update|clear-cache`++### Self-test++`cloak doctor` · `cloak test [--detector fingerprintjs|browserscan|botd|sannysoft]`++## Launch Options++All CloakBrowser launch flags are exposed:++- **Mode**: `--headless` / `--no-headless`, `--persistent <dir>`, `--channel <name>`+- **Network**: `--proxy <url>`, `--geoip`+- **Fingerprint**: `--fingerprint <seed>`, `--platform`, `--brand`, `--gpu-vendor`, `--gpu-renderer`, `--hardware-concurrency`, `--device-memory`, `--screen WxH`, `--webrtc-ip`+- **Locale/Display**: `--timezone`, `--locale`, `--user-agent`, `--viewport WxH`, `--color-scheme`+- **Humanize**: `--humanize`, `--humanize-preset careful|default|fast`, `--humanize-config <json>`+- **Context**: `--storage-state <path>`, `--extra-headers <json>`, `--permissions <json>`, `--extension <path>`+- **Misc**: `--extra-args <json>`, `--slow-mo <ms>`, `--timeout <ms>`++## Output Format++Default output is single-line JSON on stdout, exit code 0/1:++```json+// Success+{ "ok": true, "data": <any>, "session_id": "s-abc12345", "page_id": "p-def09876" }+// Failure (non-zero exit code, stderr)+{ "ok": false, "error": { "code": "TIMEOUT", "message": "...", "details": {...} } }+```++Add `--pretty` for human-readable colored output. Add `--quiet` to emit only `data` on success.++## Agent Integration Pattern++```bash+# 1. Start daemon once per project+cloak daemon start >/dev/null++# 2. Create session+SID=$(cloak session new --humanize | jq -r .data.session_id)++# 3. Drive it+cloak goto "$SID" https://target.com+SNAP=$(cloak snapshot "$SID")+# Agent reasons over $SNAP, picks element uid "u7"+cloak click "$SID" '[data-cloak-uid="u7"]'+cloak text "$SID" --selector="#result"++# 4. Persist state across turns+cloak session save-state "$SID" ./state.json+# Later, in a fresh process:+SID=$(cloak session new --storage-state=./state.json | jq -r .data.session_id)+```++## Error Codes++`BOOT_ERROR`, `INVALID_ARG`, `INVALID_JSON`, `MISSING_DEPENDENCY`, `DAEMON_NOT_RUNNING`, `DAEMON_ALREADY_RUNNING`, `DAEMON_TIMEOUT`, `SESSION_NOT_FOUND`, `PAGE_NOT_FOUND`, `BROWSER_LAUNCH_FAILED`, `NAVIGATION_FAILED`, `TIMEOUT`, `SELECTOR_NOT_FOUND`, `EVAL_FAILED`, `NETWORK_ERROR`, `IO_ERROR`, `NOT_IMPLEMENTED`, `INTERNAL_ERROR`++## First-time Setup++```bash+npm install -g @dreamor/cloakbrowser-cli cloakbrowser playwright-core+cloak doctor # confirm everything is installed+cloak binary install # one-time ~200MB Chromium download+```