> ## Documentation Index
> Fetch the complete documentation index at: https://docs.exploratory.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get started

Turn on the CLI in Exploratory Desktop, connect expl, and look at the data in your project. Do the steps below in order and you get your first result on this one page.

## Steps

### 1. Start Desktop and sign in

Start Exploratory Desktop and sign in. expl reads the connection details and token that Desktop writes, so expl has no sign-in of its own.

### 2. Turn on the CLI

expl comes with Exploratory Desktop. The CLI is off by default, and Desktop refuses its commands until you turn it on.

In Exploratory Desktop, choose your name at the bottom left of the screen, then choose System Settings in the menu that opens. In the menu on the left, choose MCP / CLI, turn on the switch on the CLI card, and choose Save. To create, change or delete content with expl, also check Allow create, edit and delete. The pictures are on the [Installation](https://docs.exploratory.io/en/cli/desktop/install.md#enable) page.

### 3. Check the version and the state

Open a new terminal and check that expl works.

```sh theme={null}
expl --version
```

```sh theme={null}
expl status
```

It shows the Desktop version and the signed-in user.

The first time you use it, Exploratory Desktop shows a screen that asks whether to allow expl to connect to Exploratory. Check that it is the expl you started yourself, and allow it.

![The "An AI tool is asking for your approval" screen. It asks "Allow expl to connect to Exploratory? Only allow an app you started yourself." and has Allow and Don't allow buttons](https://mintcdn.com/exploratory-inc/m5S7Pfr13E6f1q8Y/en/cli/desktop/images/en/pairing-dialog.png?fit=max\&auto=format\&n=m5S7Pfr13E6f1q8Y\&q=85\&s=42e1800a9bb168561da7bcbec123244f)

expl waits up to 2 minutes for your answer and prints "Waiting for you to approve expl in Exploratory (a request is shown there)..." to standard error. When you allow it, the command continues. If no answer comes within 2 minutes, it stops with PAIRING\_PENDING (exit code 1). Answer the request in Desktop and run the command again.

If you choose Don't allow, the command stops with PAIRING\_REQUIRED (exit code 4). For 5 minutes after that, running the command again does not show the screen and is declined at once. Run it again after 5 minutes and allow it on the screen.

### 4. Choose a project

```sh theme={null}
expl project list
```

Lists the projects.

```sh theme={null}
expl project use "Sales Analysis"
```

Replace Sales Analysis with the name of your project. Later commands work on this project. This command only saves the default project; it does not open the project in Desktop.

If a later command stops with PROJECT\_NOT\_OPEN, the project is not open in Desktop. Open it with an id from expl project list.

```sh theme={null}
expl project open <project_id>
```

### 5. Look at the data

```sh theme={null}
expl dataframe list
```

Lists the data frames of the project. Choose the id of one.

```sh theme={null}
expl dataframe get-schema <dataframe_id>
```

Shows the column names and types. Replace \<dataframe\_id> with the id you chose. To see rows, run expl dataframe preview \<dataframe\_id>.

### 6. Get a dashboard (optional)

```sh theme={null}
expl dashboard list
```

Choose the id of a dashboard from the list. If the list is empty, the project has no dashboard yet.

```sh theme={null}
expl dashboard get d123 --json
```

Replace d123 with the id you chose.

## If something does not work

* A command is refused: check that the CLI switch is on and saved (step 2).
* The command stops with PAIRING\_PENDING: you did not answer within 2 minutes. Answer the request in Desktop and run the command again (step 3).
* The command stops with PAIRING\_REQUIRED: you chose Don't allow. Run the command again after 5 minutes and allow it on the screen (step 3).
* The command stops with PROJECT\_NOT\_OPEN: open the project with expl project open \<project\_id> (step 4).
* expl tools list exits with code 0 but the other commands do not work: that does not mean Desktop is connected. Run expl status.
* The dashboard list is empty: the project has no dashboard yet.

See [Troubleshooting](https://docs.exploratory.io/en/cli/desktop/troubleshooting.md) for more.

## Next

* [Choose a project](https://docs.exploratory.io/en/cli/desktop/guides/projects.md) - The order in which the project is decided.
* [Use](https://docs.exploratory.io/en/cli/desktop/use) - Find the command for what you want to do.
* [All commands](https://docs.exploratory.io/en/cli/desktop/commands.md) - Find a command by purpose.
* [Troubleshooting](https://docs.exploratory.io/en/cli/desktop/troubleshooting.md) - Find a fix by symptom.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.