@zenalexa/unicli 0.207.1 → 0.209.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zenalexa/unicli",
-  "version": "0.207.1",
-  "description": "CLI IS ALL YOU NEED — Turn any website, desktop app, cloud service, or system tool into a CLI command",
+  "version": "0.209.0",
+  "description": "The universal interface between AI agents and the world's software",
   "type": "module",
   "main": "dist/main.js",
   "bin": {
@@ -29,7 +29,8 @@
     "lint": "oxlint src/",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
-    "verify": "npm run format:check && npm run typecheck && npm run lint && npm run test && npm run build",
+    "lint:context": "bash scripts/lint-context.sh",
+    "verify": "npm run format:check && npm run typecheck && npm run lint && npm run lint:context && npm run test && npm run build",
     "docs:dev": "vitepress dev docs",
     "docs:build": "vitepress build docs",
     "docs:preview": "vitepress preview docs",
@@ -37,7 +38,7 @@
     "mcp": "tsx src/mcp/server.ts",
     "release": "npm run build && tsx scripts/release.ts",
     "bench": "tsx scripts/bench.ts",
-    "sync:ref": "cd ref && (cd opencli && git pull --rebase --depth 1) && (cd CLI-Anything && git pull --rebase --depth 1) && echo 'ref repos synced'"
+    "sync:ref": "bash scripts/sync-ref.sh"
   },
   "keywords": [
     "cli",
@@ -55,11 +56,11 @@
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/ZenAlexa/Uni-CLI.git"
+    "url": "git+https://github.com/olo-dot-io/Uni-CLI.git"
   },
