npm install -g @zenalexa/unicli
unicli search "list the top Hacker News stories"
unicli hackernews top --limit 3 -f json
Check releases or open an interactive Y/N update choice.
unicli upgrade --check -f json
unicli upgrade
Persistent non-interactive Agent installations update in a detached worker by default. Structured output reports progress through . Interactive terminals keep the Y/N choice, and switches a machine back to explicit approval.
Give agents every interface—install once to search, run, inspect, and repair real software across APIs, browsers, desktops, local tools, and MCP.
2026-11-16
Estrelas
—
Ferramentas
—
Disponibilidade
—
meta.update.automatic_update
unicli upgrade --no-auto-update
Agent Internet Access
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.
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.
Task boundary
Execution operator
Why
Public data or stable service contract
Structured API
Typed fields, explicit auth, stable provenance
Files, system state, local tools
Local runtime
Direct process and OS boundaries without browser state
Authenticated or private web contract
Browser protocol
Explicit profile, cookie session, or network contract
Page-only web flow
Semantic browser
DOM and CDP semantics with an explicit target and session
Native desktop application
Accessibility
Structured AX, UIA, or AT-SPI control trees
Pixel-only or unstructured interface
Visual computer use
Coordinate and visual observation when no stronger interface exists
unicli search "export my saved posts" # discover and rank
unicli list --site reddit # inspect one surface
unicli browser doctor --json # inspect browser delivery state
unicli repair reddit saved # verify a supported drift path
The Operation Contract
Each operation describes what it accepts, where it runs, and what it can change. Inspect that contract before sending arguments or granting approval.
unicli search "download the latest arXiv paper on computer use" -f json
unicli arxiv search "computer use agents" --limit 5 -f json
unicli --auth-retry openreview conference "ICML.cc/2026/Conference" --rpm 20 -f json
unicli extract https://example.com --max-chars 1200
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 covers authenticated, resumable conference and multi-year research archives.
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.
Exit codes distinguish success, empty results, unavailable dependencies, temporary failures, auth, and configuration. See the output and exit-code reference.
Repair Drift At The Owned Boundary
Use the source path in an adapter error to inspect the failed operation. A local adapter can replace the packaged version during repair development.
run → read error.adapter_path → patch the owned step → save override → verify once
unicli repair <site> <command>
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.
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.
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.
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.
Live browser cookies remain in process memory unless the user explicitly runs auth import or browser cookies.
Browser automation uses Uni-CLI-owned profiles under ~/.unicli/. Chrome 136+ does not support remote debugging on its default user-data directory.
unicli browser doctor --json reports the available delivery path and exact repair command without starting a browser provider.
Permission rules authorize before browser, file, clipboard, subprocess, or desktop side effects. Explicit malformed policies fail closed.
Visual routes require a real configured backend. Missing providers return a structured error.
Invocation diagnostics exclude arguments, content, URLs, credentials, and raw errors; users can disable new events with UNICLI_NO_LOG=1.
Credential selection, storage paths, and recovery are explained in Authentication. Browser visibility and desktop control are covered in Browser and Desktop.
Development
npm install
npm run typecheck
npm run lint
npm test
npm run verify # full E2E and adapter coverage; required before release
Requires Node.js 22.19 or newer. See CONTRIBUTING.md for adapter and engine conventions.
Browse every published version on the generated release history. The same data is available to Agents through docs/public/release-history.json.
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Perguntas
Como instalo @zenalexa/unicli?
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
@zenalexa/unicli precisa de uma chave de API?
Este registro não lista nenhuma variável de ambiente obrigatória.
Qual transporte @zenalexa/unicli usa?
@zenalexa/unicli roda localmente via stdio.
Quando @zenalexa/unicli foi verificado pela última vez?
Última verificação: 2026-11-16. Give agents every interface—install once to search, run, inspect, and repair real software across APIs, browsers, desktops, local tools, and MCP.