# Uni-CLI — Governed Software Commands + MCP for Agents

> Searchable CLI catalog (282 sites, 1680 commands) that serves governed tools to agents via MCP, with repairable adapters; verified 73★, pushed 2026-05-13.

## Install

Copy the content below into your project:

## Quick Use

```bash
npm install -g @zenalexa/unicli
unicli search "hacker news frontpage"
unicli hackernews top --limit 5 -f json
npx @zenalexa/unicli mcp serve
```

## Intro

Searchable CLI catalog (282 sites, 1680 commands) that serves governed tools to agents via MCP, with repairable adapters; verified 73★, pushed 2026-05-13.

**Best for:** Agent builders who need a governed command substrate across websites/apps/CLIs with evidence-rich outputs

**Works with:** Node 20+, npm global installs, and MCP clients (npx serve) per README

**Setup time:** 10-25 minutes

### Key facts (verified)

- GitHub: 73 stars · 0 forks · pushed 2026-05-13.
- License: Apache-2.0 · owner avatar + repo URL verified via GitHub API.
- README-backed entrypoint: `npm install -g @zenalexa/unicli`.

## Main

- Treat it as your agent substrate: search → execute → inspect evidence. Keep the outputs machine-readable (`-f json`) for downstream agents.

- Start with low-risk sites/commands and a restrictive permission profile; then expand coverage once you have auditing in place.

- Use MCP serve mode when you want to expose the catalog as tools to your agent runtime instead of shelling out directly.

- Lean on “repair” workflows: README highlights adapter repair paths so broken integrations can be fixed rather than silently failing.

### Source-backed notes

- README Start In 30 Seconds shows `npm install -g @zenalexa/unicli`, `unicli search ...`, and `npx @zenalexa/unicli mcp serve`.
- README badge line lists quantitative counts (sites/commands/pipeline steps/tests) embedded in the doc.
- README includes protocol entry points and examples for MCP serve and other modes.

### FAQ

- **Do I have to run it via MCP?**: No — README shows you can run commands directly with `unicli ...`, then add MCP serve when needed.
- **Why include counts like sites/commands?**: They help you gauge coverage; README embeds site and command counts in the header.
- **How do I keep executions safe?**: Start with restrictive permission profiles and prefer evidence-rich outputs for auditing.

## Source & Thanks

> Source: https://github.com/olo-dot-io/uni-cli
> License: Apache-2.0
> GitHub stars: 73 · forks: 0

---

<!-- ZH -->

## Quick Use

```bash
npm install -g @zenalexa/unicli
unicli search "hacker news frontpage"
unicli hackernews top --limit 5 -f json
npx @zenalexa/unicli mcp serve
```

## Intro

Uni-CLI 是面向 agent 的可搜索 CLI 目录（README 标注 282 个站点、1680 条命令），支持以 MCP 方式对外服务，并提供可修复的适配器与结构化证据输出；已验证 73★，更新于 2026-05-13。

**Best for:** 需要把网站/应用/外部 CLI 统一成“可治理的命令层”，并输出可审计证据的 agent 构建者

**Works with:** Node 20+、npm 全局安装，以及 README 所示的 MCP 接入（npx serve）

**Setup time:** 10-25 minutes

### Key facts (verified)

- GitHub：73 stars · 0 forks；最近更新 2026-05-13。
- 许可证：Apache-2.0；作者头像与仓库链接均已通过 GitHub API 复核。
- README 中可对照的入口命令：`npm install -g @zenalexa/unicli`。

## Main

- 把它当成 agent 的执行底座：先 search，再执行，再检查 evidence；需要机器消费时优先用 `-f json`。

- 从低风险命令集开始，并用更严格的 permission profile；有审计闭环后再逐步放开覆盖面。

- 需要把能力暴露给 agent runtime 时，用 MCP serve 模式比直接 shell out 更容易治理。

- 重视“可修复”流程：README 强调 adapter repair 路径，避免集成静默失败。

### Source-backed notes

- README 的 Start In 30 Seconds 给出 `npm install -g @zenalexa/unicli`、`unicli search ...` 与 `npx @zenalexa/unicli mcp serve`。
- README 在 badge/统计行中包含站点数与命令数等量化数据。
- README 给出 MCP serve 等协议入口与示例命令。

### FAQ

- **必须走 MCP 吗？**：不必须；README 同时展示了直接运行 `unicli ...` 与 MCP serve 两种路径。
- **统计数字有什么用？**：帮助判断覆盖面；README 在头部就标注了站点数与命令数。
- **如何保证执行更安全？**：从严格的 permission profile 开始，并优先使用可审计的 evidence 输出。

## Source & Thanks

> Source: https://github.com/olo-dot-io/uni-cli
> License: Apache-2.0
> GitHub stars: 73 · forks: 0


---
Source: https://tokrepo.com/en/workflows/uni-cli-governed-software-commands-mcp-for-agents
Author: Script Depot