Neura Market
olo-dot-io/Uni-CLI logo

olo-dot-io/Uni-CLI

Free

自修复 CLI 目录，将网页、桌面应用、Electron 应用、外部 CLI 作为确定性命令通过一个 MCP 服务器暴露给 AI 代理；声明式 YAML 适配器加结构化错误信封，调用失败时代理可直接编辑 YAML 并重试。

FreeFree tier
Type
Open Source
Visit Website GitHub (40 stars)

About olo-dot-io/Uni-CLI

Uni-CLI is an open-source Agent-Computer Interface runtime that provides a unified boundary between AI agents and real software, including websites, logged-in browsers, desktop applications, local tools, files, operating-system services, and agent protocols. It exposes a cataloged operation set via a single MCP server, ranks operations by intent, executes them under policy through declared software substrates (e.g., API, CLI, browser CDP, macOS AX), and wraps results in a stable AgentEnvelope (success or structured error) that supports self-repair – agents can inspect specific failure steps, edit the declarative YAML adapters, and retry. The tool supports native CLI, MCP, ACP, JSON/Markdown envelopes, visual fallback, and includes over 324 static adapter surfaces with 9816 tests.

Key Features

Intent-based operation ranking and selection from a searchable catalog
Declarative YAML adapters for defining software substrates and operations
Structured AgentEnvelope v2 with distinct success/error envelopes supporting self-repair
Native CLI, MCP, ACP, and JSON/Markdown envelope protocols
Browser CDP integration for automated logged-in browser interactions
macOS desktop AX (Accessibility API) for desktop application control
Visual fallback strategy for environments without direct interface access
Over 324 static adapter surfaces and 9816 tests for reliability
Single npm install and run – `npm install -g @zenalexa/unicli`
Commands: `unicli do`, `unicli extract`, `unicli compute snapshot`, `unicli mcp serve`

Pros & Cons

Pros
  • Open source (MIT license) and free to use
  • Self-repair capability – agents can diagnose and fix failures using structured error envelopes
  • Broad interface coverage: websites, browsers, desktop apps, local tools, and protocols
  • Declarative YAML configuration makes adapters easy to inspect and modify
  • Large test suite (9816 tests) and modular design for reliability
  • Supports multiple agent protocols (CLI, MCP, ACP) and output formats (JSON, Markdown)
Cons
  • Requires knowledge of YAML and adapter structure for customizations
  • Primarily designed for agent use; may have limited utility for human users directly
  • macOS desktop AX support currently limited to macOS only
  • Setup involves understanding MCP server configuration and adapter registration

Best For

Enabling AI agents to autonomously interact with web applications via logged-in browsersAutomating desktop application tasks through macOS Accessibility APIProviding a unified command interface for agents to manage local tools, files, and OS servicesBuilding self-repairing automation pipelines where agents can debug and retry failed operationsIntegrating AI agents with enterprise software through MCP protocol adapters

FAQ

What is Uni-CLI?
Uni-CLI is an open-source runtime that acts as a boundary between AI agents and real software, exposing websites, logged-in browsers, desktop apps, local tools, files, and OS services as deterministic commands through a single MCP server.
How does Uni-CLI handle failures?
It uses AgentEnvelope v2 structured error envelopes that name the owned source, failed step, retryability, alternatives, and next repair command. Agents can then edit the declarative YAML adapter and retry the operation.
How do I install Uni-CLI?
Install globally via npm: `npm install -g @zenalexa/unicli`. Then run commands like `unicli do "find the Hacker News frontpage"` or `npx @zenalexa/unicli mcp serve`.
What interfaces does Uni-CLI support?
It supports native CLI, MCP, ACP, JSON/Markdown envelopes, browser CDP, visual fallback, macOS desktop Accessibility API, and over 324 static adapter surfaces.
Is Uni-CLI free?
Yes, Uni-CLI is open source and completely free to use.