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
| 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.