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

# Install and update the CLI

> Install the current atlanai Preview release on macOS, Linux, or Windows.

Install `atlanai` for your user account. The installer preserves local state,
starts the background runtime, and adds the command to your user bin directory.

<Note>
  The standalone CLI is in Preview. On a managed device, follow your
  organization's software-installation policy.
</Note>

## Check for an existing installation

Atlan Desktop can prepare the CLI runtime on supported installations. Check
before installing another copy:

```bash theme={null}
atlanai version
atlanai doctor
```

If both commands succeed, continue to [Get started](/cli/get-started).

## macOS and Linux

```bash theme={null}
curl -fsSL https://agentgateway.atlan.engineering/install.sh | sh
```

Restart your shell if `atlanai` is not immediately available on `PATH`.

## Windows PowerShell

```powershell theme={null}
irm https://agentgateway.atlan.engineering/install.ps1 | iex
```

Open a new PowerShell window after installation.

## Verify the installation

```bash theme={null}
atlanai version
atlanai doctor
```

`version` identifies the binary and platform. `doctor` works offline and shows
the command path, Gateway, local directories, credential source, runtime, and
daemon state without printing an access token.

## Update

Rerun the installer command for your operating system. The update preserves
local state and keeps the previous runtime available for rollback.

## Enable shell completion

Generate completion for Bash, Zsh, Fish, or PowerShell:

```bash theme={null}
atlanai completion zsh
```

Run `atlanai completion <shell> --help` for the shell-specific installation
command.