@zenalexa/unicli 0.211.2 → 0.212.1

package/README.md

@@ -1,4 +1,4 @@
-<!-- AGENT: npm install -g @zenalexa/unicli && unicli search "your intent" | 1020 commands across 198 sites. JSON when piped. Self-repairing YAML adapters. Bilingual search (EN/ZH). See AGENTS.md -->
+<!-- AGENT: npm install -g @zenalexa/unicli && unicli search "your intent" — hundreds of commands across ~200 sites. JSON when piped. Self-repairing YAML adapters. Bilingual EN/ZH search. See AGENTS.md for live counts. -->
 
 <div align="center">
 
@@ -10,16 +10,17 @@
 
 <br><br>
 
-**The compiler that turns the internet into CLI commands for AI agents.**
+**CLI is all agents need.**
+
+The execution layer for agent skills. Deterministic, editable, cross-vendor.
 
 <br>
 
-<img src="https://img.shields.io/badge/198_sites-1020_commands-00d4aa?style=flat-square" alt="coverage">
-<img src="https://img.shields.io/badge/~80_tokens-per_call-E8A838?style=flat-square" alt="tokens">
-<img src="https://img.shields.io/badge/self--repairing-YAML_adapters-8B5CF6?style=flat-square" alt="self-repair">
 <a href="https://www.npmjs.com/package/@zenalexa/unicli"><img src="https://img.shields.io/npm/v/@zenalexa/unicli?style=flat-square&color=cb3837" alt="npm"></a>
 <a href="https://github.com/olo-dot-io/Uni-CLI/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/olo-dot-io/Uni-CLI/ci.yml?style=flat-square&label=CI" alt="CI"></a>
 <a href="./LICENSE"><img src="https://img.shields.io/github/license/olo-dot-io/Uni-CLI?style=flat-square" alt="license"></a>
+<img src="https://img.shields.io/badge/tests-<!-- STATS:test_count -->1146<!-- /STATS -->-44cc11?style=flat-square" alt="tests">
+<img src="https://img.shields.io/badge/agent--reach-ally-6a5acd?style=flat-square" alt="agent-reach ally">
 
 <br><br>
 
@@ -27,56 +28,93 @@
 npm install -g @zenalexa/unicli
 ```
 
+<br>
+
+<img src="docs/demo/demo.svg" alt="Uni-CLI in 30 seconds" width="720">
+
 </div>
 
 ---
 
-```bash
-unicli search "推特热门"                   # Bilingual discovery → twitter trending
-unicli hackernews top --limit 5          # Hacker News front page
-unicli twitter search "AI agents"        # Twitter (authenticated)
-unicli bilibili hot                      # Bilibili trending
-unicli blender render scene.blend        # Render a 3D scene
-unicli notion search "meeting notes"     # Search Notion
-unicli macos screenshot                  # macOS screenshot
-unicli ffmpeg compress video.mp4         # Compress video
-```
+## What
 
-Every command outputs **structured JSON when piped** — zero flags needed. Every error emits structured JSON to stderr with the adapter path, the failing step, and a fix suggestion. **~80 tokens per call.**
+Uni-CLI is a universal interface that compiles agent intent into deterministic CLI programs. One binary reaches <!-- STATS:site_count -->200<!-- /STATS --> sites, 30+ desktop apps, 35 CLI bridges, and the local OS — <!-- STATS:command_count -->968<!-- /STATS --> commands in total. Every adapter is a 20-line YAML pipeline, so agents can read, edit, and re-run them without a compiler.
 
-```mermaid
-graph LR
-    A[AI Agent] -->|"unicli search 'intent'"| B["Uni-CLI"]
-    B --> C["YAML Adapter<br>~20 lines"]
-    C --> D["Web API"]
-    C --> E["Chrome CDP"]
-    C --> F["Subprocess"]
-    B -.->|self-repair| C
-```
+Coverage is cross-cutting: web APIs and browser automation, desktop subprocesses (ffmpeg, Blender, LibreOffice), macOS system calls (screenshot, clipboard, Calendar), and Computer Use Agents (Anthropic, OpenAI, Google) — all behind the same `unicli <site> <command>` surface. Output is a table in a terminal and JSON when piped. Errors are structured JSON on stderr with the adapter path, the failing step, and a suggestion — enough directional feedback for an agent to fix the adapter and retry.
+
+Self-repair is a first-class capability. When a site changes its API, an agent reads the 20-line YAML, edits the selector or endpoint, saves to `~/.unicli/adapters/`, and retries. Fixes survive `npm update`. No human in the loop.
 
-## Key Ideas
+## Why
 
-**Universal** — 198 sites, 30+ desktop apps, 8 Electron apps, 35 CLI bridges, 51 macOS system commands. One interface: `unicli <site> <command>`.
+MCP tool catalogs cost 4–35× more tokens per call than an equivalent CLI invocation, and 55K tokens of cold-start tax before the agent touches a tool (Firecrawl, Scalekit, Apideck benchmarks; see [`docs/BENCHMARK.md`](docs/BENCHMARK.md)). Agents perform better with executable programs than with catalogs of tool descriptions. Retrieval-over-catalog research in 2025–2026 (Semantic Tool Discovery, ITR Dynamic Tool Exposure, JSPLIT) reports 95–99% context reduction when tools are fetched on demand.
 
-**Discoverable** — BM25 bilingual search engine. `unicli search "推特热门"` finds `twitter trending`. `unicli search "download video"` finds `bilibili download`. Agents find what they need in one call.
+Uni-CLI is the execution half of that equation. The MCP server exposes 4 meta-tools (~200 tokens cold-start) — `unicli_run`, `unicli_list`, `unicli_search`, `unicli_explore` — and the agent pulls the exact tool it needs via BM25 bilingual search over a 50KB index. The CLI itself costs one subprocess per call.
 
-**Self-repairing** — When a site changes its API, the agent reads the ~20 line YAML adapter, fixes it, retries. No human in the loop. Fixes persist across updates.
+## Quick start
 
-**Agent-native** — Piped output auto-switches to JSON. Errors are machine-parseable. Exit codes follow `sysexits.h`. The agent doesn't need flags or special handling.
+Five minutes, top-to-bottom:
 
-**Cheap** — ~80 tokens per CLI invocation vs 55,000 tokens for an MCP tool catalog. Three orders of magnitude cheaper in context window cost.
+```bash
+# 1. Install
+npm install -g @zenalexa/unicli
 
-## Self-Repair
+# 2. Discover
+unicli list                                   # all sites + commands
+unicli search "推特热门"                       # → twitter trending (bilingual)
 
