Uno CLI

Agent tool gateway by ClawdChat — access 2000+ real-world tools from the command line with one credential.

Zero runtime dependencies (Python 3.8+ stdlib only). Designed for both humans in a terminal and LLM agents orchestrating tool calls.

Install

pip install uno-cli

Quick start

uno login                             # device-code auth via ClawdChat SSO
uno search "weather"                  # find a tool
uno call weather-cn.weatherArea --args '{"area":"Beijing"}'

Credentials are stored at ~/.uno/credentials.json (mode 600).

Core commands

All commands output JSON. Add --compact for single-line output (fewer tokens for LLM agents).

Environment variables

Scope enforcement for embedding skills

Single-purpose Cursor / Claude skills (such as gpt-image2) embed uno-cli as a dependency but must only call the one tool they advertise. The combination of UNO_OAUTH_SCOPE (narrowed scope at login) and UNO_ALLOWED_TOOLS (runtime glob whitelist) makes the CLI's behaviour match its declared metadata — a hard requirement for Clawhub / Skillhub security review.

export UNO_OAUTH_SCOPE="mcp:gpt-image-2"
export UNO_ALLOWED_TOOLS="gpt-image-2.*"
uno call gpt-image-2.gpt_image2_submit --args '{"prompt":"..."}'

Attempting to call anything outside the whitelist returns:

{
  "error": "tool_not_allowed",
  "tool": "github.create_issue",
  "allowed": ["gpt-image-2.*"],
  "hint": "This skill is scoped to a subset of Uno tools. Install uno-cli separately to access the full 2000+ tool catalog."
}

Python entry point

Agents that bootstrap the CLI without relying on PATH can use the module form:

python -m uno_cli search "weather"

License

MIT © ClawdChat.