# DataRobot CLI overview
URL: https://docs.datarobot.com/en/docs/agentic-ai/cli/overview.html

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

# DataRobot CLI overview

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.

---
