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

# Install

> Install the Sovara CLI and verify that it can reach Sovara.

The Sovara CLI is a standalone binary named `sovara`. It is not installed by
the Python SDK or TypeScript runner.

Installing the CLI does not require the desktop app. `sovara status` checks the
currently configured app environment: keep the desktop app running for local
desktop commands, or configure a remote app server. SDK runs can also start the
local execution server when needed.

## macOS, Linux, and WSL

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -fsSL https://apps.sovara-labs.com/cli/install.sh | sh
```

Open a new terminal after installation, then verify:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
sovara --version
sovara status
```

## Windows PowerShell

```powershell theme={"theme":{"light":"github-light","dark":"github-dark"}}
irm https://apps.sovara-labs.com/cli/install.ps1 | iex
```

Open a new terminal and run `sovara --version` and `sovara status`.

## Windows CMD

```cmd theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -fsSL https://apps.sovara-labs.com/cli/install.cmd -o install.cmd && install.cmd && del install.cmd
```

Open a new terminal and run `sovara --version` and `sovara status`.

## Update the CLI

Check for a newer release without installing it:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
sovara update --check
```

Install the latest release and refresh the assistant skill:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
sovara update
```

## Set up an agent repository

After installing the CLI and connecting to a Sovara environment, let a coding
assistant add and verify the SDK integration:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
cd agent-dir
sovara setup
```

To install guidance without launching an assistant, use:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
sovara install-skill --target both
```

See [Assistant skill](/cli/assistant-skill) for advanced installation options.