-The core differentiator. When a command breaks, agents fix it themselves:
+# 3. Run
+unicli reddit hot --limit 3                   # zero-config web API
+unicli hackernews top --json | jq '.[].title' # pipe + transform
+
+# 4. Wire into an agent
+claude mcp add unicli -- npx @zenalexa/unicli mcp serve   # Claude Code (MCP stdio)
+unicli mcp serve --transport streamable --port 19826      # Any MCP client (HTTP)
+unicli acp                                                # avante.nvim / Zed (ACP)
+```
+
+Full walkthrough with 5 worked examples: [`docs/QUICKSTART.md`](docs/QUICKSTART.md).
+
+## Architecture
 
 ```mermaid
-flowchart LR
-    A["unicli site cmd\n❌ fails"] --> B["Structured error\n{adapter_path, step, suggestion}"]
-    B --> C["Agent reads\n20-line YAML"]
-    C --> D["Agent edits\nthe adapter"]
-    D --> E["unicli site cmd\n✅ works"]
-    E --> F["Fix persists in\n~/.unicli/adapters/"]
+graph TB
+    CMD["unicli &lt;site&gt; &lt;command&gt;"]
+
+    CMD --> ADAPT["Adapter layer<br/>887 YAML · 72 TS · 35 bridges"]
+
+    ADAPT --> ENGINE["Pipeline engine — <!-- STATS:pipeline_step_count -->54<!-- /STATS -->+ steps<br/>fetch · navigate · exec · extract · each · if · parallel"]
+
+    ENGINE --> T1["HTTP<br/>(web APIs)"]
+    ENGINE --> T2["CDP Browser<br/>(raw WebSocket)"]
+    ENGINE --> T3["Subprocess<br/>(ffmpeg, yt-dlp, gh)"]
+    ENGINE --> T4["Desktop-AX<br/>(macOS AppleScript)"]
+    ENGINE --> T5["Desktop-UIA<br/>(Windows UIAutomation)"]
+    ENGINE --> T6["Desktop-AT-SPI<br/>(Linux accessibility)"]
+    ENGINE --> T7["CUA<br/>(Anthropic · OpenAI · Google)"]
+
+    T1 --> OUT["Formatter<br/>table · json · yaml · csv · md"]
+    T2 --> OUT
+    T3 --> OUT
+    T4 --> OUT
+    T5 --> OUT
+    T6 --> OUT
+    T7 --> OUT
+```
+
+Seven TransportAdapters, one adapter layer, one formatter. Adapters are declarative YAML by default (Rice-decidable, no imports) and TypeScript when a site genuinely needs it. The full step reference lives in [`docs/ADAPTER-FORMAT.md`](docs/ADAPTER-FORMAT.md).
+
+## Self-repair
+
+When a command breaks:
+
+```
+unicli <site> <cmd> fails
+  → structured JSON error on stderr
+    { adapter_path, step, action, suggestion }
+  → agent opens the ~20-line YAML
+  → agent edits the selector / URL / auth
+  → unicli <site> <cmd> works
+  → fix persists in ~/.unicli/adapters/ (survives npm update)
 ```
 
 ```bash
