Integrations

Uni-CLI is designed to be called directly from a shell. Agent clients that need a protocol server can use the same catalog over MCP or ACP without changing adapter behavior.

Choose A Path

Client need	Use
Any agent can run shell commands	Native unicli CLI
Tool-calling clients that speak MCP	unicli mcp serve
Editor clients that speak ACP	unicli acp
Platform-specific setup	unicli agents generate

Prefer the native CLI when the agent has shell access. It keeps discovery lazy, outputs compact, and preserves Unix composition.

Native CLI

unicli search "hacker news frontpage"
unicli hackernews top --limit 5 -f json

Add this short contract to AGENTS.md, CLAUDE.md, or the equivalent agent context file:

Use `unicli search "intent"` before choosing a command. Run commands as
`unicli SITE COMMAND [args]`. Prefer `-f json` for scripts and structured
Markdown for human-readable agent output.

MCP

Start a stdio server:

npx @zenalexa/unicli mcp serve

Start a Streamable HTTP server:

npx @zenalexa/unicli mcp serve --transport streamable --port 19826

SSE compatibility:

npx @zenalexa/unicli mcp serve --transport sse --port 19826

Remote deployments can enable OAuth 2.1 PKCE:

npx @zenalexa/unicli mcp serve --transport streamable --port 19826 --auth

Default MCP tools:

Tool	Purpose
unicli_search	Search commands by natural-language intent.
unicli_run	Run a selected site command.
unicli_list	List sites and commands.
unicli_explore	Inspect a page before authoring an adapter.

Claude-style stdio config:

{
  "mcpServers": {
    "unicli": {
      "command": "npx",
      "args": ["@zenalexa/unicli", "mcp", "serve"]
    }
  }
}

Codex CLI config:

[mcp_servers.unicli]
command = "npx"
args = ["@zenalexa/unicli", "mcp", "serve"]

ACP

ACP is an editor compatibility path for clients such as avante.nvim and Zed. Use MCP when the client needs structured tool calls; use ACP when the client expects prompt/session frames.

unicli acp

Minimal avante.nvim provider:

require("avante").setup({
  providers = {
    {
      name = "unicli",
      command = "unicli",
      args = { "acp" },
      type = "acp",
    },
  },
})

ACP prompts should include an explicit command:

Show the top 10 HN posts:
unicli hackernews top --limit 10

Agent Platform Recipes

Generate config where possible instead of hand-writing it:

unicli agents matrix
unicli agents recommend codex
unicli agents generate --for claude
unicli agents generate --for codex
unicli agents generate --for opencode

Manual examples:

# Claude Code MCP
claude mcp add unicli -- npx @zenalexa/unicli mcp serve

// OpenCode
{
  "mcp": {
    "unicli": {
      "type": "local",
      "command": ["npx", "-y", "@zenalexa/unicli", "mcp", "serve"],
      "enabled": true,
    },
  },
}

# Hermes Agent
mcp_servers:
  unicli:
    command: "npx"
    args: ["-y", "@zenalexa/unicli", "mcp", "serve"]

Auth

All integration paths use the same local credentials as the CLI:

unicli auth setup SITE
unicli auth check SITE

Cookie path:

~/.unicli/cookies/SITE.json

Verify

unicli list
unicli search "hacker news frontpage"
unicli hackernews top --limit 5