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)
  -k, --skip-certificate-check   Skip TLS certificate verification (insecure)
      --ca-cert string           Path to a PEM-encoded CA certificate bundle
      --export-windows-certs     Export the Windows certificate store to the DataRobot CA bundle (Windows only)
  -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.

[!WARNING] --skip-certificate-check disables TLS certificate verification entirely and should only be used against known, trusted endpoints for testing.

[!NOTE] --ca-cert and --skip-certificate-check are universal flags: when placed before a plugin name (e.g. dr --ca-cert /path/to/ca.pem myplugin), they are forwarded to the plugin subprocess as DATAROBOT_CLI_CA_CERT and DATAROBOT_CLI_SKIP_CERTIFICATE_CHECK environment variables, in addition to the standard NODE_EXTRA_CA_CERTS / SSL_CERT_FILE / NODE_TLS_REJECT_UNAUTHORIZED variables. See Plugin development.

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.
llm-gateway List and select the default LLM Gateway model.
pipeline Manage pipelines via the pipelines API (feature-gated).
artifact Build and manage workload artifacts (feature-gated).
workload Deploy and manage workloads from artifacts (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
├── llm-gateway        LLM Gateway model management (alias: llm, llm-gateways)
│   ├── list           List active LLM Gateway models (alias: ls)
│   └── select         Set the default LLM Gateway model
├── 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
│   ├── environment    Manage named, versioned pip-package environments
│   │   ├── create     Register a new environment with an initial version
│   │   ├── list       List registered environments
│   │   ├── update     Append a new version to an environment
│   │   ├── delete     Soft-delete the latest active version of an environment
│   │   └── version    Manage environment versions
│   │       └── delete Delete a specific version
│   └── task           Inspect individual pipeline tasks (source + signature)
│       └── get        Display task source, parameters, and input payload
├── artifact           Artifact management (feature-gated)
│   ├── create         Create an artifact
│   ├── get            Display details of an artifact
│   ├── list           List artifacts
│   ├── lock           Lock a draft artifact
│   ├── delete         Delete an artifact
│   ├── build          Manage artifact builds
│   │   ├── create     Trigger a new image build
│   │   ├── get        Get the status of a build
│   │   ├── list       List builds for an artifact
│   │   └── logs       Fetch build logs
│   └── code           Manage artifact code synchronization
│       ├── init       Link a directory to an artifact
│       ├── sync       Push and pull code changes
│       ├── versions   List catalog versions
│       └── checkout   Download a version snapshot
├── workload           Workload management (alias: wl, feature-gated)
│   ├── create         Create (deploy) a workload
│   ├── get            Display details of a workload
│   ├── list           List workloads
│   ├── delete         Delete a workload
│   ├── start          Start a stopped workload
│   ├── stop           Stop a workload
│   ├── status         Show a workload's status
│   ├── endpoint       Print a workload's endpoint URL
│   └── logs           Show a workload's container logs
└── 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

LLM Gateway

# List active LLM Gateway models
dr llm-gateway list

# List as JSON
dr llm-gateway list --output-format json

# Select a default LLM interactively (TUI picker)
dr llm-gateway select

# Set a default LLM directly by ID
dr llm-gateway select <llm-id>

Aliases:

dr llm list       # llm-gateway → llm
dr llm ls         # list → ls
dr llm select

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).

  • llm-gateway—list and configure the default LLM Gateway model (aliases: llm, llm-gateways).

  • list (ls)—fetch all active LLMs from the catalog and display them in a table (ID · NAME · PROVIDER · MODEL). The currently-selected model is marked with *. Supports --output-format json (includes a selected boolean field per entry).

  • select [llm-id]—set the default LLM. Without an argument, launches an interactive TUI picker. With an argument, validates the ID against the active catalog and persists it immediately. The selection is saved to drconfig.yaml under the key default-llm-id.

  • 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.
  • environment—create/list/update/delete named pip-package environments; version delete removes a specific version.

  • task—get to inspect a task's source code, function signature parameters, and (for locked versions) the latest pipeline input payload.

  • artifact—build and manage the container artifacts that back workloads (feature-gated behind DATAROBOT_CLI_FEATURE_WORKLOAD=true).

  • create / get / list / lock / delete—the draft-to-locked artifact lifecycle.
  • build—create / get / list / logs for container image builds.

  • code—init / sync / versions / checkout to sync local code with an artifact via a .wapi/ state directory.

  • workload—deploy and operate workloads created from artifacts (alias wl; feature-gated behind DATAROBOT_CLI_FEATURE_WORKLOAD=true).

  • create / get / list / delete—the workload lifecycle.
  • start / stop / status—run-state control and status polling.
  • endpoint / logs—print the endpoint URL and stream container logs.

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)
DATAROBOT_CLI_DEFAULT_LLM_ID        # Default LLM Gateway model ID (overrides drconfig.yaml)
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