# Uni-CLI

Uni-CLI is the CLI-native command surface for AI agents to discover, run, and repair operations across websites, desktop apps, local tools, external CLIs, and agent backends.

## Catalog Snapshot

- Sites: 235
- Commands: 1448
- Adapters: 1039 (917 YAML + 122 TypeScript)
- Pipeline steps: 59
- Tests: 7396

## Agent Contract

- Start with `unicli search "your intent"`, then run `unicli <site> <command> [args]`.
- Prefer `-f json` for scripts and `-f md` for agent-readable prose.
- On failure, read the v2 error envelope, open `error.adapter_path`, patch the YAML, then run `unicli repair <site> <command>`.
- MCP and ACP are compatibility gateways; the native contract is a shell command plus a structured AgentEnvelope.

## Markdown Companions

Every public page below has a clean Markdown companion. Fetch Markdown first; fetch rendered HTML only when visual layout matters.

## Start

- [Overview](https://olo-dot-io.github.io/Uni-CLI/) — overview, install path, capability map, and agent entry points. Markdown: https://olo-dot-io.github.io/Uni-CLI/markdown/index.md
- [Getting Started](https://olo-dot-io.github.io/Uni-CLI/guide/getting-started) — start page for getting started. Markdown: https://olo-dot-io.github.io/Uni-CLI/markdown/guide/getting-started.md
- [Integrations](https://olo-dot-io.github.io/Uni-CLI/guide/integrations) — start page for integrations. Markdown: https://olo-dot-io.github.io/Uni-CLI/markdown/guide/integrations.md
- [Recipes](https://olo-dot-io.github.io/Uni-CLI/RECIPES) — start page for recipes. Markdown: https://olo-dot-io.github.io/Uni-CLI/markdown/RECIPES.md

## Guides

- [Guide Index](https://olo-dot-io.github.io/Uni-CLI/guide/) — guides page for guide index. Markdown: https://olo-dot-io.github.io/Uni-CLI/markdown/guide.md
- [Adapters](https://olo-dot-io.github.io/Uni-CLI/guide/adapters) — guides page for adapters. Markdown: https://olo-dot-io.github.io/Uni-CLI/markdown/guide/adapters.md
- [Self-Repair](https://olo-dot-io.github.io/Uni-CLI/guide/self-repair) — guides page for self-repair. Markdown: https://olo-dot-io.github.io/Uni-CLI/markdown/guide/self-repair.md

## Reference

- [Reference Index](https://olo-dot-io.github.io/Uni-CLI/reference/) — reference page for reference index. Markdown: https://olo-dot-io.github.io/Uni-CLI/markdown/reference.md
- [Sites Catalog](https://olo-dot-io.github.io/Uni-CLI/reference/sites) — reference page for sites catalog. Markdown: https://olo-dot-io.github.io/Uni-CLI/markdown/reference/sites.md
- [Adapter Format](https://olo-dot-io.github.io/Uni-CLI/ADAPTER-FORMAT) — reference page for adapter format. Markdown: https://olo-dot-io.github.io/Uni-CLI/markdown/ADAPTER-FORMAT.md
- [Pipeline Steps](https://olo-dot-io.github.io/Uni-CLI/reference/pipeline) — reference page for pipeline steps. Markdown: https://olo-dot-io.github.io/Uni-CLI/markdown/reference/pipeline.md
- [Exit Codes](https://olo-dot-io.github.io/Uni-CLI/reference/exit-codes) — reference page for exit codes. Markdown: https://olo-dot-io.github.io/Uni-CLI/markdown/reference/exit-codes.md
- [Maintenance Tools](https://olo-dot-io.github.io/Uni-CLI/reference/maintenance) — reference page for maintenance tools. Markdown: https://olo-dot-io.github.io/Uni-CLI/markdown/reference/maintenance.md
- [Plugin Authoring](https://olo-dot-io.github.io/Uni-CLI/PLUGIN) — reference page for plugin authoring. Markdown: https://olo-dot-io.github.io/Uni-CLI/markdown/PLUGIN.md
- [Release](https://olo-dot-io.github.io/Uni-CLI/reference/release) — reference page for release. Markdown: https://olo-dot-io.github.io/Uni-CLI/markdown/reference/release.md

## Explanation

- [Architecture](https://olo-dot-io.github.io/Uni-CLI/ARCHITECTURE) — explanation page for architecture. Markdown: https://olo-dot-io.github.io/Uni-CLI/markdown/ARCHITECTURE.md
- [Benchmarks](https://olo-dot-io.github.io/Uni-CLI/BENCHMARK) — explanation page for benchmarks. Markdown: https://olo-dot-io.github.io/Uni-CLI/markdown/BENCHMARK.md
- [Theory](https://olo-dot-io.github.io/Uni-CLI/THEORY) — explanation page for theory. Markdown: https://olo-dot-io.github.io/Uni-CLI/markdown/THEORY.md
- [Roadmap](https://olo-dot-io.github.io/Uni-CLI/ROADMAP) — explanation page for roadmap. Markdown: https://olo-dot-io.github.io/Uni-CLI/markdown/ROADMAP.md

## Full Context

- [llms-full.txt](https://olo-dot-io.github.io/Uni-CLI/llms-full.txt) — concatenated public docs in Markdown for agents that can afford the context.