@@ -85,649 +123,83 @@ unicli test hackernews            # Validate adapter
 unicli repair --loop              # Autonomous fix loop
 ```
 
-Fixes are saved to `~/.unicli/adapters/` and survive `npm update`.
+Exit codes follow `sysexits.h`: `0` ok, `66` empty, `69` unavailable, `75` temporary, `77` auth, `78` config. Agents parse those directly — no regex over human error text.
 
-## Supported Platforms
+## Feature matrix
 
-<table><tr><td>
+| Capability               | What it means                                                                                        |
+| ------------------------ | ---------------------------------------------------------------------------------------------------- |
+| **CUA backends**         | Anthropic `computer-use`, OpenAI Operator, Google CUA, and direct CDP — 4 transports behind one flag |
+| **MCP transports**       | stdio · Streamable HTTP (spec 2025-11-25) · SSE · OAuth 2.1 PKCE                                     |
+| **ACP ready**            | `unicli acp` speaks JSON-RPC 2.0 for avante.nvim, Zed, Gemini CLI                                    |
+| **Cross-vendor skills**  | Skills in `skills/` work in Claude Code, OpenCode, Codex, Cursor, Cline                              |
+| **Self-repair envelope** | Every error ships `adapter_path` + `step` + `suggestion` (Banach-convergent)                         |
+| **Bilingual search**     | BM25 + TF-IDF, 50KB index, <10ms queries, 200-entry ZH↔EN alias table                                |
+| **Browser daemon**       | Persistent Chrome via CDP, reuses your login sessions, 13-layer stealth                              |
 
-**198 sites** · **1020 commands** · **35 pipeline steps** · **BM25 bilingual search**
+Detailed benchmarks (p50/p95 token cost per category, vs GitHub MCP cold-start): [`docs/BENCHMARK.md`](docs/BENCHMARK.md).
 
-</td></tr></table>
+## Platform coverage
 
-<!-- =========================== -->
-<!--    WEB — SOCIAL MEDIA       -->
-<!-- =========================== -->
+<!-- STATS:site_count -->200<!-- /STATS --> sites · <!-- STATS:command_count -->968<!-- /STATS --> commands — the live list is auto-generated in [`AGENTS.md`](AGENTS.md) and split by domain:
 
-<details open>
-<summary><strong>Social Media — 25 sites</strong></summary>
-<br>
-<table>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=x.com&sz=32" width="16"> <b>Twitter</b> <sup>35</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=reddit.com&sz=32" width="16"> <b>Reddit</b> <sup>20</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=instagram.com&sz=32" width="16"> <b>Instagram</b> <sup>26</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=tiktok.com&sz=32" width="16"> <b>TikTok</b> <sup>16</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=facebook.com&sz=32" width="16"> <b>Facebook</b> <sup>12</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=bsky.app&sz=32" width="16"> <b>Bluesky</b> <sup>12</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=medium.com&sz=32" width="16"> <b>Medium</b> <sup>5</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=threads.net&sz=32" width="16"> <b>Threads</b> <sup>2</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=mastodon.social&sz=32" width="16"> <b>Mastodon</b> <sup>4</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=bilibili.com&sz=32" width="16"> <b>Bilibili</b> <sup>18</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=weibo.com&sz=32" width="16"> <b>Weibo</b> <sup>10</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=zhihu.com&sz=32" width="16"> <b>Zhihu</b> <sup>21</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=xiaohongshu.com&sz=32" width="16"> <b>Xiaohongshu</b> <sup>24</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=douyin.com&sz=32" width="16"> <b>Douyin</b> <sup>23</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=okjike.com&sz=32" width="16"> <b>Jike</b> <sup>10</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=douban.com&sz=32" width="16"> <b>Douban</b> <sup>12</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=v2ex.com&sz=32" width="16"> <b>V2EX</b> <sup>12</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=linux.do&sz=32" width="16"> <b>Linux.do</b> <sup>10</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=weread.qq.com&sz=32" width="16"> <b>WeRead</b> <sup>7</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=tieba.baidu.com&sz=32" width="16"> <b>Tieba</b> <sup>4</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=zsxq.com&sz=32" width="16"> <b>Zsxq</b> <sup>5</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=xiaoyuzhou.fm&sz=32" width="16"> <b>Xiaoyuzhou</b> <sup>3</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=blog.sina.com.cn&sz=32" width="16"> <b>Sinablog</b> <sup>4</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=toutiao.com&sz=32" width="16"> <b>Toutiao</b> <sup>2</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=baidu.com&sz=32" width="16"> <b>Baidu</b> <sup>2</sup></td>
-    <td></td>
-    <td></td>
-    <td></td>
-  </tr>
-</table>
-</details>
-
-<!-- =========================== -->
-<!--    WEB — TECH & DEV         -->
-<!-- =========================== -->
-
-<details>
-<summary><strong>Tech & Developer — 19 sites</strong></summary>
-<br>
-<table>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=news.ycombinator.com&sz=32" width="16"> <b>Hacker News</b> <sup>10</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=stackoverflow.com&sz=32" width="16"> <b>Stack Overflow</b> <sup>6</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=dev.to&sz=32" width="16"> <b>DEV</b> <sup>5</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=lobste.rs&sz=32" width="16"> <b>Lobsters</b> <sup>5</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=producthunt.com&sz=32" width="16"> <b>Product Hunt</b> <sup>5</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=github.com&sz=32" width="16"> <b>GitHub Trending</b> <sup>3</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=substack.com&sz=32" width="16"> <b>Substack</b> <sup>4</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=lesswrong.com&sz=32" width="16"> <b>LessWrong</b> <sup>15</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=npmjs.com&sz=32" width="16"> <b>npm</b> <sup>4</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=pypi.org&sz=32" width="16"> <b>PyPI</b> <sup>3</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=crates.io&sz=32" width="16"> <b>crates.io</b> <sup>3</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=cocoapods.org&sz=32" width="16"> <b>CocoaPods</b> <sup>2</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=brew.sh&sz=32" width="16"> <b>Homebrew</b> <sup>2</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=gitlab.com&sz=32" width="16"> <b>GitLab</b> <sup>3</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=gitee.com&sz=32" width="16"> <b>Gitee</b> <sup>3</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=npmtrends.com&sz=32" width="16"> <b>npm trends</b> <sup>2</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=hub.docker.com&sz=32" width="16"> <b>Docker Hub</b> <sup>3</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=ycombinator.com&sz=32" width="16"> <b>Y Combinator</b> <sup>1</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=itch.io&sz=32" width="16"> <b>itch.io</b> <sup>3</sup></td>
-    <td></td>
-  </tr>
-</table>
-</details>
-
-<!-- =========================== -->
-<!--    WEB — AI & ML            -->
-<!-- =========================== -->
-
-<details>
-<summary><strong>AI & ML — 17 sites</strong></summary>
-<br>
-<table>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=gemini.google.com&sz=32" width="16"> <b>Gemini</b> <sup>5</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=grok.x.ai&sz=32" width="16"> <b>Grok</b> <sup>1</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=deepseek.com&sz=32" width="16"> <b>DeepSeek</b> <sup>2</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=perplexity.ai&sz=32" width="16"> <b>Perplexity</b> <sup>1</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=doubao.com&sz=32" width="16"> <b>Doubao Web</b> <sup>9</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=notebooklm.google.com&sz=32" width="16"> <b>NotebookLM</b> <sup>15</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=yollomi.com&sz=32" width="16"> <b>Yollomi</b> <sup>12</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=jimeng.jianying.com&sz=32" width="16"> <b>Jimeng</b> <sup>2</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=yuanbao.tencent.com&sz=32" width="16"> <b>Yuanbao</b> <sup>3</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=ollama.com&sz=32" width="16"> <b>Ollama</b> <sup>4</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=openrouter.ai&sz=32" width="16"> <b>OpenRouter</b> <sup>2</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=huggingface.co&sz=32" width="16"> <b>Hugging Face</b> <sup>6</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=replicate.com&sz=32" width="16"> <b>Replicate</b> <sup>3</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=minimaxi.com&sz=32" width="16"> <b>MiniMax</b> <sup>3</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=doubao.com&sz=32" width="16"> <b>Doubao API</b> <sup>3</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=novita.ai&sz=32" width="16"> <b>Novita</b> <sup>3</sup></td>
-  </tr>
-</table>
-</details>
-
-<!-- =========================== -->
-<!--    WEB — VIDEO & STREAMING  -->
-<!-- =========================== -->
-
-<details>
-<summary><strong>Video & Streaming — 8 sites</strong></summary>
-<br>
-<table>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=youtube.com&sz=32" width="16"> <b>YouTube</b> <sup>9</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=twitch.tv&sz=32" width="16"> <b>Twitch</b> <sup>4</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=kuaishou.com&sz=32" width="16"> <b>Kuaishou</b> <sup>2</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=douyu.com&sz=32" width="16"> <b>Douyu</b> <sup>2</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=channels.weixin.qq.com&sz=32" width="16"> <b>WeChat Channels</b> <sup>2</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=podcasts.apple.com&sz=32" width="16"> <b>Apple Podcasts</b> <sup>3</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=spotify.com&sz=32" width="16"> <b>Spotify</b> <sup>4</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=music.163.com&sz=32" width="16"> <b>NetEase Music</b> <sup>4</sup></td>
-  </tr>
-</table>
-</details>
-
-<!-- =========================== -->
-<!--    WEB — NEWS & MEDIA       -->
-<!-- =========================== -->
-
-<details>
-<summary><strong>News & Media — 10 sites</strong></summary>
-<br>
-<table>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=bloomberg.com&sz=32" width="16"> <b>Bloomberg</b> <sup>10</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=reuters.com&sz=32" width="16"> <b>Reuters</b> <sup>4</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=bbc.com&sz=32" width="16"> <b>BBC</b> <sup>4</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=cnn.com&sz=32" width="16"> <b>CNN</b> <sup>2</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=nytimes.com&sz=32" width="16"> <b>NYTimes</b> <sup>2</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=36kr.com&sz=32" width="16"> <b>36Kr</b> <sup>5</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=techcrunch.com&sz=32" width="16"> <b>TechCrunch</b> <sup>2</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=theverge.com&sz=32" width="16"> <b>The Verge</b> <sup>2</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=infoq.com&sz=32" width="16"> <b>InfoQ</b> <sup>2</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=ithome.com&sz=32" width="16"> <b>IT Home</b> <sup>3</sup></td>
-    <td></td>
-    <td></td>
-  </tr>
-</table>
-</details>
-
-<!-- =========================== -->
-<!--    WEB — FINANCE            -->
-<!-- =========================== -->
-
-<details>
-<summary><strong>Finance & Trading — 8 sites</strong></summary>
-<br>
-<table>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=xueqiu.com&sz=32" width="16"> <b>Xueqiu</b> <sup>12</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=finance.sina.com.cn&sz=32" width="16"> <b>Sina Finance</b> <sup>5</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=barchart.com&sz=32" width="16"> <b>Barchart</b> <sup>4</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=finance.yahoo.com&sz=32" width="16"> <b>Yahoo Finance</b> <sup>3</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=binance.com&sz=32" width="16"> <b>Binance</b> <sup>3</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=futunn.com&sz=32" width="16"> <b>Futu</b> <sup>2</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=coinbase.com&sz=32" width="16"> <b>Coinbase</b> <sup>2</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=eastmoney.com&sz=32" width="16"> <b>Eastmoney</b> <sup>4</sup></td>
-  </tr>
-</table>
-</details>
-
-<!-- =========================== -->
-<!--    WEB — SHOPPING & LIFE    -->
-<!-- =========================== -->
-
-<details>
-<summary><strong>Shopping & Lifestyle — 14 sites</strong></summary>
-<br>
-<table>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=amazon.com&sz=32" width="16"> <b>Amazon</b> <sup>8</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=jd.com&sz=32" width="16"> <b>JD</b> <sup>3</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=taobao.com&sz=32" width="16"> <b>Taobao</b> <sup>2</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=1688.com&sz=32" width="16"> <b>1688</b> <sup>3</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=pinduoduo.com&sz=32" width="16"> <b>Pinduoduo</b> <sup>2</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=smzdm.com&sz=32" width="16"> <b>SMZDM</b> <sup>3</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=meituan.com&sz=32" width="16"> <b>Meituan</b> <sup>2</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=ele.me&sz=32" width="16"> <b>Ele.me</b> <sup>2</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=dianping.com&sz=32" width="16"> <b>Dianping</b> <sup>2</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=coupang.com&sz=32" width="16"> <b>Coupang</b> <sup>3</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=ctrip.com&sz=32" width="16"> <b>Ctrip</b> <sup>2</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=xianyu.com&sz=32" width="16"> <b>Xianyu</b> <sup>3</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=dangdang.com&sz=32" width="16"> <b>Dangdang</b> <sup>2</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=maoyan.com&sz=32" width="16"> <b>Maoyan</b> <sup>2</sup></td>
-    <td></td>
-    <td></td>
-  </tr>
-</table>
-</details>
-
-<!-- =========================== -->
-<!--    WEB — JOBS               -->
-<!-- =========================== -->
-
-<details>
-<summary><strong>Jobs & Careers — 2 sites</strong></summary>
-<br>
-<table>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=zhipin.com&sz=32" width="16"> <b>Boss Zhipin</b> <sup>14</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=linkedin.com&sz=32" width="16"> <b>LinkedIn</b> <sup>4</sup></td>
-    <td></td>
-    <td></td>
-  </tr>
-</table>
-</details>
-
-<!-- =========================== -->
-<!--    WEB — REFERENCE          -->
-<!-- =========================== -->
-
-<details>
-<summary><strong>Education & Reference — 15 sites</strong></summary>
-<br>
-<table>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=google.com&sz=32" width="16"> <b>Google</b> <sup>4</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=wikipedia.org&sz=32" width="16"> <b>Wikipedia</b> <sup>5</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=arxiv.org&sz=32" width="16"> <b>arXiv</b> <sup>3</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=cnki.net&sz=32" width="16"> <b>CNKI</b> <sup>1</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=chaoxing.com&sz=32" width="16"> <b>Chaoxing</b> <sup>2</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=dictionary.com&sz=32" width="16"> <b>Dictionary</b> <sup>3</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=imdb.com&sz=32" width="16"> <b>IMDb</b> <sup>7</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=paperreview.com&sz=32" width="16"> <b>PaperReview</b> <sup>3</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=exchangerate-api.com&sz=32" width="16"> <b>Exchange Rate</b> <sup>2</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=ipinfo.io&sz=32" width="16"> <b>IP Info</b> <sup>1</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=qweather.com&sz=32" width="16"> <b>QWeather</b> <sup>2</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=unsplash.com&sz=32" width="16"> <b>Unsplash</b> <sup>2</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=pexels.com&sz=32" width="16"> <b>Pexels</b> <sup>2</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=sspai.com&sz=32" width="16"> <b>Sspai</b> <sup>2</sup></td>
-    <td></td>
-    <td></td>
-  </tr>
-</table>
-</details>
-
-<!-- =========================== -->
-<!--    WEB — OTHER              -->
-<!-- =========================== -->
-
-<details>
-<summary><strong>Other Web — 16 sites</strong></summary>
-<br>
-<table>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=ones.com&sz=32" width="16"> <b>Ones</b> <sup>11</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=pixiv.net&sz=32" width="16"> <b>Pixiv</b> <sup>6</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=hupu.com&sz=32" width="16"> <b>Hupu</b> <sup>7</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=steampowered.com&sz=32" width="16"> <b>Steam</b> <sup>6</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=band.us&sz=32" width="16"> <b>Band</b> <sup>4</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=xiaoe-tech.com&sz=32" width="16"> <b>Xiaoe</b> <sup>5</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=quark.cn&sz=32" width="16"> <b>Quark</b> <sup>2</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=mubu.com&sz=32" width="16"> <b>Mubu</b> <sup>2</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=ke.com&sz=32" width="16"> <b>Ke.com</b> <sup>2</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=maimai.cn&sz=32" width="16"> <b>Maimai</b> <sup>1</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=feishu.cn&sz=32" width="16"> <b>Feishu</b> <sup>4</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=slock.it&sz=32" width="16"> <b>Slock</b> <sup>1</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=jianyu.com&sz=32" width="16"> <b>Jianyu</b> <sup>1</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=weixin.qq.com&sz=32" width="16"> <b>WeChat</b> <sup>4</sup></td>
-    <td></td>
-    <td></td>
-  </tr>
-</table>
-</details>
-
-<!-- =========================== -->
-<!--    DESKTOP SOFTWARE         -->
-<!-- =========================== -->
-
-<details>
-<summary><strong>Desktop Software — 30 apps</strong></summary>
-<br>
-<table>
-  <tr>
-    <th colspan="4">3D / CAD</th>
-  </tr>
-  <tr>
-    <td><img src="https://cdn.simpleicons.org/blender/E87D0D" width="16"> <b>Blender</b> <sup>13</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=freecad.org&sz=32" width="16"> <b>FreeCAD</b> <sup>15</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=cloudcompare.org&sz=32" width="16"> <b>CloudCompare</b> <sup>4</sup></td>
-    <td><img src="https://cdn.simpleicons.org/godotengine/478CBF" width="16"> <b>Godot</b> <sup>2</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=renderdoc.org&sz=32" width="16"> <b>RenderDoc</b> <sup>2</sup></td>
-    <td></td>
-    <td></td>
-    <td></td>
-  </tr>
-  <tr>
-    <th colspan="4">Image</th>
-  </tr>
-  <tr>
-    <td><img src="https://cdn.simpleicons.org/gimp/5C5543" width="16"> <b>GIMP</b> <sup>12</sup></td>
-    <td><img src="https://cdn.simpleicons.org/inkscape/000000" width="16"> <b>Inkscape</b> <sup>3</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=imagemagick.org&sz=32" width="16"> <b>ImageMagick</b> <sup>6</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=krita.org&sz=32" width="16"> <b>Krita</b> <sup>4</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://cdn.simpleicons.org/sketch/F7B500" width="16"> <b>Sketch</b> <sup>3</sup></td>
-    <td></td>
-    <td></td>
-    <td></td>
-  </tr>
-  <tr>
-    <th colspan="4">Video / Audio</th>
-  </tr>
-  <tr>
-    <td><img src="https://cdn.simpleicons.org/ffmpeg/007808" width="16"> <b>FFmpeg</b> <sup>11</sup></td>
-    <td><img src="https://cdn.simpleicons.org/kdenlive/527EB2" width="16"> <b>Kdenlive</b> <sup>3</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=shotcut.org&sz=32" width="16"> <b>Shotcut</b> <sup>3</sup></td>
-    <td><img src="https://cdn.simpleicons.org/audacity/0000CC" width="16"> <b>Audacity</b> <sup>8</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=musescore.org&sz=32" width="16"> <b>MuseScore</b> <sup>5</sup></td>
-    <td></td>
-    <td></td>
-    <td></td>
-  </tr>
-  <tr>
-    <th colspan="4">Productivity</th>
-  </tr>
-  <tr>
-    <td><img src="https://cdn.simpleicons.org/obsstudio/302E31" width="16"> <b>OBS Studio</b> <sup>8</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=zotero.org&sz=32" width="16"> <b>Zotero</b> <sup>8</sup></td>
-    <td><img src="https://cdn.simpleicons.org/visualstudiocode/007ACC" width="16"> <b>VS Code</b> <sup>3</sup></td>
-    <td><img src="https://cdn.simpleicons.org/obsidian/7C3AED" width="16"> <b>Obsidian</b> <sup>3</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://cdn.simpleicons.org/notion/000000" width="16"> <b>Notion</b> <sup>3</sup></td>
-    <td><img src="https://cdn.simpleicons.org/libreoffice/18A303" width="16"> <b>LibreOffice</b> <sup>2</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=pandoc.org&sz=32" width="16"> <b>Pandoc</b> <sup>1</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=draw.io&sz=32" width="16"> <b>Draw.io</b> <sup>1</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=mermaid.js.org&sz=32" width="16"> <b>Mermaid</b> <sup>1</sup></td>
-    <td></td>
-    <td></td>
-    <td></td>
-  </tr>
-  <tr>
-    <th colspan="4">Other</th>
-  </tr>
-  <tr>
-    <td><img src="https://cdn.simpleicons.org/googlechrome/4285F4" width="16"> <b>Chrome</b> <sup>2</sup></td>
-    <td><img src="https://cdn.simpleicons.org/zoom/0B5CFF" width="16"> <b>Zoom</b> <sup>2</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=wiremock.org&sz=32" width="16"> <b>WireMock</b> <sup>5</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=adguard.com&sz=32" width="16"> <b>AdGuard Home</b> <sup>5</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=comfyui.com&sz=32" width="16"> <b>ComfyUI</b> <sup>4</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=steampowered.com&sz=32" width="16"> <b>Slay the Spire II</b> <sup>6</sup></td>
-    <td></td>
-    <td></td>
-  </tr>
-</table>
-</details>
-
-<!-- =========================== -->
-<!--    ELECTRON APPS            -->
-<!-- =========================== -->
-
-<details>
-<summary><strong>Electron Apps — 8 apps, 70+ commands</strong></summary>
-<br>
+| Domain                | Highlights                                                              |
+| --------------------- | ----------------------------------------------------------------------- |
+| **Social (25)**       | twitter, reddit, instagram, tiktok, xiaohongshu, bilibili, zhihu, weibo |
+| **Tech (19)**         | hackernews, stackoverflow, producthunt, github-trending, npm, pypi      |
+| **News (11)**         | bbc, reuters, bloomberg, nytimes, techcrunch, 36kr                      |
+| **Finance (8)**       | xueqiu, yahoo-finance, eastmoney, binance, coinbase                     |
+| **AI / ML (14)**      | huggingface, ollama, replicate, perplexity, deepseek, doubao            |
+| **Desktop (30+)**     | blender, ffmpeg, imagemagick, gimp, freecad, musescore, kdenlive        |
+| **macOS system (58)** | screenshot, clipboard, Calendar, Mail, Reminders, Shortcuts, Safari     |
+| **CLI bridges (35)**  | gh, yt-dlp, jq, aws, vercel, supabase, wrangler, stripe                 |
 
-All via Chrome DevTools Protocol — no extensions, no hacks.
-
-<table>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=cursor.com&sz=32" width="16"> <b>Cursor</b></td>
-    <td>ask, send, read, model, composer, extract-code, new, status, screenshot, dump, history, export</td>
-    <td><code>9226</code></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=openai.com&sz=32" width="16"> <b>Codex</b></td>
-    <td>ask, send, read, model, extract-diff, new, status, screenshot, dump, history, export</td>
-    <td><code>9222</code></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=chat.openai.com&sz=32" width="16"> <b>ChatGPT</b></td>
-    <td>ask, send, read, model, new, status, screenshot, dump</td>
-    <td><code>9236</code></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=notion.so&sz=32" width="16"> <b>Notion</b></td>
-    <td>search, read, write, new, status, sidebar, favorites, export, screenshot</td>
-    <td><code>9230</code></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=discord.com&sz=32" width="16"> <b>Discord</b></td>
-    <td>servers, channels, read, send, search, members, status, delete</td>
-    <td><code>9232</code></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=chatwise.app&sz=32" width="16"> <b>ChatWise</b></td>
-    <td>ask, send, read, model, new, status, screenshot, dump</td>
-    <td><code>9228</code></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=doubao.com&sz=32" width="16"> <b>Doubao</b></td>
-    <td>ask, send, read, new, status, screenshot, dump</td>
-    <td><code>9225</code></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=antigravity.ai&sz=32" width="16"> <b>Antigravity</b></td>
-    <td>ask, send, read, model, new, status, screenshot, dump</td>
-    <td><code>9234</code></td>
-  </tr>
-</table>
-</details>
-
-<!-- =========================== -->
-<!--    CLI BRIDGES              -->
-<!-- =========================== -->
-
-<details>
-<summary><strong>CLI Bridges — 35 tools</strong></summary>
-<br>
+Run `unicli list` for the live catalog, or `unicli list --category=<domain>` to filter.
 
-Passthrough wrappers that normalize output to JSON:
-
-<table>
-  <tr>
-    <td><img src="https://cdn.simpleicons.org/docker/2496ED" width="16"> Docker</td>
-    <td><img src="https://cdn.simpleicons.org/github/181717" width="16"> gh</td>
-    <td><img src="https://www.google.com/s2/favicons?domain=jqlang.github.io&sz=32" width="16"> jq</td>
-    <td><img src="https://www.google.com/s2/favicons?domain=yt-dl.org&sz=32" width="16"> yt-dlp</td>
-  </tr>
-  <tr>
-    <td><img src="https://cdn.simpleicons.org/vercel/000000" width="16"> Vercel</td>
-    <td><img src="https://cdn.simpleicons.org/supabase/3FCF8E" width="16"> Supabase</td>
-    <td><img src="https://cdn.simpleicons.org/cloudflare/F38020" width="16"> Wrangler</td>
-    <td><img src="https://www.google.com/s2/favicons?domain=feishu.cn&sz=32" width="16"> Lark</td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=dingtalk.com&sz=32" width="16"> DingTalk</td>
-    <td><img src="https://www.google.com/s2/favicons?domain=huggingface.co&sz=32" width="16"> HF CLI</td>
-    <td><img src="https://www.google.com/s2/favicons?domain=anthropic.com&sz=32" width="16"> Claude Code</td>
-    <td><img src="https://www.google.com/s2/favicons?domain=openai.com&sz=32" width="16"> Codex CLI</td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=opencode.ai&sz=32" width="16"> OpenCode</td>
-    <td><img src="https://cdn.simpleicons.org/amazonaws/232F3E" width="16"> AWS</td>
-    <td><img src="https://cdn.simpleicons.org/googlecloud/4285F4" width="16"> GCloud</td>
-    <td><img src="https://cdn.simpleicons.org/microsoftazure/0078D4" width="16"> Azure</td>
-  </tr>
-  <tr>
-    <td><img src="https://cdn.simpleicons.org/digitalocean/0080FF" width="16"> DigitalOcean</td>
-    <td><img src="https://cdn.simpleicons.org/netlify/00C7B7" width="16"> Netlify</td>
-    <td><img src="https://www.google.com/s2/favicons?domain=railway.app&sz=32" width="16"> Railway</td>
-    <td><img src="https://www.google.com/s2/favicons?domain=fly.io&sz=32" width="16"> Fly.io</td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=planetscale.com&sz=32" width="16"> PlanetScale</td>
-    <td><img src="https://www.google.com/s2/favicons?domain=neon.tech&sz=32" width="16"> Neon</td>
-    <td><img src="https://cdn.simpleicons.org/slack/4A154B" width="16"> Slack</td>
-    <td><img src="https://www.google.com/s2/favicons?domain=kimi.ai&sz=32" width="16"> Kimi CLI</td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=workspace.google.com&sz=32" width="16"> GWS</td>
-    <td><img src="https://www.google.com/s2/favicons?domain=deepagents.ai&sz=32" width="16"> DeepAgents</td>
-    <td><img src="https://cdn.simpleicons.org/stripe/635BFF" width="16"> Stripe</td>
-    <td><img src="https://cdn.simpleicons.org/firebase/DD2C00" width="16"> Firebase</td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=minimaxi.com&sz=32" width="16"> MMX CLI</td>
-    <td><img src="https://www.google.com/s2/favicons?domain=wecom.work&sz=32" width="16"> WeCom</td>
-    <td><img src="https://www.google.com/s2/favicons?domain=mem0.ai&sz=32" width="16"> Mem0</td>
-    <td>+ more</td>
-  </tr>
-</table>
-</details>
-
-<!-- =========================== -->
-<!--    macOS SYSTEM             -->
-<!-- =========================== -->
-
-<details>
-<summary><strong><img src="https://cdn.simpleicons.org/apple/000000" width="16"> macOS System — 51 commands</strong></summary>
-<br>
-<table>
-  <tr>
-    <th>Audio/Display</th>
-    <td>volume, brightness, dark-mode, say</td>
-  </tr>
-  <tr>
-    <th>Power/System</th>
-    <td>battery, lock-screen, caffeinate, sleep, uptime, system-info</td>
-  </tr>
-  <tr>
-    <th>Files/Search</th>
-    <td>spotlight, disk-info, trash, empty-trash, open, finder-tags, finder-recent, finder-selection</td>
-  </tr>
-  <tr>
-    <th>Network</th>
-    <td>wifi, wifi-info, bluetooth</td>
-  </tr>
-  <tr>
-    <th>Notifications</th>
-    <td>notify, notification, do-not-disturb</td>
-  </tr>
-  <tr>
-    <th>Apps</th>
-    <td>apps, apps-list, active-app, open-app, safari-tabs, shortcuts-list, shortcuts-run</td>
-  </tr>
-  <tr>
-    <th>PIM</th>
-    <td>calendar-list, calendar-create, calendar-today, contacts-search, mail-status, mail-send, messages-send, reminders-list, reminders-create, reminders-complete</td>
-  </tr>
-  <tr>
-    <th>Media</th>
-    <td>music-now, music-control, photos-search, notes-list, notes-search, screenshot, clipboard, processes</td>
-  </tr>
-</table>
-</details>
-
-<!-- =========================== -->
-<!--    AGENT PLATFORMS          -->
-<!-- =========================== -->
-
-<details>
-<summary><strong>Agent Platforms — 6 integrations</strong></summary>
-<br>
-<table>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=hermes.ai&sz=32" width="16"> <b>Hermes</b> <sup>3</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=autoagent.dev&sz=32" width="16"> <b>AutoAgent</b> <sup>1</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=stagehand.dev&sz=32" width="16"> <b>Stagehand</b> <sup>1</sup></td>
-  </tr>
-  <tr>
-    <td><img src="https://www.google.com/s2/favicons?domain=github.com&sz=32" width="16"> <b>OpenHarness</b> <sup>2</sup></td>
-    <td><img src="https://www.google.com/s2/favicons?domain=openai.com&sz=32" width="16"> <b>CUA</b> <sup>2</sup></td>
-    <td></td>
-  </tr>
-</table>
-</details>
+## Agent integration
 
-## Architecture
+Every major agent platform works out of the box:
 
-```mermaid
-graph TB
-    CMD["unicli &lt;site&gt; &lt;command&gt; [args]"]
-
-    CMD --> YAML["YAML Adapter<br/><i>~20 lines, agent-editable</i>"]
-    CMD --> TS["TS Adapter<br/><i>complex logic</i>"]
-    CMD --> BRIDGE["Bridge<br/><i>passthrough to CLI</i>"]
-
-    YAML --> ENGINE
-    TS --> ENGINE
-    BRIDGE --> ENGINE
-
-    subgraph ENGINE ["Pipeline Engine — 35 steps"]
-        direction LR
-        API["fetch  fetch_text<br/>parse_rss  html_to_md"]
-        TRANSFORM["select  map  filter<br/>sort  limit"]
-        BROWSER["navigate  evaluate<br/>click  type  press<br/>scroll  intercept<br/>snapshot  tap  extract"]
-        CONTROL["set  if  each<br/>parallel  append<br/>rate_limit  assert  retry"]
-        OTHER["exec  write_temp<br/>download  websocket"]
-    end
-
-    ENGINE --> CDP["Direct CDP"]
-    ENGINE --> DAEMON["Browser Daemon<br/><i>reuses Chrome logins</i>"]
-
-    CDP --> OUT["Output Formatter<br/><i>table · json · yaml · csv · md</i>"]
-    DAEMON --> OUT
+| Platform        | One-liner                                                  | Notes                                     |
+| --------------- | ---------------------------------------------------------- | ----------------------------------------- |
+| **Claude Code** | `claude mcp add unicli -- npx @zenalexa/unicli mcp serve`  | 4 meta-tools, stdio                       |
+| **Codex CLI**   | Add `[mcp_servers.unicli]` to `~/.codex/config.toml`       | First-class AGENTS.md citizen             |
+| **Cursor**      | MCP Settings → `unicli` → `npx @zenalexa/unicli mcp serve` | Bilingual search works inside Cursor chat |
+| **avante.nvim** | `type = "acp", command = "unicli", args = { "acp" }`       | See [`docs/AVANTE.md`](docs/AVANTE.md)    |
+| **OpenCode**    | MCP via `opencode.jsonc` — `command: "unicli mcp serve"`   | AGENTS.md auto-loaded                     |
+| **Cline**       | Add MCP server in settings — stdio transport               | Same 4 meta-tools, 200-token cold start   |
+
+Direct shell access (any agent with Bash or exec):
+
+```bash
+unicli twitter search "AI agents"
+unicli blender render scene.blend --output /tmp/frame.png
+unicli macos screenshot --region 0,0,1920,1080
 ```
 
