Skip to content

commands

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History
 
 

commands

README.md

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.
dependencies Check 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
├── plugin             Inspect and manage CLI plugins (alias: plugins)
│   ├── list           List installed plugins
│   ├── install        Install a plugin
│   ├── uninstall      Uninstall a plugin
│   └── update         Update plugins
└── 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 checks (advanced).

    • check—verify that required tools (e.g. Task, Git) are installed.

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

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