Package ReferenceCLI (Python)
CLI (Python)
Install and use the supyagent CLI to connect your account, run cloud tools, and generate skill files.
CLI (Python)
The supyagent CLI connects your terminal to Supyagent Cloud. It lets you authenticate, discover and run integration tools, manage webhook events, generate skill files for AI coding assistants, and store API keys securely.
Installation
Requires Python 3.11 or later.
pip install supyagentOr with uv:
uv pip install supyagentVerify the installation:
supyagent --versionGlobal Options
| Flag | Description |
|---|---|
--version | Print the installed version and exit |
--debug | Enable debug logging (hidden flag) |
--help | Show help for any command |
Default Behavior
Running supyagent with no subcommand shows a welcome message. If you're already connected to Supyagent Cloud, it also shows your connection status and available tools — equivalent to running supyagent status.
Commands Overview
| Command | Description |
|---|---|
connect | Link your terminal to Supyagent Cloud |
disconnect | Remove stored credentials |
status | Show connection status and available tools |
doctor | Run diagnostics on your setup |
docs | View API documentation in the terminal |
service tools | List available cloud tools |
service tools --info | Show detailed info for a specific tool |
service run | Execute a cloud tool |
inbox | View and manage webhook events |
service inbox | List inbox events (JSON-friendly) |
skills generate | Generate skill files for AI coding assistants |
config | Manage stored API keys |