-Remote browser support via `UNICLI_CDP_ENDPOINT` — connect to any CDP WebSocket (Cloudflare Browser Rendering, Browserless, or self-hosted).
+## Authentication
 
-## Write an Adapter
+Five auth strategies, auto-probed in a cascade (`public → cookie → header`):
 
-Most adapters are ~20 lines of YAML:
+| Strategy    | How                                                    |
+| ----------- | ------------------------------------------------------ |
+| `public`    | Direct HTTP, no credentials                            |
+| `cookie`    | `~/.unicli/cookies/<site>.json` injected into headers  |
+| `header`    | Cookie + auto-extracted CSRF (ct0, bili_jct, …)        |
+| `intercept` | Chrome navigates, Uni-CLI captures XHR/fetch responses |
+| `ui`        | Direct DOM interaction via CDP (click, type, submit)   |
+
+```bash
+unicli auth setup twitter    # Print required cookies + target path
+unicli auth check twitter    # Validate cookie file
+unicli auth list             # All configured sites
+```
+
+The browser daemon (`unicli browser start`) reuses your signed-in Chrome session via CDP — no cookie export, no extension install. Auto-exits after 4h idle.
+
+## Write an adapter
+
+Most adapters are ~20 lines of YAML. No TypeScript, no build step, no imports:
 
 ```yaml
 site: hackernews
@@ -742,147 +214,91 @@ pipeline:
       do:
         - fetch:
             url: "https://hacker-news.firebaseio.com/v0/item/${{ item }}.json"
-      max: "${{ args.limit | default(30) }}"
   - map:
       title: "${{ item.title }}"
       score: "${{ item.score }}"
       url: "${{ item.url }}"
-      by: "${{ item.by }}"
-columns: [title, score, by, url]
+columns: [title, score, url]
 ```
 