-  "homepage": "https://github.com/ZenAlexa/Uni-CLI",
+  "homepage": "https://github.com/olo-dot-io/Uni-CLI",
   "bugs": {
-    "url": "https://github.com/ZenAlexa/Uni-CLI/issues"
+    "url": "https://github.com/olo-dot-io/Uni-CLI/issues"
   },
   "engines": {
     "node": ">=20.0.0"

package/src/adapters/autoagent/eval-run.yaml

@@ -0,0 +1,36 @@
+# kevinrgu/autoagent eval/run — delegate hill-climbing optimization to AutoAgent.
+# Subprocess wrapper that streams JSON results back.
+site: autoagent
+name: eval/run
+description: Run an AutoAgent evaluation (hill-climbing on agent.py)
+type: bridge
+strategy: public
+binary: autoagent
+detect: which autoagent
+
+args:
+  task:
+    type: str
+    required: true
+    positional: true
+    description: Task name or path to a YAML task spec
+  iterations:
+    type: int
+    default: 5
+    description: Max hill-climb iterations
+
+pipeline:
+  - exec:
+      command: autoagent
+      args:
+        - eval
+        - run
+        - --task
+        - ${{ args.task }}
+        - --iterations
+        - ${{ args.iterations }}
+        - --json
+      parse: json
+      timeout: 600000
+
+columns: [iteration, score, change]

package/src/adapters/cnn/top.yaml

@@ -0,0 +1,21 @@
+site: cnn
+name: top
+description: CNN top stories via RSS
+type: web-api
+domain: rss.cnn.com
+strategy: public
+args:
+  limit:
+    required: false
+    default: 20
+pipeline:
+  - fetch_text:
+      url: "http://rss.cnn.com/rss/edition.rss"
+  - parse_rss: ~
+  - map:
+      title: "${{ item.title }}"
+      url: "${{ item.link }}"
+      date: "${{ item.pubDate }}"
+      description: "${{ item.contentSnippet }}"
+  - limit: "${{ args.limit | default(20) }}"
+columns: [title, url, date]

package/src/adapters/cocoapods/search.yaml

@@ -0,0 +1,16 @@
+site: cocoapods
+name: search
+description: Search CocoaPods iOS/macOS libraries
+type: web-api
+domain: cocoapods.org
+strategy: public
+args:
+  query:
+    required: true
+    positional: true
+    description: Pod search query
+pipeline:
+  - fetch:
+      url: "https://search.cocoapods.org/api/v1/pods.picky.hash.json?query=${{ args.query }}&amount=20"
+  - select: allocations
+columns: [name, version, summary, source]

package/src/adapters/crates-io/search.yaml

@@ -0,0 +1,27 @@
+site: crates-io
+name: search
+description: Search Rust crates on crates.io
+type: web-api
+domain: crates.io
+strategy: public
+args:
+  query:
+    required: true
+    positional: true
+    description: Search keyword
+  limit:
+    required: false
+    default: 20
+pipeline:
+  - fetch:
+      url: "https://crates.io/api/v1/crates?q=${{ args.query }}&per_page=${{ args.limit | default(20) }}&sort=downloads"
+      headers:
+        User-Agent: "unicli/0.209.0 (https://github.com/olo-dot-io/Uni-CLI)"
+  - select: crates
+  - map:
+      name: "${{ item.name }}"
+      version: "${{ item.newest_version }}"
+      description: "${{ item.description }}"
+      downloads: "${{ item.downloads }}"
+  - limit: "${{ args.limit | default(20) }}"
+columns: [name, version, description, downloads]

package/src/adapters/cua/bench-list.yaml

@@ -0,0 +1,20 @@
+# trycua/cua bench/list — list available cua benchmarks.
+site: cua
+name: bench/list
+description: List trycua/cua computer-use benchmarks
+type: bridge
+strategy: public
+binary: cua
+detect: which cua
+
+pipeline:
+  - exec:
+      command: cua
+      args:
+        - bench
+        - list
+        - --json
+      parse: json
+      timeout: 30000
+
+columns: [name, description]

package/src/adapters/cua/bench-run.yaml

@@ -0,0 +1,32 @@
+# trycua/cua bench/run — run a single computer-use benchmark.
+site: cua
+name: bench/run
+description: Run a trycua/cua computer-use benchmark
+type: bridge
+strategy: public
+binary: cua
+detect: which cua
+
+args:
+  benchmark:
+    type: str
+    required: true
+    positional: true
+    description: Benchmark name from `cua bench/list`
+  agent:
+    type: str
+    required: false
+    description: Agent backend (e.g. unicli, browser-use, claude)
+
+pipeline:
+  - exec:
+      command: cua
+      args:
+        - bench
+        - run
+        - ${{ args.benchmark }}
+        - --json
+      parse: json
+      timeout: 600000
+
+columns: [task, score, duration, agent]

package/src/adapters/docker-hub/search.yaml

@@ -0,0 +1,26 @@
+site: docker-hub
+name: search
+description: Search Docker Hub images
+type: web-api
+domain: hub.docker.com
+strategy: public
+args:
+  query:
+    required: true
+    positional: true
+    description: Image search query
+  limit:
+    required: false
+    default: 20
+pipeline:
+  - fetch:
+      url: "https://hub.docker.com/v2/search/repositories/?query=${{ args.query }}&page_size=${{ args.limit | default(20) }}"
+  - select: results
+  - map:
+      name: "${{ item.repo_name }}"
+      description: "${{ item.short_description }}"
+      stars: "${{ item.star_count }}"
+      pulls: "${{ item.pull_count }}"
+      official: "${{ item.is_official }}"
+  - limit: "${{ args.limit | default(20) }}"
+columns: [name, description, stars, pulls, official]

package/src/adapters/eastmoney/hot.yaml

@@ -0,0 +1,23 @@
+site: eastmoney
+name: hot
+description: Eastmoney hot stocks (A-share volume leaders)
+type: web-api
+domain: push2.eastmoney.com
+strategy: public
+args:
+  limit:
+    required: false
+    default: 20
+pipeline:
+  - fetch:
+      url: "https://push2.eastmoney.com/api/qt/clist/get?pn=1&pz=${{ args.limit | default(20) }}&po=1&np=1&fltt=2&invt=2&fs=m:0+t:6,m:0+t:80,m:1+t:2,m:1+t:23&fields=f2,f3,f4,f5,f6,f12,f14"
+  - select: data.diff
+  - map:
+      code: "${{ item.f12 }}"
+      name: "${{ item.f14 }}"
+      price: "${{ item.f2 }}"
+      change_pct: "${{ item.f3 }}%"
+      volume: "${{ item.f5 }}"
+      amount: "${{ item.f6 }}"
+  - limit: "${{ args.limit | default(20) }}"
+columns: [code, name, price, change_pct, volume]

package/src/adapters/eastmoney/search.yaml

@@ -0,0 +1,25 @@
+site: eastmoney
+name: search
+description: Search stocks on Eastmoney
+type: web-api
+domain: searchapi.eastmoney.com
+strategy: public
+args:
+  query:
+    required: true
+    positional: true
+    description: Stock name or code (e.g. "贵州茅台" or "600519")
+  limit:
+    required: false
+    default: 10
+pipeline:
+  - fetch:
+      url: "https://searchapi.eastmoney.com/api/suggest/get?input=${{ args.query }}&type=14&count=${{ args.limit | default(10) }}"
+  - select: QuotationCodeTable.Data
+  - map:
+      code: "${{ item.Code }}"
+      name: "${{ item.Name }}"
+      market: "${{ item.MktNum }}"
+      type: "${{ item.SecurityTypeName }}"
+  - limit: "${{ args.limit | default(10) }}"
+columns: [code, name, market, type]

package/src/adapters/exchangerate/convert.yaml

@@ -0,0 +1,19 @@
+site: exchangerate
+name: convert
+description: Get exchange rates (free API, no key needed)
+type: web-api
+domain: open.er-api.com
+strategy: public
+args:
+  from:
+    required: true
+    positional: true
+    description: Base currency code (e.g. USD, EUR, CNY)
+  to:
+    required: false
+    description: Target currency (if omitted, returns all rates)
+pipeline:
+  - fetch:
+      url: "https://open.er-api.com/v6/latest/${{ args.from }}"
+  - select: rates
+columns: [currency, rate]

package/src/adapters/feishu/calendar.yaml

@@ -0,0 +1,24 @@
+site: feishu
+name: calendar
+description: List upcoming Feishu/Lark calendar events
+type: bridge
+domain: feishu-cli.com
+detect: which feishu
+strategy: public
+args:
+  days:
+    required: false
+    default: 7
+    description: Number of days to look ahead
+pipeline:
+  - exec:
+      command: feishu
+      args:
+        [
+          "calendar",
+          "events",
+          "--days",
+          "${{ args.days | default(7) }}",
+          "--json",
+        ]
+columns: [title, start, end, location, organizer]

package/src/adapters/feishu/docs.yaml

@@ -0,0 +1,17 @@
+site: feishu
+name: docs
+description: List recent Feishu/Lark documents
+type: bridge
+domain: feishu-cli.com
+detect: which feishu
+strategy: public
+args:
+  limit:
+    required: false
+    default: 20
+pipeline:
+  - exec:
+      command: feishu
+      args:
+        ["docs", "list", "--limit", "${{ args.limit | default(20) }}", "--json"]
+columns: [title, url, owner, updated_at]

package/src/adapters/feishu/send.yaml

@@ -0,0 +1,29 @@
+site: feishu
+name: send
+description: Send a message via Feishu/Lark CLI
+type: bridge
+domain: feishu-cli.com
+detect: which feishu
+strategy: public
+args:
+  chat:
+    required: true
+    positional: true
+    description: Chat ID or group name
+  message:
+    required: true
+    description: Message content
+pipeline:
+  - exec:
+      command: feishu
+      args:
+        [
+          "messenger",
+          "send",
+          "--chat",
+          "${{ args.chat }}",
+          "--text",
+          "${{ args.message }}",
+          "--json",
+        ]
+columns: [message_id, chat_id, status]

package/src/adapters/feishu/tasks.yaml

@@ -0,0 +1,24 @@
+site: feishu
+name: tasks
+description: List Feishu/Lark tasks
+type: bridge
+domain: feishu-cli.com
+detect: which feishu
+strategy: public
+args:
+  status:
+    required: false
+    default: open
+    description: Task status filter (open, completed, all)
+pipeline:
+  - exec:
+      command: feishu
+      args:
+        [
+          "tasks",
+          "list",
+          "--status",
+          "${{ args.status | default('open') }}",
+          "--json",
+        ]
+columns: [title, assignee, due_date, status]

package/src/adapters/gitee/search.yaml

@@ -0,0 +1,25 @@
+site: gitee
+name: search
+description: Search repositories on Gitee
+type: web-api
+domain: gitee.com
+strategy: public
+args:
+  query:
+    required: true
+    positional: true
+    description: Search keyword
+  limit:
+    required: false
+    default: 20
+pipeline:
+  - fetch:
+      url: "https://gitee.com/api/v5/search/repositories?q=${{ args.query }}&page=1&per_page=${{ args.limit | default(20) }}&sort=stars_count&order=desc"
+  - map:
+      name: "${{ item.full_name }}"
+      description: "${{ item.description }}"
+      stars: "${{ item.stargazers_count }}"
+      language: "${{ item.language }}"
+      url: "${{ item.html_url }}"
+  - limit: "${{ args.limit | default(20) }}"
+columns: [name, description, stars, language]

package/src/adapters/gitee/trending.yaml

@@ -0,0 +1,22 @@
+site: gitee
+name: trending
+description: Trending repositories on Gitee
+type: web-api
+domain: gitee.com
+strategy: public
+args:
+  limit:
+    required: false
+    default: 20
+pipeline:
+  - fetch:
+      url: "https://gitee.com/api/v5/projects?sort=stars_count&direction=desc&page=1&per_page=${{ args.limit | default(20) }}"
+  - map:
+      name: "${{ item.full_name }}"
+      description: "${{ item.description }}"
+      stars: "${{ item.stargazers_count }}"
+      forks: "${{ item.forks_count }}"
+      language: "${{ item.language }}"
+      url: "${{ item.html_url }}"
+  - limit: "${{ args.limit | default(20) }}"
+columns: [name, description, stars, language, url]

package/src/adapters/gitlab/search.yaml

@@ -0,0 +1,24 @@
+site: gitlab
+name: search
+description: Search GitLab projects
+type: web-api
+domain: gitlab.com
+strategy: public
+args:
+  query:
+    required: true
+    positional: true
+    description: Search keyword
+  limit:
+    required: false
+    default: 20
+pipeline:
+  - fetch:
+      url: "https://gitlab.com/api/v4/search?scope=projects&search=${{ args.query }}&per_page=${{ args.limit | default(20) }}"
+  - map:
+      name: "${{ item.path_with_namespace }}"
+      description: "${{ item.description }}"
+      stars: "${{ item.star_count }}"
+      url: "${{ item.web_url }}"
+  - limit: "${{ args.limit | default(20) }}"
+columns: [name, description, stars, url]

package/src/adapters/gitlab/trending.yaml

@@ -0,0 +1,22 @@
+site: gitlab
+name: trending
+description: Trending/popular GitLab projects
+type: web-api
+domain: gitlab.com
+strategy: public
+args:
+  limit:
+    required: false
+    default: 20
+pipeline:
+  - fetch:
+      url: "https://gitlab.com/api/v4/projects?order_by=star_count&sort=desc&per_page=${{ args.limit | default(20) }}"
+  - map:
+      name: "${{ item.path_with_namespace }}"
+      description: "${{ item.description }}"
+      stars: "${{ item.star_count }}"
+      forks: "${{ item.forks_count }}"
+      language: "${{ item.language }}"
+      url: "${{ item.web_url }}"
+  - limit: "${{ args.limit | default(20) }}"
+columns: [name, description, stars, language, url]

package/src/adapters/godot/project-run.yaml

@@ -0,0 +1,31 @@
+# Godot project/run — run a project headlessly with optional script.
+site: godot
+name: project/run
+description: Run a Godot project in headless mode
+type: desktop
+strategy: public
+binary: godot
+detect: which godot
+
+args:
+  project:
+    type: str
+    required: true
+    positional: true
+    description: Path to project directory or project.godot file
+  script:
+    type: str
+    required: false
+    description: Optional GDScript file to run as main scene
+
+pipeline:
+  - exec:
+      command: godot
+      args:
+        - --headless
+        - --path
+        - ${{ args.project }}
+      parse: text
+      timeout: 60000
+
+columns: [output]

package/src/adapters/godot/scene-export.yaml

@@ -0,0 +1,39 @@
+# Godot scene/export — export a scene to a known format via godot --headless.
+# Closes the v0.208 coverage gap with CLI-Anything's Godot harness.
+site: godot
+name: scene/export
+description: Export a Godot scene to PNG / GLTF / DAE via headless mode
+type: desktop
+strategy: public
+binary: godot
+detect: which godot
+
+args:
+  project:
+    type: str
+    required: true
+    positional: true
+    description: Path to project directory or project.godot file
+  scene:
+    type: str
+    required: true
+    description: Scene path within the project (e.g. res://Main.tscn)
+  output:
+    type: str
+    required: true
+    description: Output file path
+
+pipeline:
+  - exec:
+      command: godot
+      args:
+        - --headless
+        - --path
+        - ${{ args.project }}
+        - --export-pack
+        - ${{ args.scene }}
+        - ${{ args.output }}
+      parse: text
+      timeout: 120000
+
+columns: [output]

package/src/adapters/hermes/sessions-search.yaml

@@ -0,0 +1,61 @@
+# NousResearch/hermes-agent sessions/search — query Hermes session FTS.
+# Hermes stores session history in a SQLite database at ~/.hermes/sessions.db.
+#
+# Security:
+#   - `args.query` is passed via env var UNICLI_QUERY (bash literal, no shell injection)
+#   - Single quotes in the query are doubled (`'` → `''`) via bash parameter
+#     expansion before being injected into the SQL string literal — this is
+#     the standard SQL string-literal escape. FTS5 MATCH still interprets its
+#     own query grammar (e.g. `OR`, `*`) as FTS operators, which is
+#     intentional for search.
+#   - `args.limit` is typed int in adapter args; bash strips non-digits as
+#     a belt-and-suspenders guard to keep LIMIT clause integer-only.
+site: hermes
+name: sessions/search
+description: Search Hermes session history via SQLite FTS5
+type: desktop
+strategy: public
+binary: sh
+detect: test -f ~/.hermes/sessions.db
+
+args:
+  query:
+    type: str
+    required: true
+    positional: true
+    description: FTS5 query string
+  limit:
+    type: int
+    default: 20
+    description: Max rows
+
+pipeline:
+  - exec:
+      command: sh
+      args:
+        - -c
+        - |
+          db="$HOME/.hermes/sessions.db"
+          if [ ! -f "$db" ]; then
+            echo "[]"
+            exit 0
+          fi
+          # SQL-escape single quotes: ' -> ''
+          q=${UNICLI_QUERY//\'/\'\'}
+          # Force integer on limit (strip non-digits)
+          lim=${UNICLI_LIMIT//[^0-9]/}
+          : "${lim:=20}"
+          # Try FTS5 table first; fall back to LIKE if FTS table is missing
+          sqlite3 -json "$db" \
+            "SELECT id, ts, snippet(sessions_fts, -1, '<b>', '</b>', '...', 16) AS snippet FROM sessions_fts WHERE sessions_fts MATCH '$q' LIMIT $lim;" \
+            2>/dev/null \
+          || sqlite3 -json "$db" \
+            "SELECT id, ts, substr(content, 1, 200) AS snippet FROM sessions WHERE content LIKE '%$q%' LIMIT $lim;" \
+            2>/dev/null \
+          || echo "[]"
+      env:
+        UNICLI_QUERY: "${{ args.query }}"
+        UNICLI_LIMIT: "${{ args.limit }}"
+      parse: json
+
+columns: [id, ts, snippet]

package/src/adapters/hermes/skills-list.yaml

@@ -0,0 +1,30 @@
+# NousResearch/hermes-agent skills/list — read on-disk skill files.
+# Hermes stores agent skills as markdown under ~/.hermes/skills/
+#
+# Security note: no user input, so no injection surface. Uses `find`
+# directly with argv (no shell interpolation).
+site: hermes
+name: skills/list
+description: List skills installed in the local Hermes agent (~/.hermes/skills/)
+type: desktop
+strategy: public
+binary: sh
+detect: test -d ~/.hermes/skills
+
+pipeline:
+  - exec:
+      command: sh
+      args:
+        - -c
+        - |
+          dir="$HOME/.hermes/skills"
+          if [ ! -d "$dir" ]; then
+            echo "[]"
+            exit 0
+          fi
+          find "$dir" -maxdepth 1 -name '*.md' -type f 2>/dev/null \
+            | sed "s|$dir/||" \
+            | jq -R -s 'split("\n") | map(select(length > 0)) | map({name: .})'
+      parse: json
+
+columns: [name]