# Command reference
URL: https://docs.datarobot.com/en/docs/agentic-ai/cli/commands/index.html

> Complete reference documentation for all DataRobot CLI commands.

# Command reference

Complete reference documentation for all DataRobot CLI commands.

## Global flags

These flags are available for all commands:

```
  -v, --verbose       Enable verbose output (info level logging)
      --debug         Enable debug output (debug level logging)
      --skip-auth     Skip authentication checks (for advanced users)
      --force-interactive  Force the setup wizard to run even if already completed
  -h, --help          Show help information
```

Warning: The `--skip-auth` flag is intended for advanced use cases only. Using this flag will bypass all authentication checks, which may cause API calls to fail. Use with caution.

Note: The `--force-interactive` flag forces commands to behave as if setup has never been completed, while still updating the state file. This is useful for testing or forcing re-execution of setup steps.

For more on these flags from a configuration perspective, see [Configuration - Advanced flags](https://docs.datarobot.com/en/docs/agentic-ai/cli/configuration.html#advanced-flags) and [Getting started - Getting help](https://docs.datarobot.com/en/docs/agentic-ai/cli/getting-started.html#getting-help).

## Choosing commands

- dr start — Use for first-time setup or quickstart: runs task start if present, then a quickstart script from .datarobot/cli/bin/ , or falls back to the template setup wizard. Best when you want one command to "get running."
- dr run <task> — Use to run specific tasks (e.g., dr run dev , dr run test ). Use when you already have a template and want to execute a single task.
- dr task list — Lists all available tasks. Use when you want to see what tasks a template provides.
- dr task compose — Composes a unified Taskfile from component Taskfiles. Use when developing or customizing templates that use multiple Taskfiles.

## Commands

### Main commands

| Command | Description |
| --- | --- |
| auth | Authenticate with DataRobot. |
| templates | Manage application templates. |
| start | Run the application quickstart process. |
| run | Execute application tasks. |
| task | Manage Taskfile composition and task execution. |
| dotenv | Manage environment variables. |
| self | CLI utility commands (update, version, completion). |

### Command tree

```
dr
├── auth                Authentication management
│   ├── login          Log in to DataRobot
│   ├── logout         Log out from DataRobot
│   └── set-url        Set DataRobot URL
├── templates          Template management
│   ├── list           List available templates
│   ├── clone          Clone a template
│   ├── setup          Interactive setup wizard
│   └── status         Show template status
├── start              Run quickstart process (alias: quickstart)
├── run                Task execution
├── task               Taskfile composition and execution
│   ├── compose        Compose unified Taskfile
│   ├── list           List available tasks
│   └── run            Execute tasks
├── dotenv             Environment configuration
└── self               CLI utility commands
    ├── completion     Shell completion
    │   ├── bash       Generate bash completion
    │   ├── zsh        Generate zsh completion
    │   ├── fish       Generate fish completion
    │   └── powershell Generate PowerShell completion
    ├── config         Display configuration settings
    ├── update         Update CLI to latest version
    └── version        Version information
```

## Quick examples

### Authentication

```
# Set URL and login
dr auth set-url https://app.datarobot.com
dr auth login

# Logout
dr auth logout
```

### Templates

```
# List templates
dr templates list

# Clone template
dr templates clone python-streamlit

# Interactive setup
dr templates setup

# Check status
dr templates status
```

### Quickstart

```
# Run quickstart process (interactive)
dr start

# Run with auto-yes
dr start --yes

# Using the alias
dr quickstart
```

### Environment configuration

```
# Interactive wizard
dr dotenv setup

# Editor mode
dr dotenv edit

# Validate configuration
dr dotenv validate
```

### Running tasks

```
# List available tasks
dr task list

# Run a task
dr run dev

# Run multiple tasks
dr run lint test --parallel
```

### Shell completions

```
# Bash (Linux)
dr self completion bash | sudo tee /etc/bash_completion.d/dr

# Zsh
dr self completion zsh > "${fpath[1]}/_dr"

# Fish
dr self completion fish > ~/.config/fish/completions/dr.fish
```

### CLI management

```
# Update to latest version
dr self update

# Check version
dr self version
```

## Command details

For detailed documentation on each command, see:

- auth —authentication management.
- login —OAuth authentication.
- logout —remove credentials.
- set-url—configure DataRobot URL.
- templates—template operations.
- list —list available templates.
- clone —clone a template repository.
- setup —interactive wizard for full setup.
- status—show current template status.
- run—task execution.
- Execute template tasks (e.g., dr run dev ).
- List available tasks via dr task list .
- Parallel execution support.
- Watch mode for development.
- task—Taskfile composition and management.
- compose —generate unified Taskfile from components.
- list —list all available tasks.
- run—execute tasks.
- dotenv—environment management.
- Interactive configuration wizard.
- Direct file editing.
- Variable validation.
- completion—shell completions.
- Bash, Zsh, Fish, PowerShell support.
- Auto-complete commands and flags.
- version—version information.
- Show CLI version.
- Build information.
- Runtime details.

## Getting help

```
# General help
dr --help
dr -h

# Command help
dr auth --help
dr templates --help
dr run --help

# Subcommand help
dr auth login --help
dr templates clone --help
```

## Environment variables

Global environment variables that affect all commands:

```
# Configuration
DATAROBOT_ENDPOINT             # DataRobot URL
DATAROBOT_API_TOKEN            # API token (not recommended)
```

## Exit codes

| Code | Meaning |
| --- | --- |
| 0 | Success. |
| 1 | General error. |
| 2 | Command usage error. |
| 130 | Interrupted (Ctrl+C). |

---