-Five adapter types: `web-api`, `desktop`, `browser`, `bridge`, `service`.
-
-29 template filters in a sandboxed VM: `join`, `urlencode`, `truncate`, `slugify`, `sanitize`, `basename`, `strip_html`, `default`, `split`, `first`, `last`, `length`, `keys`, `json`, `replace`, `lowercase`, `uppercase`, `trim`, `slice`, `reverse`, `unique`, `abs`, `round`, `ceil`, `floor`, `int`, `float`, `str`, `ext`.
-
-## Authentication
-
-Five strategies, auto-detected via cascade (`PUBLIC → COOKIE → HEADER`):
+Five adapter types: `web-api`, `desktop`, `browser`, `bridge`, `service`. 29 template filters (`join`, `urlencode`, `truncate`, `slugify`, `default`, `json`, …) run in a sandboxed VM.
 
-| Strategy    | How                                                      |
-| ----------- | -------------------------------------------------------- |
-| `public`    | Direct HTTP — no credentials                             |
-| `cookie`    | Injects cookies from `~/.unicli/cookies/<site>.json`     |
-| `header`    | Cookie + auto-extracted CSRF token (ct0, bili_jct, etc.) |
-| `intercept` | Navigates page in Chrome, captures XHR/fetch responses   |
-| `ui`        | Direct DOM interaction (click, type, submit)             |
+Scaffold, dev, test:
 
 ```bash
-unicli auth setup twitter    # Show required cookies + template
-unicli auth check twitter    # Validate cookie file
-unicli auth list             # List configured sites
+unicli init <site> <command>     # Scaffold new adapter
+unicli dev <path>                # Hot-reload during dev
+unicli test <site>               # Validate
+unicli record <url>              # Auto-generate adapter from traffic
 ```
 
