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

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