Skip to main content

Uno CLI

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

PyPI Python License

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

Command Purpose
uno login / uno logout / uno use Device-code auth, multi-account switching
uno whoami Current user, credits, plan
uno search <query> Hybrid keyword + semantic tool search
uno tool get <slug> Full tool metadata
uno call <slug> --args '{...}' Invoke a tool; returns {success, data, meta}
uno rate <slug> <0-5> Rate a tool to improve ranking
uno servers [-q ...] Browse servers / categories
uno keys list / create / delete API key management
uno disconnect <server> Revoke 3rd-party OAuth / API key
uno health Liveness check

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

Environment variables

Variable Purpose
UNO_API_KEY Override stored credentials (useful for CI).
UNO_API_URL Override API base URL (default https://agentools.uno; legacy host https://clawdtools.uno still serves /v1 and /mcp).
UNO_OAUTH_SCOPE OAuth scope requested at login --start (default mcp:*). Single-purpose skills narrow this to mcp:<tool>.
UNO_ALLOWED_TOOLS Comma-separated glob whitelist enforced by uno call. Tools not matching any pattern are rejected with tool_not_allowed. Example: gpt-image-2.*,time.*.
UNO_CALLER_SKILL Identifier (e.g. gpt-image2) appended to the User-Agent for attribution.

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.

Metadata

Release files for uno-cli 1.0.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for uno-cli 1.0.5
File Size Uploaded Provenance Actions
uno_cli-1.0.5.tar.gz 27.9 kB Without provenance Details for uno_cli-1.0.5.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for uno-cli 1.0.5
File Interpreter ABI Platform Actions
uno_cli-1.0.5-py3-none-any.whl Python 3 none any Details for uno_cli-1.0.5-py3-none-any.whl

Total release size: 46.7 kB

Release files / uno_cli-1.0.5.tar.gz

Download URL uno_cli-1.0.5.tar.gz
Size 27.9 kB
Tags Source
SHA-256 checksum
How to use checksums
b8cae2d4b6ff72597f7a81dd50a550dc75c095a1f6f3fab8ef137f3beb22bd48
BLAKE2b-256 checksum
How to use checksums
10213d7718a5a12ca5da492425beeaf9d67f805c0b8df44c87f8d1953175995f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.9

Release files / uno_cli-1.0.5-py3-none-any.whl

Download URL uno_cli-1.0.5-py3-none-any.whl
Size 18.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
68c0c76628dfeb24642997a8638e56ea632bc1aa519a0d624577fc7d3cec7cde
BLAKE2b-256 checksum
How to use checksums
27c7b7187e7c8fdedd852f75df41ecc08fa71a55ab1e2385db681ecc38f1d33c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.9

Security for uno-cli 1.0.5

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page