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

# Installation

expl comes with Exploratory Desktop. There is nothing else to install.

## Turn on the CLI first

In Exploratory Desktop, the CLI is off by default. Even when expl is on your PATH, Desktop refuses its commands until you turn it on.

1. In Exploratory Desktop, choose your name at the bottom left of the screen, then choose System Settings in the menu that opens (1 and 2 in picture 1).

![The menu that opens when you choose your name at the bottom left of Exploratory Desktop. 1 is your name and 2 is System Settings](https://mintcdn.com/exploratory-inc/m5S7Pfr13E6f1q8Y/en/cli/desktop/images/en/open-system-settings.png?fit=max\&auto=format\&n=m5S7Pfr13E6f1q8Y\&q=85\&s=4c3b2cb34f1e1a8affa37d151fda1d58)

2. In the menu on the left of System Settings, choose MCP / CLI (1 in picture 2).
3. On the CLI card, turn on the switch (2 in picture 2).
4. Only when you want to create, change or delete content with expl, also check Allow create, edit and delete (3 in picture 2).
5. Choose Save at the bottom of the screen (4 in picture 2).

![System Settings, MCP / CLI. 1 is MCP / CLI in the left menu, 2 is the switch on the CLI card, 3 is the Allow create, edit and delete check, 4 is Save](https://mintcdn.com/exploratory-inc/m5S7Pfr13E6f1q8Y/en/cli/desktop/images/en/cli-settings.png?fit=max\&auto=format\&n=m5S7Pfr13E6f1q8Y\&q=85\&s=0d310dc9f477e3dd75a891c875c29389)

## Bundled with Desktop

When you start Exploratory Desktop, it puts expl on your PATH (the list of folders where commands are found) if it is not there yet. Use it from a newly opened terminal. You do not need to install Node.js.

On macOS this happens only when the app is in /Applications or \~/Applications.

Open a new terminal and run this.

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

## Where it goes

| OS | Location |
| - | - |
| macOS | /usr/local/bin/expl (\~/.local/bin/expl when you decline the administrator permission) |
| Windows | \<install folder>\cli is added to your user PATH. Administrator rights are not needed. |

On macOS, installing in /usr/local/bin may ask for administrator permission. If you decline, expl goes to \~/.local/bin; add that folder to your PATH if needed, and run `which expl` to see where it is.

The same program is also installed as exploratory, and as exploratory-mcp for MCP. If another command already uses one of those names, only that name is not installed.

## When you also installed it with npm

If you have both an npm copy and the Desktop copy of expl, check which one runs.

### macOS and Linux

```sh theme={null}
which -a expl
```

Shows every copy, in the order they run.

### Windows

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

## Update

The expl that comes with Desktop is updated when you update Exploratory Desktop. Run `expl --version` to check the version. To update an npm copy, see [Update](https://docs.exploratory.io/en/cli/server/install.md#update).

For what changed in each version, see the [release notes](https://docs.exploratory.io/en/release-note).

## Remove

| OS | How |
| - | - |
| macOS | Run ls -l on /usr/local/bin/expl, /usr/local/bin/exploratory and /usr/local/bin/exploratory-mcp, and delete only the ones that Exploratory added (rm \<path>; add sudo if administrator rights are needed). A command with the same name that came from somewhere else, such as an npm copy, stays. If you declined the permission, check and delete the same names in \~/.local/bin instead. If the app stays in /Applications, it is installed again at the next start. |
| Windows | Open "Edit the system environment variables" and remove \<install folder>\cli from Path in the user variables. It is added again at the next start. |

To connect to Desktop and run your first commands, see [Get started](https://docs.exploratory.io/en/cli/desktop/get-started#steps).


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