Skip to content

Command reference

Complete reference documentation for all DataRobot CLI commands.

This document provides a comprehensive overview of all available commands, their flags, and usage examples. For getting started with the CLI, see the Quick start guide.

Global flags

These flags are available for all commands:

  -V, --version                   Display version information
  -v, --verbose                  Enable verbose output (info level logging)
      --debug                    Enable debug output (debug level logging)
      --config string            Path to config file (default: $HOME/.config/datarobot/drconfig.yaml)
      --skip-auth                Skip authentication checks (for advanced users)
      --force-interactive        Force the setup wizard to run even if already completed
      --all-commands             Display all available commands and their flags in tree format
      --plugin-discovery-timeout duration   Timeout for plugin discovery (e.g. 2s, 500ms; default: 2s; 0s disables)
  -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.

Commands

Main commands

Command Description
auth Authenticate with DataRobot.
component Manage template components.
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, plugin).
plugin Inspect and manage CLI plugins.
pipeline Manage pipelines via the pipelines API (feature-gated).
dependencies Check and install template dependencies (advanced).

Command tree

dr
├── auth                Authentication management
│   ├── check          Check if credentials are valid
│   ├── login          Log in to DataRobot
│   ├── logout         Log out from DataRobot
│   └── set-url        Set DataRobot URL
├── component          Component management (alias: c)
│   ├── add            Add a component to your template
│   ├── list           List installed components
│   └── update         Update a component
├── templates          Template management (alias: template)
│   ├── list           List available templates
│   └── setup          Interactive setup wizard
├── start              Run quickstart process (alias: quickstart)
├── run                Task execution (alias: r)
├── task               Taskfile composition and execution
│   ├── compose        Compose unified Taskfile
│   ├── list           List available tasks
│   └── run            Execute tasks
├── dotenv             Environment configuration
├── dependencies       Template dependencies (advanced)
│   ├── check          Check template dependencies
│   └── install        Install missing template dependencies
├── plugin             Inspect and manage CLI plugins (alias: plugins)
│   ├── list           List installed plugins
│   ├── install        Install a plugin
│   ├── uninstall      Uninstall a plugin
│   └── update         Update plugins
├── pipeline           Pipelines API management (feature-gated)
│   ├── create         Upload a Python file to create a pipeline
│   ├── list           List pipelines
│   ├── get            Display pipeline details and versions
│   ├── update         Re-upload a Python file to update a draft pipeline
│   ├── delete         Delete a pipeline and all of its versions
│   ├── lock           Promote a draft pipeline to locked mode
│   ├── version        Inspect pipeline versions
│   │   ├── list       List versions of a pipeline
│   │   └── get        Display details of a single pipeline version
│   ├── graph          Display the pipeline/task DAG of a pipeline
│   ├── run            Trigger and inspect pipeline executions
│   │   ├── create     Trigger a run from an input
│   │   ├── list       List runs for a pipeline
│   │   ├── get        Display a single run
│   │   ├── status     Lightweight run status (for polling)
│   │   └── cancel     Cancel a running run
│   ├── input          Manage pipeline input payloads
│   │   ├── create     Register a JSON payload on a pipeline
│   │   ├── list       List inputs for a pipeline (draft or locked scope)
│   │   ├── get        Display a single input
│   │   ├── update     Update a draft input's payload
│   │   └── delete     Delete an input
│   └── schedule       Manage recurring (cron) runs (locked-only)
│       ├── create     Register a recurring schedule on a locked version
│       ├── list       List schedules for a locked version
│       ├── get        Display a single schedule
│       ├── update     Change cron expression / timezone
│       └── delete     Delete a schedule
└── self               CLI utility commands
    ├── completion     Shell completion
    │   ├── install    Install completions interactively
    │   ├── uninstall  Uninstall completions
    │   └── <shell>    Generate script (bash|zsh|fish|powershell)
    ├── config         Display configuration settings
    ├── plugin         Plugin packaging and development tools
    │   ├── add        Add a packaged plugin version to a registry file
    │   ├── publish    Package and publish a plugin in one step
    │   └── package    Package a plugin directory into a .tar.xz archive
    ├── 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

# Interactive setup
dr templates setup

Components

# List installed components
dr component list

# Add a component
dr component add <component-url>

# Update a component
dr component update

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 run --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.
  • check—verify credentials are valid.
  • login—OAuth authentication.
  • logout—remove credentials.

  • set-url—configure DataRobot URL.

  • component—component management (alias: c).

  • add—add a component to your template.
  • list—list installed components.
  • update—update a component.

  • Note: Components are reusable pieces that can be added to templates to extend functionality.

  • templates—template operations.

  • list—list available templates.

  • setup—interactive wizard for full setup.

  • run—task execution.

  • Execute template tasks.
  • List available tasks.
  • 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.

  • self—CLI utility commands.

  • completion—shell completions: use install/uninstall or pass a shell (bash, zsh, fish, powershell) to generate a script.
  • config—display configuration settings.
  • plugin—plugin packaging and development: add, publish, package.
  • update—update CLI to latest version.

  • version—show CLI version and build information.

  • dependencies—template dependency management (advanced).

  • check—verify that required tools are installed and meet minimum version requirements.

  • install—install missing or out-of-date tools; supports --yes/-y and DATAROBOT_CLI_NON_INTERACTIVE for non-interactive use.

  • plugin—inspect and manage installed CLI plugins (alias: plugins).

  • pipeline—manage AI/ML pipelines orchestrated by Covalent (feature-gated behind DATAROBOT_CLI_FEATURE_PIPELINE=true).

  • create—upload a Python file to register a new pipeline.
  • list—list pipelines with mode filtering and pagination.
  • get—display full details of a pipeline including all versions.
  • update—re-upload a Python file to append a new version to a draft pipeline.
  • delete—remove a pipeline and all of its versions.
  • lock—promote a draft pipeline to locked mode.
  • version—list / get to inspect pipeline versions.
  • graph—display the pipeline/task DAG (draft or locked).
  • run—create/list/get/status/cancel pipeline executions.
  • input—create/list/get/update/delete JSON payloads used by runs.
  • schedule—create/list/get/update/delete recurring (cron) runs on locked versions.

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 setup --help
dr component add --help

Environment variables

Global environment variables that affect all commands:

# Configuration
DATAROBOT_ENDPOINT                  # DataRobot URL
DATAROBOT_API_TOKEN                 # API token (not recommended)
DATAROBOT_CLI_CONFIG                # Path to config file
DATAROBOT_CLI_PLUGIN_DISCOVERY_TIMEOUT  # Timeout for plugin discovery (e.g. 2s; 0s disables)
VISUAL                              # External editor for file editing
EDITOR                              # External editor for file editing (fallback)

Exit codes

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

See also