> ## Documentation Index
> Fetch the complete documentation index at: https://docs.danubeai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Command Reference

> Complete reference for all Danube CLI commands, flags, and exit codes.

## 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 the profile, organization and role, context document counts and timezone |

## 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 (public, your organizations' and your own) |
| `danube skills get <id-or-name>` | Print skill content |
| `danube skills create <file>` | Create a skill (`--visibility internal --org <id>` to share it) |
| `danube skills upload <folder-or-zip>` | Upload a skill folder; internal by default (`--private`, `--org <id>`, `--replace` for a new version) |
| `danube skills download <id-or-name>` | Unpack a skill into `--out <dir>` (e.g. `.claude/skills`); `--zip` keeps the archive |
| `danube skills org <org-id>` | List an organization's internal skills |
| `danube skills update <id> <file>` | Update a skill |
| `danube skills delete <id>` | Delete a skill |

## Context Commands

| Command | Description |
| - | - |
| `danube context show` | Print the merged context your agents read (`--json` for documents and versions, `--no-skills` to leave out the skill index) |
| `danube context remember <text>` | Add a paragraph to a personal document (`--doc <name>`, default `notes.md`; `--replace` to overwrite; `-` reads stdin) |

## 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`

```json theme={null}
{
  "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.

```bash theme={null}
# 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
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.