-## Browser Daemon
+Full reference: [`docs/ADAPTER-FORMAT.md`](docs/ADAPTER-FORMAT.md). Migrating from OpenCLI: [`docs/MIGRATING-FROM-OPENCLI.md`](docs/MIGRATING-FROM-OPENCLI.md) and the one-shot `unicli import opencli-yaml`.
+
+## Search
 
-Persistent background process that reuses your Chrome login sessions — no cookie export, no extension install:
+Agents find commands by intent, bilingual:
 
 ```bash
-unicli daemon status             # Check daemon
-unicli operate open <url>        # Navigate
-unicli operate state             # DOM accessibility snapshot
-unicli operate click <ref>       # Click by ref
-unicli operate type <ref> <text> # Type into element
-unicli operate eval <js>         # Execute JavaScript
-unicli operate screenshot        # Capture page
-unicli record <url>              # Auto-generate adapter from traffic
+unicli search "推特热门"            # → twitter trending
+unicli search "download video"      # → bilibili download, yt-dlp download, twitter download
+unicli search "股票行情"            # → binance ticker, xueqiu quote, barchart quote
+unicli search --category finance    # browse by category
 ```
 
-13-layer anti-detection stealth: webdriver removal, `chrome.runtime` mock, CDP marker cleanup, `Error.stack` filtering, iframe consistency, and more. Auto-exits after 4h idle.
+BM25 + TF-IDF scoring with a 200-entry ZH↔EN alias table. The index is 50KB, queries complete in under 10ms.
 
