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.4

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.4
File Size Uploaded Provenance Actions
uno_cli-1.0.4.tar.gz 24.2 kB Without provenance Details for uno_cli-1.0.4.tar.gz

Built distribution (wheel)

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

Total release size: 40.4 kB

Release files / uno_cli-1.0.4.tar.gz

Download URL uno_cli-1.0.4.tar.gz
Size 24.2 kB
Tags Source
SHA-256 checksum
How to use checksums
d315a8e194dee68e28410c61f0f0bda0d3d88e064fec1b7062def5662c9b6a5e
BLAKE2b-256 checksum
How to use checksums
8fbc75e2b279259d1fc239ab8eade1a7c49056de52797df5b8bc74f073cb6fb7
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.4-py3-none-any.whl

Download URL uno_cli-1.0.4-py3-none-any.whl
Size 16.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3191579361e9ba3aa3731219f53444303f68c0147fded4dd6ec70960fddd310e
BLAKE2b-256 checksum
How to use checksums
f92d94016a9cab3e75b62967c3ec0eef87bce70c6a504560a65ae3d2adc64f94
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.4

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