Core Commands
| Command | Description |
|---|---|
danube search <query> | Find tools via semantic search |
danube execute <tool> -d <data> | Run a tool |
danube connect <service> | Authenticate to a service (id, slug or exact name; --dry-run to preview) |
Account Commands
| Command | Description |
|---|---|
danube login | Authenticate via device code |
danube login --api-key YOUR_API_KEY | Save an existing API key |
danube logout | Remove stored credentials |
danube whoami | Show current identity |
Tools Commands
| Command | Description |
|---|---|
danube tools info <tool> | Tool details + parameter schema |
danube tools list [service] | List tools, optionally for one service (id, slug or exact name) |
danube tools search <query> | Search for tools |
danube tools batch <file> | Batch execute from JSON file |
danube tools rate <tool> <1-5> | Rate a tool |
danube tools ratings <tool> | View tool ratings |
danube tools report <tool> | Report a broken tool |
danube tools recommend <tool> | Get recommendations |
Services Commands
| Command | Description |
|---|---|
danube services list [query] | List/search services |
danube services info <service> | Service details (id, slug or exact name) |
danube services tools <service> | List tools for a service (id, slug or exact name) |
Workflows Commands
| Command | Description |
|---|---|
danube workflows list [query] | List workflows |
danube workflows info <id> | Workflow details |
danube workflows run <id> -d <data> | Execute a workflow |
danube workflows status <execution-id> | Check execution status |
danube workflows create <file> | Create from spec file |
danube workflows update <id> <file> | Update from spec file |
danube workflows delete <id> | Delete a workflow |
Skills Commands
| Command | Description |
|---|---|
danube skills search <query> | Find skills |
danube skills get <id-or-name> | Print skill content |
danube skills create <file> | Create a skill |
danube skills update <id> <file> | Update a skill |
danube skills delete <id> | Delete a skill |
Wallet Commands
| Command | Description |
|---|---|
danube wallet balance | Show credit balance |
danube wallet transactions | Transaction history |
danube wallet limits | View spending limits |
danube wallet set-limits | Update spending limits |
Agent Commands
| Command | Description |
|---|---|
danube agent register <name> <email> | Register an autonomous agent |
danube agent info | Show agent info and wallet |
danube agent fund | Fund agent wallet |
API Keys Commands
| Command | Description |
|---|---|
danube keys list | List API keys |
danube keys create <name> | Create new key |
danube keys rotate <key-id> | Rotate key material |
danube keys revoke <key-id> | Revoke key |
Config Commands
| Command | Description |
|---|---|
danube config set <key> <value> | Set config value |
danube config get <key> | Get config value |
danube config profiles | List profiles |
Global Flags
| Flag | Description |
|---|---|
--human | Force human-readable output |
--json | Force machine-readable JSON output |
--api-key <key> | Override API key |
--profile <name> | Use named profile |
-v, --verbose | Verbose output |
-q, --quiet | Suppress non-essential output |
--no-color | Disable colored output |
--version | Show version |
Exit Codes
| Code | Meaning | Agent Action |
|---|---|---|
0 | Success | Parse stdout |
1 | Error | Read stderr for details |
2 | Authentication failure | Run danube login or danube connect |
3 | Rate limited | Wait and retry |
4 | Insufficient funds | Alert user |
130 | Interrupted (Ctrl+C) | — |
Environment Variables
| Variable | Description |
|---|---|
DANUBE_API_KEY | API key (overrides config file) |
DANUBE_API_URL | Base URL (default: https://api.danubeai.com) |
Config File
Location:~/.danube/config.json
{
"profiles": {
"default": {
"api_key": "YOUR_API_KEY"
},
"work": {
"api_key": "YOUR_API_KEY"
}
}
}
Output Format
Default: Human-readable tables and colors when running in a terminal (TTY). JSON when piped or redirected.# Human-readable (default in terminal)
danube search "send email"
# Force JSON output (for scripts)
danube search "send email" --json
# Force human output (e.g. when piping)
danube search "send email" --human