-## Agent Integration
+## Theory + benchmarks
 
-Works with every major agent platform:
+The design rests on five principles, each tied to a citation in [`docs/refs.bib`](docs/refs.bib):
 
-```bash
-# Claude Code / Codex CLI — direct shell
-unicli twitter search "AI agents"
-
-# MCP — one command to expose all 969 commands
-unicli mcp serve
-
-# AGENTS.md — discovery file already included in repo
-cat AGENTS.md
-```
+1. **Rice's restriction** — every adapter has decidable semantics (YAML pipeline, no Turing-complete logic).
+2. **Lehman's mandate** — no adapter is permanent; self-repair is first-class.
+3. **Shannon's compression** — CLI invocations are near-optimal compression of the underlying API call.
+4. **Agent tool trilemma (original)** — coverage × accuracy × performance, pick two. We choose accuracy × performance.
+5. **Banach convergence** — structured errors must provide directional feedback (`adapter_path` + `step` + `suggestion`) so repair iterations converge.
 
-| Platform | Integration |
-| --- | --- |
-| **Claude Code** | Bash tool + MCP server + AGENTS.md |
-| **Codex CLI** | Shell execution + MCP + AGENTS.md (first-class) |
-| **OpenClaw** | Plugin + MCP + ClawHub skill |
-| **Hermes Agent** | MCP + Skills Hub + persistent shell |
-| **OpenCode** | MCP via opencode.jsonc + AGENTS.md |
+Full treatment with 42 citations: [`docs/THEORY.md`](docs/THEORY.md). Reproducible benchmarks comparing Uni-CLI to GitHub MCP and Firecrawl MCP: [`docs/BENCHMARK.md`](docs/BENCHMARK.md).
 
 ## Development
 
 ```bash
 git clone https://github.com/olo-dot-io/Uni-CLI.git && cd Uni-CLI
-npm install && npm run verify
+npm install
+npm run verify     # typecheck + lint + test + build + stats check
 ```
 
