# DataRobot CLI overview

> DataRobot CLI overview - Learn about what the DataRobot CLI is for, how it's used, and how the CLI
> documentation is organized.

This Markdown file sits beside the HTML page at the same path (with a `.md` suffix). It summarizes the topic and lists links for tools and LLM context.

Companion generated at `2026-05-06T18:17:09.550987+00:00` (UTC).

## Primary page

- [DataRobot CLI overview](https://docs.datarobot.com/en/docs/agentic-ai/cli/overview.html): Full documentation for this topic (HTML).

## Sections on this page

- [What the CLI is for](https://docs.datarobot.com/en/docs/agentic-ai/cli/overview.html#what-the-cli-is-for): In-page section heading.
- [Common workflow](https://docs.datarobot.com/en/docs/agentic-ai/cli/overview.html#common-workflow): In-page section heading.
- [Where to go next](https://docs.datarobot.com/en/docs/agentic-ai/cli/overview.html#where-to-go-next): In-page section heading.
- [Quick install](https://docs.datarobot.com/en/docs/agentic-ai/cli/overview.html#quick-install): In-page section heading.
- [Documentation structure](https://docs.datarobot.com/en/docs/agentic-ai/cli/overview.html#documentation-structure): In-page section heading.
- [User guide](https://docs.datarobot.com/en/docs/agentic-ai/cli/overview.html#user-guide): In-page section heading.
- [Template system](https://docs.datarobot.com/en/docs/agentic-ai/cli/overview.html#template-system): In-page section heading.
- [Command reference](https://docs.datarobot.com/en/docs/agentic-ai/cli/overview.html#command-reference): In-page section heading.
- [Development guide](https://docs.datarobot.com/en/docs/agentic-ai/cli/overview.html#development-guide): In-page section heading.
- [Getting help](https://docs.datarobot.com/en/docs/agentic-ai/cli/overview.html#getting-help): In-page section heading.

## Related documentation

- [Agentic AI](https://docs.datarobot.com/en/docs/agentic-ai/index.html): Linked from this page.
- [CLI](https://docs.datarobot.com/en/docs/agentic-ai/cli/index.html): Linked from this page.
- [Getting started](https://docs.datarobot.com/en/docs/agentic-ai/cli/getting-started.html): Linked from this page.
- [Authentication management](https://docs.datarobot.com/en/docs/agentic-ai/cli/commands/auth.html): Linked from this page.
- [Working with templates](https://docs.datarobot.com/en/docs/agentic-ai/cli/template-system/index.html): Linked from this page.
- [Agentic AI quickstart](https://docs.datarobot.com/en/docs/agentic-ai/agentic-develop/agentic-quickstart.html): Linked from this page.
- [Quick reference](https://docs.datarobot.com/en/docs/agentic-ai/cli/quick-reference.html): Linked from this page.
- [Shell completions](https://docs.datarobot.com/en/docs/agentic-ai/cli/shell-completions.html): Linked from this page.
- [Configuration files](https://docs.datarobot.com/en/docs/agentic-ai/cli/configuration.html): Linked from this page.
- [Troubleshooting](https://docs.datarobot.com/en/docs/agentic-ai/agent-assist/troubleshooting.html): Linked from this page.
- [Template structure](https://docs.datarobot.com/en/docs/agentic-ai/cli/template-system/structure.html): Linked from this page.
- [Interactive configuration](https://docs.datarobot.com/en/docs/agentic-ai/cli/template-system/interactive-config.html): Linked from this page.
- [Environment variables](https://docs.datarobot.com/en/docs/agentic-ai/cli/template-system/environment-variables.html): Linked from this page.
- [command reference](https://docs.datarobot.com/en/docs/agentic-ai/cli/commands/index.html): Linked from this page.
- [run](https://docs.datarobot.com/en/docs/agentic-ai/cli/commands/run.html): Linked from this page.
- [dotenv](https://docs.datarobot.com/en/docs/agentic-ai/cli/commands/dotenv.html): Linked from this page.
- [self](https://docs.datarobot.com/en/docs/agentic-ai/cli/commands/self.html): Linked from this page.
- [Building from source](https://docs.datarobot.com/en/docs/agentic-ai/cli/development/building.html): Linked from this page.
- [Development setup](https://docs.datarobot.com/en/docs/agentic-ai/cli/development/setup.html): Linked from this page.
- [Project structure](https://docs.datarobot.com/en/docs/agentic-ai/cli/development/structure.html): Linked from this page.
- [Releasing](https://docs.datarobot.com/en/docs/agentic-ai/cli/development/releasing.html): Linked from this page.

## Documentation content

The DataRobot CLI ( `dr`) is an open source tool for working with DataRobot from your terminal. It is designed for developers and operators who want repeatable, scriptable workflows instead of doing everything from the DataRobot UI.

## What the CLI is for

Use the CLI to:

- Authenticate against your DataRobot instance (cloud or self-managed) and locally manage credentials.
- Work with application templates. Browse, clone, and configure projects built from templates, including an interactive setup when a template defines prompts and environment variables.
- Run local development tasks. Execute the same Task-based workflows your template expects (for example, dr run dev , dr run build , dr run test ) so your machine matches how the app is meant to be built and run.
- Support Agentic AI workflows. Bootstrap and run agent-oriented setups with commands such as dr start and dr task run .

The CLI does not replace the DataRobot web application for every task; it focuses on local development, template-driven apps, and automation (including CI/CD) where a terminal interface fits best.

## Common workflow

Most users follow a path like this:

1. Install dr in your workspace (see Quick install or the full Getting started guide).
2. Point the CLI at your environment and sign in (see Authentication management ){ target=_blank }.
3. Clone or set up a template if you are building from an application template (see Working with templates ).
4. Run tasks defined for that project ( dr task list , dr run ) as you develop.

If you are building [Agentic AI](https://docs.datarobot.com/en/docs/agentic-ai/index.html) workflows, the [Agentic AI quickstart](https://docs.datarobot.com/en/docs/agentic-ai/agentic-develop/agentic-quickstart.html) walks through `dr start` and `dr task run` end to end.

## Where to go next

| If you want to… | Start here |
| --- | --- |
| Install and configure the CLI for the first time | Getting started |
| Look up commands without narrative | Quick reference |
| Understand template layout and .env behavior | Template system |
| Read per-command details | Command reference (below) |

> [!TIP] Building agentic workflows?
> The CLI is used to set up, run, and deploy [Agentic AI](https://docs.datarobot.com/en/docs/agentic-ai/index.html) workflows. See the [Agentic AI quickstart](https://docs.datarobot.com/en/docs/agentic-ai/agentic-develop/agentic-quickstart.html) to get started with `dr start` and `dr task run`.

## Quick install

Install the latest version with a single command that auto-detects your operating system:

macOS/Linux:

```
curl https://cli.datarobot.com/install | sh
```

Windows (PowerShell):

```
irm https://cli.datarobot.com/winstall | iex
```

For more installation options, see [Getting Started](https://docs.datarobot.com/en/docs/agentic-ai/cli/getting-started.html).

## Documentation structure

### User guide

End-user documentation for using the CLI:

- Getting started —installation and initial setup.
- Quick reference —one-page command and path reference.
- Authentication —setting up DataRobot credentials.
- Working with templates —clone and manage application templates.
- Shell completions —set up command auto-completion.
- Configuration files —understanding config file structure.
- Troubleshooting —common issues and where to find solutions.

### Template system

Understanding the interactive template configuration:

- Template structure —how templates are organized.
- Interactive configuration —the wizard system explained.
- Environment variables —managing .env files.

### Command reference

The [command reference](https://docs.datarobot.com/en/docs/agentic-ai/cli/commands/index.html) lists every `dr` command, global flags, and guidance on when to use `dr start` versus `dr run`, plus links into each topic. Common entry points:

- auth —authentication management.
- run —task execution.
- dotenv —environment variable management.
- self —CLI utility commands (version, completion).

### Development guide

For contributors and developers:

- Building from source —compile and build the CLI.
- Development setup —local development environment.
- Project structure —codebase organization.
- Releasing —release process.

## Getting help

If you can't find what you're looking for:

1. Search existing issues .
2. Open a new issue .
3. Email: oss-community-management@datarobot.com.