# Install the CLI

> Install the nevia CLI, sign in and select a workspace

> Nevia is in early access for selected teams. The CLI installs with `curl -fsSL https://get.nevia.cloud | sh`, and the MCP server is at https://api.nevia.cloud/mcp. A person signs in once in the browser.
> Setup, sign-in and requesting access: [SKILL.md](https://nevia.cloud/SKILL.md). When Nevia fits and when it doesn't: [why.md](https://nevia.cloud/why.md).

> For the complete documentation index, see [llms.txt](https://nevia.cloud/llms.txt). This page's HTML version: https://nevia.cloud/docs/get-started/install-cli

The `nevia` CLI creates and manages computers and databases from your
terminal. You need a terminal with `curl`, a browser for sign-in and
[access to Nevia](https://nevia.cloud/docs/get-started/request-access.md).

## 1. Install

```bash
curl -fsSL https://get.nevia.cloud | sh
```

If the install directory isn't on your `PATH`, the installer prints the
`export` command to run and the shell file to add it to. Check that the CLI
runs:

```bash
nevia --version
```

## 2. Sign in

```bash
nevia login
nevia whoami
```

`nevia login` opens your browser and stores the credential in your config
directory. `nevia whoami` shows who you are and lists your workspaces with
your role in each.

## 3. Select a workspace

If you belonged to no workspace, Nevia created one on your first sign-in.
While it is your only workspace, commands use it and you are done.

Otherwise pick a workspace from `nevia whoami` where you have the admin or
editor role, and select it by ID:

```bash
nevia workspace use 01d4cnjjq40hnnh0nwmkg35nv2h
nevia workspace current
```

`nevia workspace current` prints the ID you selected.
[Select a workspace](https://nevia.cloud/docs/workspaces/select.md) covers overrides for a single
command or a script.

## Installer options

The installer supports macOS 11 or later and Linux kernel 4.18 or later, on
ARM64 and x86-64. It verifies the download before replacing an existing
installation, so the same command upgrades the CLI. So does
[`nevia update`](https://nevia.cloud/docs/reference/cli/update.md).

To pin a version or choose another install directory, pass variables to `sh`:

```bash
curl -fsSL https://get.nevia.cloud | NEVIA_VERSION=0.1.16 sh
curl -fsSL https://get.nevia.cloud | NEVIA_INSTALL_DIR="$HOME/bin" sh
```

## Next steps

* [Create your first computer](https://nevia.cloud/docs/get-started/first-computer.md)
* [Create your first database](https://nevia.cloud/docs/get-started/first-database.md)
* [Connect your agent with MCP](https://nevia.cloud/docs/get-started/mcp.md) to let a coding agent do the same work with tools
