commands

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 when placed before the command (0s disables; config is read too late for startup discovery)
  -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 + deployed models).
pipeline	Manage pipelines via the pipelines API.
artifact	Build and manage workload artifacts.
workload	Deploy and manage workloads from artifacts.
enclave	Register and manage enclaves (outposts) (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 model management (alias: llm, llm-gateways)
│   ├── list           List available LLMs: gateway + deployed (alias: ls)
│   └── select         Set the default LLM
├── pipeline           Pipelines API management (alias: pipelines)
│   ├── 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
│   │   └── task       Inspect per-run task executions (dispatch records)
│   │       ├── list   List task invocations for a run (TASK ID · NODE ID)
│   │       ├── get    Lifecycle record for a single task invocation
│   │       ├── logs   Fetch a task invocation's logs (live or durable)
│   │       └── result Presigned URL for a completed task's result
│   ├── 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
│   ├── image          Manage pipeline execution images
│   │   ├── create     Create a pipeline execution image
│   │   ├── get        Fetch details of a pipeline execution image
│   │   ├── list       List pipeline execution images
│   │   ├── update     Add a new version to a pipeline execution image
│   │   ├── delete     Delete a pipeline execution image
│   │   └── version    Manage versions of a pipeline execution image
│   │       ├── delete Delete a specific version
│   │       └── logs   Fetch build logs for a specific version
│   ├── clone          Clone a pipeline into a new draft
│   ├── source         Display the source code of a pipeline
│   └── task           Inspect individual pipeline tasks (source + signature)
│       └── get        Display task source, parameters, and input payload
├── artifact           Artifact management
│   ├── 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)
│   ├── 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
├── enclave            Enclave management (alias: enclaves, outpost(s), feature-gated)
│   ├── register       Register an enclave, returning one-shot install secrets
│   ├── get            Display details of an enclave
│   ├── list           List enclaves
│   ├── deactivate     Take an active enclave out of scheduling
│   ├── reactivate     Return a deactivated enclave to service
│   ├── delete         Delete an enclave
│   ├── access         Manage who can access one enclave
│   │   ├── grant      Grant a role (owner|user|consumer) on an enclave
│   │   ├── revoke     Revoke a recipient's role on an enclave
│   │   ├── list       List who holds a role on an enclave
│   │   └── show       Show effective permissions on an enclave
│   └── permission     Manage who can create enclaves
│       ├── grant      Allow a recipient to create enclaves
│       ├── revoke     Stop a recipient from creating enclaves
│       ├── list       List who may create enclaves
│       └── show       Show your collection-level permissions
└── 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

# Export credentials into the current shell session
eval "$(dr auth export)"

# 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 available LLMs (gateway + deployed)
dr llm-gateway list

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

# Restrict to one source (skips the other source's request)
dr llm-gateway list --source gateway
dr llm-gateway list --source deployed

# 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, across LLM Gateway catalog models and DataRobot-deployed LLMs (aliases: llm, llm-gateways).

  • list (ls)—fetch available LLMs and display them in a table (ID · NAME · SOURCE · PROVIDER · MODEL · CONTEXT). The currently-selected model is marked with *. Both sources are queried in parallel by default; --source gateway or --source deployed narrows it to one and skips the other request. Supports --output-format json (each entry includes source, deployment_id, and a selected boolean).
  • select [llm-id]—set the default LLM. Without an argument, launches an interactive TUI picker. With an argument (a gateway model id or a deployment id), validates it against the available LLMs 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.

  • 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; run task (list/get/logs/result) inspects the per-@task executions of a single run.
  • input—create/list/get/update/delete JSON payloads used by runs.
  • schedule—create/list/get/update/delete recurring (cron) runs on locked versions.
  • image—create/get/list/update/delete pipeline execution images; version delete and version logs operate on a specific image version.
  • clone—clone an existing pipeline into a new draft.
  • source—display the source code of a pipeline.
  • 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.

  • 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 .datarobot/workload/ state directory.

• workload—deploy and operate workloads created from artifacts (alias wl).

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

• artifact and workload spec—the reference for the two spec files those commands read: container groups and images, environment variables and secrets, replicas and resource allocation, and one walkthrough from source code to a running URL.

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 ID: gateway model or deployment 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

• Quick start
• User guide
• Template system