-| Command                | Purpose                   |
-| ---------------------- | ------------------------- |
-| `npm run dev`          | Dev run                   |
-| `npm run build`        | Production build          |
-| `npm run typecheck`    | TypeScript strict         |
-| `npm run lint`         | Oxlint                    |
-| `npm run test`         | Unit tests (788)          |
-| `npm run test:adapter` | Validate all adapters     |
-| `npm run verify`       | Full pipeline             |
+| Command                | Purpose                                                   |
+| ---------------------- | --------------------------------------------------------- |
+| `npm run dev`          | Run from source                                           |
+| `npm run build`        | Production build                                          |
+| `npm run typecheck`    | TypeScript strict                                         |
+| `npm run lint`         | Oxlint                                                    |
+| `npm run test`         | Unit tests (<!-- STATS:test_count -->1146<!-- /STATS -->) |
+| `npm run test:adapter` | Validate all adapters                                     |
+| `npm run verify`       | Full pipeline (7 gates)                                   |
 
-7 production dependencies: `chalk`, `cli-table3`, `commander`, `js-yaml`, `turndown`, `undici`, `ws`.
+Seven production dependencies: `chalk`, `cli-table3`, `commander`, `js-yaml`, `turndown`, `undici`, `ws`.
 
 ## Contributing
 
-The fastest way to contribute: write a [20-line YAML adapter](./CONTRIBUTING.md) for a site you use.
+The fastest path to a merged PR: write a 20-line YAML adapter for a site you use every day. Per-domain guides live in [`contributing/`](contributing/):
 
-```bash
-unicli init <site> <command>     # Scaffold new adapter
-unicli dev <path>                # Hot-reload during dev
-unicli test <site>               # Validate
-```
-
-## Search & Discovery
-
-Agents find commands through bilingual semantic search — no need to memorize site names.
-
-```bash
-unicli search "推特热门"              # → twitter trending
-unicli search "download video"        # → bilibili download, yt-dlp download, twitter download
-unicli search "股票行情"              # → binance ticker, barchart quote, xueqiu quote
-unicli search --category finance      # → all finance commands
-```
-
-The search engine uses BM25 scoring with a ~200-entry bilingual alias table (Chinese↔English). The entire index is 50KB, searches complete in <10ms.
-
-## Agent Integration
-
-```bash
-# CLI direct (any agent with shell access)
-npm install -g @zenalexa/unicli
-
-# MCP server (Claude Code, Codex CLI, Hermes, OpenCode)
-npx @zenalexa/unicli mcp serve
-
-# MCP with SSE transport (remote connections)
-npx @zenalexa/unicli mcp serve --transport sse --port 19826
-
-# MCP with OAuth (enterprise)
-npx @zenalexa/unicli mcp serve --transport http --auth
-```
-
-| Platform | One-line Setup |
-|----------|---------------|
-| **Claude Code** | `claude mcp add unicli -- npx @zenalexa/unicli mcp serve` |
-| **Codex CLI** | Add `[mcp_servers.unicli]` to `~/.codex/config.toml` |
-| **Any MCP client** | `npx @zenalexa/unicli mcp serve` (stdio) |
-
-The MCP server exposes 4 meta-tools by default (~200 tokens). `unicli_search` provides bilingual semantic search across all 1020 commands.
+| Area             | Guide                                                    |
+| ---------------- | -------------------------------------------------------- |
+| New adapter      | [`contributing/adapter.md`](contributing/adapter.md)     |
+| New transport    | [`contributing/transport.md`](contributing/transport.md) |
+| CUA backend      | [`contributing/cua.md`](contributing/cua.md)             |
+| MCP server       | [`contributing/mcp.md`](contributing/mcp.md)             |
+| ACP integration  | [`contributing/acp.md`](contributing/acp.md)             |
+| Release process  | [`contributing/release.md`](contributing/release.md)     |
+| Schema migration | [`contributing/schema.md`](contributing/schema.md)       |
 
 ## License
 
 [Apache-2.0](./LICENSE)
 
+Repo: <https://github.com/olo-dot-io/Uni-CLI> · npm: [`@zenalexa/unicli`](https://www.npmjs.com/package/@zenalexa/unicli) · Issues welcome.
+
 ---
 
 <p align="center">
@@ -893,5 +309,5 @@ The MCP server exposes 4 meta-tools by default (~200 tokens). `unicli_search` pr
 
 <p align="center">
   <sub>v0.211.2 — Vostok · Volynov</sub><br>
-  <sub>198 sites · 1020 commands · 35 pipeline steps · BM25+TF-IDF bilingual search · MCP 2025-03-26 · 855 tests</sub>
+  <sub><!-- STATS:site_count -->200<!-- /STATS --> sites · <!-- STATS:command_count -->968<!-- /STATS --> commands · <!-- STATS:pipeline_step_count -->54<!-- /STATS --> pipeline steps · BM25+TF-IDF bilingual search · MCP 2025-11-25 · <!-- STATS:test_count -->1146<!-- /STATS --> tests</sub>
 </p>