Skip to content
Back to search

Uni-CLI

One command for every interface—search, run, and inspect real software across APIs, browsers, desktops, local tools, and MCP.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/olo-dot-io/Uni-CLI with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/olo-dot-io/Uni-CLI'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/olo-dot-io--uni-cli/badge.svg)](/listings/olo-dot-io--uni-cli)

HTML

<a href="/listings/olo-dot-io--uni-cli"><img src="/api/listings/olo-dot-io--uni-cli/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 302 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src="assets/mascot-otter.png" alt="Uni-CLI otter mascot" width="112">
  3. </p>
  4. <h1 align="center">Uni-CLI</h1>
  5. <p align="center">
  6. <strong>Give agents every interface</strong><br>
  7. Install once. Search, run, inspect, repair.
  8. </p>
  9. <p align="center">
  10. <a href="https://olo-dot-io.github.io/Uni-CLI/">Website</a>&nbsp;&nbsp;
  11. <a href="https://olo-dot-io.github.io/Uni-CLI/reference/sites">Operations</a>&nbsp;&nbsp;
  12. <a href="https://www.npmjs.com/package/@zenalexa/unicli">npm</a>&nbsp;&nbsp;
  13. <a href="./README.zh-CN.md">简体中文</a>
  14. </p>
  15. <p align="center">
  16. <a href="https://www.npmjs.com/package/@zenalexa/unicli"><img alt="npm version" src="https://img.shields.io/npm/v/@zenalexa/unicli?style=flat-square&color=0A6244"></a>
  17. <a href="./LICENSE"><img alt="Apache 2.0 license" src="https://img.shields.io/badge/license-Apache--2.0-073F2B?style=flat-square"></a>
  18. <img alt="Node 22.19 or newer" src="https://img.shields.io/badge/node-22.19%2B-D86A35?style=flat-square">
  19. </p>
  20. <p align="center">
  21. <img src="docs/public/site-preview.webp" alt="Uni-CLI green observatory hero with one-click npm and agent prompt copy" width="100%">
  22. </p>
  23. Uni-CLI gives people and agents one command interface for websites, browsers, desktop applications, local tools, and MCP. Describe a task, inspect the selected operation, and run it to receive structured data or an actionable error.
  24. ```bash
  25. npm install -g @zenalexa/unicli
  26. unicli search "list the top Hacker News stories"
  27. unicli hackernews top --limit 3 -f json
  28. ```
  29. Check releases or open an interactive Y/N update choice.
  30. ```bash
  31. unicli upgrade --check -f json
  32. unicli upgrade
  33. ```
  34. Persistent non-interactive Agent installations update in a detached worker by default. Structured output reports progress through `meta.update.automatic_update`. Interactive terminals keep the Y/N choice, and `unicli upgrade --no-auto-update` switches a machine back to explicit approval.
  35. ## Agent Internet Access
  36. Find a source, search its records, and read native Markdown when the site provides it. Scholarly searches retain the requested source. HTTP responses carry retry and verification instructions. OpenRouter searches and paginates models on the server.
  37. Read the [access guide](docs/guide/internet-access.md) and [reproducible benchmarks](docs/BENCHMARK.md) for behavior, measured gains, and source-side limits.
  38. ## Route By Task
  39. The catalog identifies available operations and their arguments. Execution uses the declared interface and limits the action to its target. Each call runs one provider; a failure retains its original cause and repair command.
  40. | Task boundary | Execution operator | Why |
  41. | -------------------------------------- | ------------------- | ------------------------------------------------------------------- |
  42. | Public data or stable service contract | Structured API | Typed fields, explicit auth, stable provenance |
  43. | Files, system state, local tools | Local runtime | Direct process and OS boundaries without browser state |
  44. | Authenticated or private web contract | Browser protocol | Explicit profile, cookie session, or network contract |
  45. | Page-only web flow | Semantic browser | DOM and CDP semantics with an explicit target and session |
  46. | Native desktop application | Accessibility | Structured AX, UIA, or AT-SPI control trees |
  47. | Pixel-only or unstructured interface | Visual computer use | Coordinate and visual observation when no stronger interface exists |
  48. ```bash
  49. unicli search "export my saved posts" # discover and rank
  50. unicli list --site reddit # inspect one surface
  51. unicli browser doctor --json # inspect browser delivery state
  52. unicli repair reddit saved # verify a supported drift path
  53. ```
  54. ## The Operation Contract
  55. Each operation describes what it accepts, where it runs, and what it can change. Inspect that contract before sending arguments or granting approval.
  56. ```text
  57. intent → candidate operations → explicit selection → policy → substrate → receipt
  58. ```
  59. | Stage | Runtime behavior |
  60. | -------- | ------------------------------------------------------------------------------------------ |
  61. | Discover | Compiled intent and bilingual retrieval return a small ranked set with selection evidence |
  62. | Select | The caller chooses one operation with a declared strategy and substrate |
  63. | Govern | `open`, `confirm`, and `locked` profiles evaluate effect and capability scope |
  64. | Act | The selected adapter, core command, browser, desktop, or protocol path executes |
  65. | Observe | Every normal command returns a stable success or error envelope |
  66. | Repair | Owned drift paths expose their source, failed boundary, and bounded verification command |
  67. | Evolve | Recorded failures become isolated candidates that must pass paired and held-out evaluation |
  68. Uni-CLI supplies the interface runtime. The model, planner, agent loop, and sandbox remain independent choices.
  69. ## Surfaces
  70. | Surface | Current runtime |
  71. | --------- | -------------------------------------------------------------------------------------------- |
  72. | Web | Public data, cookies, headers, downloads, uploads, publishing, search, and Chinese platforms |
  73. | Browser | CDP navigation, semantic action, network, snapshots, screenshots, and post-action evidence |
  74. | Desktop | Native controls, macOS services, design tools, Office, and media applications |
  75. | Local | Subprocess bridges, files, PDF and paper workflows, media transforms, and developer CLIs |
  76. | Protocols | Native CLI, MCP stdio, MCP Streamable HTTP, ACP, generated configs, and agent skills |
  77. | Policy | Permission profiles, deny rules, scoped approvals, recordings, replay, and evidence |
  78. Static catalog
  79. - <!-- STATS:site_count -->338<!-- /STATS --> sites
  80. - <!-- STATS:command_count -->1896<!-- /STATS --> registered commands
  81. - <!-- STATS:adapter_count_total -->1269<!-- /STATS --> adapters
  82. - <!-- STATS:pipeline_step_count -->113<!-- /STATS --> pipeline actions
  83. - <!-- STATS:test_count -->10373<!-- /STATS --> tests
  84. Fixed core and host-discovered commands join at runtime.
  85. <!-- BEGIN README_SITE_GRID -->
  86. <!-- prettier-ignore -->
  87. | Surface | Sites | Operations | Examples |
  88. | --- | ---: | ---: | --- |
  89. | social | 33 | 398 | [twitter](https://olo-dot-io.github.io/Uni-CLI/reference/sites#twitter), [zhihu](https://olo-dot-io.github.io/Uni-CLI/reference/sites#zhihu), [instagram](https://olo-dot-io.github.io/Uni-CLI/reference/sites#instagram), [reddit](https://olo-dot-io.github.io/Uni-CLI/reference/sites#reddit) |
  90. | video | 8 | 76 | [tiktok](https://olo-dot-io.github.io/Uni-CLI/reference/sites#tiktok), [youtube](https://olo-dot-io.github.io/Uni-CLI/reference/sites#youtube), [bilibili](https://olo-dot-io.github.io/Uni-CLI/reference/sites#bilibili), [douyin](https://olo-dot-io.github.io/Uni-CLI/reference/sites#douyin) |
  91. | news | 11 | 45 | [hackernews](https://olo-dot-io.github.io/Uni-CLI/reference/sites#hackernews), [bloomberg](https://olo-dot-io.github.io/Uni-CLI/reference/sites#bloomberg), [bbc](https://olo-dot-io.github.io/Uni-CLI/reference/sites#bbc), [36kr](https://olo-dot-io.github.io/Uni-CLI/reference/sites#36kr) |
  92. | finance | 10 | 67 | [eastmoney](https://olo-dot-io.github.io/Uni-CLI/reference/sites#eastmoney), [xueqiu](https://olo-dot-io.github.io/Uni-CLI/reference/sites#xueqiu), [binance](https://olo-dot-io.github.io/Uni-CLI/reference/sites#binance), [coingecko](https://olo-dot-io.github.io/Uni-CLI/reference/sites#coingecko) |
  93. | shopping | 13 | 47 | [amazon](https://olo-dot-io.github.io/Uni-CLI/reference/sites#amazon), [jd](https://olo-dot-io.github.io/Uni-CLI/reference/sites#jd), [taobao](https://olo-dot-io.github.io/Uni-CLI/reference/sites#taobao), [1688](https://olo-dot-io.github.io/Uni-CLI/reference/sites#1688) |
  94. | dev | 37 | 185 | [codex](https://olo-dot-io.github.io/Uni-CLI/reference/sites#codex), [cursor](https://olo-dot-io.github.io/Uni-CLI/reference/sites#cursor), [gh](https://olo-dot-io.github.io/Uni-CLI/reference/sites#gh), [stackoverflow](https://olo-dot-io.github.io/Uni-CLI/reference/sites#stackoverflow) |
  95. | ai | 25 | 216 | [chatgpt](https://olo-dot-io.github.io/Uni-CLI/reference/sites#chatgpt), [antigravity](https://olo-dot-io.github.io/Uni-CLI/reference/sites#antigravity), [chatwise](https://olo-dot-io.github.io/Uni-CLI/reference/sites#chatwise), [notebooklm](https://olo-dot-io.github.io/Uni-CLI/reference/sites#notebooklm) |
  96. | scholarly | 30 | 105 | [openreview](https://olo-dot-io.github.io/Uni-CLI/reference/sites#openreview), [zotero](https://olo-dot-io.github.io/Uni-CLI/reference/sites#zotero), [pubmed](https://olo-dot-io.github.io/Uni-CLI/reference/sites#pubmed), [arxiv](https://olo-dot-io.github.io/Uni-CLI/reference/sites#arxiv) |
  97. | patent | 17 | 42 | [epo](https://olo-dot-io.github.io/Uni-CLI/reference/sites#epo), [espacenet](https://olo-dot-io.github.io/Uni-CLI/reference/sites#espacenet), [cipo](https://olo-dot-io.github.io/Uni-CLI/reference/sites#cipo), [cnipa](https://olo-dot-io.github.io/Uni-CLI/reference/sites#cnipa) |
  98. | reference | 12 | 47 | [marxists-cn](https://olo-dot-io.github.io/Uni-CLI/reference/sites#marxists-cn), [anilist](https://olo-dot-io.github.io/Uni-CLI/reference/sites#anilist), [bangumi](https://olo-dot-io.github.io/Uni-CLI/reference/sites#bangumi), [imdb](https://olo-dot-io.github.io/Uni-CLI/reference/sites#imdb) |
  99. | audio | 4 | 46 | [spotify](https://olo-dot-io.github.io/Uni-CLI/reference/sites#spotify), [netease-music](https://olo-dot-io.github.io/Uni-CLI/reference/sites#netease-music), [xiaoyuzhou](https://olo-dot-io.github.io/Uni-CLI/reference/sites#xiaoyuzhou), [apple-podcasts](https://olo-dot-io.github.io/Uni-CLI/reference/sites#apple-podcasts) |
  100. | content | 16 | 90 | [lesswrong](https://olo-dot-io.github.io/Uni-CLI/reference/sites#lesswrong), [danbooru](https://olo-dot-io.github.io/Uni-CLI/reference/sites#danbooru), [dlsite](https://olo-dot-io.github.io/Uni-CLI/reference/sites#dlsite), [weread](https://olo-dot-io.github.io/Uni-CLI/reference/sites#weread) |
  101. | productivity | 10 | 78 | [notion-app](https://olo-dot-io.github.io/Uni-CLI/reference/sites#notion-app), [ones](https://olo-dot-io.github.io/Uni-CLI/reference/sites#ones), [obsidian](https://olo-dot-io.github.io/Uni-CLI/reference/sites#obsidian), [quark](https://olo-dot-io.github.io/Uni-CLI/reference/sites#quark) |
  102. | jobs | 6 | 42 | [nowcoder](https://olo-dot-io.github.io/Uni-CLI/reference/sites#nowcoder), [boss](https://olo-dot-io.github.io/Uni-CLI/reference/sites#boss), [51job](https://olo-dot-io.github.io/Uni-CLI/reference/sites#51job), [linkedin](https://olo-dot-io.github.io/Uni-CLI/reference/sites#linkedin) |
  103. | desktop | 25 | 201 | [macos](https://olo-dot-io.github.io/Uni-CLI/reference/sites#macos), [freecad](https://olo-dot-io.github.io/Uni-CLI/reference/sites#freecad), [blender](https://olo-dot-io.github.io/Uni-CLI/reference/sites#blender), [gimp](https://olo-dot-io.github.io/Uni-CLI/reference/sites#gimp) |
  104. | games | 1 | 7 | [steam](https://olo-dot-io.github.io/Uni-CLI/reference/sites#steam) |
  105. | utility | 7 | 29 | [linear](https://olo-dot-io.github.io/Uni-CLI/reference/sites#linear), [bitwarden](https://olo-dot-io.github.io/Uni-CLI/reference/sites#bitwarden), [todoist](https://olo-dot-io.github.io/Uni-CLI/reference/sites#todoist), [qweather](https://olo-dot-io.github.io/Uni-CLI/reference/sites#qweather) |
  106. | other | 72 | 124 | [slay-the-spire-ii](https://olo-dot-io.github.io/Uni-CLI/reference/sites#slay-the-spire-ii), [xiaoe](https://olo-dot-io.github.io/Uni-CLI/reference/sites#xiaoe), [archive](https://olo-dot-io.github.io/Uni-CLI/reference/sites#archive), [ke](https://olo-dot-io.github.io/Uni-CLI/reference/sites#ke) |
  107. | travel | 1 | 4 | [ctrip](https://olo-dot-io.github.io/Uni-CLI/reference/sites#ctrip) |
  108. <!-- END README_SITE_GRID -->
  109. The generated [operation catalog](https://olo-dot-io.github.io/Uni-CLI/reference/sites) is the authoritative inventory.
  110. ## Use It From An Agent
  111. ### Native CLI
  112. ```bash
  113. unicli search "download the latest arXiv paper on computer use" -f json
  114. unicli arxiv search "computer use agents" --limit 5 -f json
  115. unicli --auth-retry openreview conference "ICML.cc/2026/Conference" --rpm 20 -f json
  116. unicli extract https://example.com --max-chars 1200
  117. ```
  118. Piped output defaults to Markdown. Use `-f json`, `yaml`, `csv`, or `compact` when the next step needs a stable machine format. The [OpenReview archive guide](https://olo-dot-io.github.io/Uni-CLI/guide/openreview-archive) covers authenticated, resumable conference and multi-year research archives.
  119. ### MCP
  120. ```json
  121. {
  122. "mcpServers": {
  123. "unicli": {
  124. "command": "npx",
  125. "args": ["-y", "@zenalexa/unicli-mcp"]
  126. }
  127. }
  128. }
  129. ```
  130. Equivalent command
  131. ```bash
  132. npx -y @zenalexa/unicli mcp serve
  133. ```
  134. The default profile exposes four meta-tools. Deferred and expanded profiles project adapter operations when the host needs tool-level discovery. Inspect the live projection with `unicli mcp health -f json`.
  135. ### Local Computer
  136. ```bash
  137. unicli compute apps --format compact
  138. unicli compute snapshot --app Calculator --format compact
  139. unicli compute find --app Calculator --role AXButton --title "7"
  140. unicli compute click --ref <ref-from-find>
  141. ```
  142. Desktop actions prefer accessibility references. Visual routes require an explicitly selected backend and never appear as a hidden fallback.
  143. ## Results That Explain Themselves
  144. Success
  145. ```yaml
  146. ok: true
  147. schema_version: "2"
  148. command: "hackernews.top"
  149. meta:
  150. duration_ms: 412
  151. count: 3
  152. surface: web
  153. data:
  154. - { rank: "1", title: "...", url: "...", author: "..." }
  155. error: null
  156. ```
  157. Failure
  158. ```yaml
  159. ok: false
  160. schema_version: "2"
  161. command: "reddit.saved"
  162. data: null
  163. error:
  164. code: auth_required
  165. adapter_path: "src/adapters/reddit/saved.yaml"
  166. step: 1
  167. suggestion: "Run: unicli auth setup reddit"
  168. retryable: false
  169. ```
  170. Exit codes distinguish success, empty results, unavailable dependencies, temporary failures, auth, and configuration. See the [output and exit-code reference](docs/reference/exit-codes.md).
  171. ## Repair Drift At The Owned Boundary
  172. Use the source path in an adapter error to inspect the failed operation. A local adapter can replace the packaged version during repair development.
  173. ```text
  174. run → read error.adapter_path → patch the owned step → save override → verify once
  175. ```
  176. ```bash
  177. unicli repair <site> <command>
  178. ```
  179. `repair` does not edit source or Git state. It reruns the original command as a bounded subprocess and succeeds only when the target returns `ok: true` with exit code `0`. Local overrides under `~/.unicli/adapters/` survive npm updates.
  180. For repeated failures, `evolve adapter` keeps proposal evidence, validation, and held-out cases separate. The agent supplies one isolated YAML candidate and a falsifiable prediction. Uni-CLI runs paired baseline and candidate evaluations, records prediction misses and regressions, and installs a user override only after the promotion gate passes.
  181. ```bash
  182. unicli evolve adapter <site> <command> \
  183. --run <proposal-run> \
  184. --candidate <candidate.yaml> \
  185. --hypothesis "<expected mechanism>" \
  186. --expect <validation-case-id> \
  187. --risk <held-out-case-id> \
  188. --validation <validation-eval.yaml> \
  189. --held-out <held-out-eval.yaml> \
  190. --promote
  191. ```
  192. Without `--candidate`, the command creates an editable draft. Every verification preserves its candidate snapshot, patch, and report as one hash-checked attempt. `evolve verify --promote` reuses the latest eligible attempt when the candidate is unchanged. Promotion and rollback recover after an interrupted write and serialize competing Agent processes. `evolve inspect` returns the complete attempt history, reports corrupt sessions, and `evolve rollback` restores the exact pre-promotion overlay.
  193. The first evolution scope keeps the operation identity, input and output contracts, pipeline action topology, request methods and headers, and existing subprocess invocations fixed. Same-origin endpoint and extraction repairs remain editable. A replacement network origin requires an explicit `--allow-origin <origin>` declaration when the session is created.
  194. A minimal YAML adapter follows.
  195. ```yaml
  196. site: example
  197. name: search
  198. description: Search example.com
  199. transport: http
  200. strategy: public
  201. pipeline:
  202. - fetch: { url: "https://api.example.com/search?q=${{ args.query }}" }
  203. - select: data.results
  204. - map: { title: "${{ item.title }}", url: "${{ item.url }}" }
  205. - limit: "${{ args.limit }}"
  206. args:
  207. - { name: query, type: string, required: true, positional: true }
  208. - { name: limit, type: int, default: 20 }
  209. columns: [title, url]
  210. ```
  211. Read the [adapter format](docs/ADAPTER-FORMAT.md), [pipeline reference](docs/reference/pipeline.md), and [self-repair guide](docs/guide/self-repair.md).
  212. ## Trust Boundaries
  213. - Live browser cookies remain in process memory unless the user explicitly runs `auth import` or `browser cookies`.
  214. - Browser automation uses Uni-CLI-owned profiles under `~/.unicli/`. Chrome 136+ does not support remote debugging on its default user-data directory.
  215. - `unicli browser doctor --json` reports the available delivery path and exact repair command without starting a browser provider.
  216. - Permission rules authorize before browser, file, clipboard, subprocess, or desktop side effects. Explicit malformed policies fail closed.
  217. - Visual routes require a real configured backend. Missing providers return a structured error.
  218. - Invocation diagnostics exclude arguments, content, URLs, credentials, and raw errors; users can disable new events with `UNICLI_NO_LOG=1`.
  219. Credential selection, storage paths, and recovery are explained in [Authentication](docs/guide/authentication.md). Browser visibility and desktop control are covered in [Browser and Desktop](docs/guide/browser-desktop.md).
  220. ## Development
  221. ```bash
  222. npm install
  223. npm run typecheck
  224. npm run lint
  225. npm test
  226. npm run verify # full E2E and adapter coverage; required before release
  227. ```
  228. Requires Node.js 22.19 or newer. See [CONTRIBUTING.md](CONTRIBUTING.md) for adapter and engine conventions.
  229. Browse every published version on the [generated release history](docs/releases.md). The same data is available to Agents through `docs/public/release-history.json`.
  230. <p align="center"><sub>v1.7.0 — Artemis · Moghbeli</sub></p>
  231. ## License
  232. Apache-2.0

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.