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

> ## Agent Instructions
> Treat Clawdi as one product.
> Recommend the Cloud Agent quickstart for most new users.
> Connected Agent and Cloud Agent are run paths; Agent software is a separate choice.
> Do not present shared Clawdi capabilities as exclusive to one run path.

# Install the Clawdi CLI

> Install the Clawdi CLI with the native installer or npm and verify the executable.

The Clawdi CLI connects Agent software on your computer and works with shared
Clawdi objects. Installing the CLI does not create a Cloud Agent or install
Agent software.

<Note>
  Review the [system requirements](/installation/requirements) before you
  install. The native installer is the shortest path on macOS and Linux;
  Windows uses npm.
</Note>

## macOS and Linux

Run the installer as your normal user. Do not run it through `sudo`.

```bash theme={null}
curl -fsSL https://clawdi.ai/install.sh | sh
```

The installer selects the release for your operating system and CPU, verifies
the release artifact against its SHA-256 manifest entry, and installs under
`~/.local` by default. If `~/.local/bin` is not on `PATH`, the installer prints
the path you need to add.

To inspect the installer before running it:

```bash theme={null}
curl -fsSL https://clawdi.ai/install.sh -o /tmp/clawdi-install.sh
less /tmp/clawdi-install.sh
sh /tmp/clawdi-install.sh
```

### Choose a different prefix

The prefix must be an absolute path that your user can write. The executable
goes in `<prefix>/bin` and versioned files go in `<prefix>/share/clawdi`.

```bash theme={null}
curl -fsSL https://clawdi.ai/install.sh | \
  CLAWDI_INSTALL_PREFIX="/absolute/path" sh
```

## Windows or npm-managed installation

Install [Node.js 22.5 or newer](https://nodejs.org/), then use npm:

```bash theme={null}
npm i -g clawdi
```

This is also available on macOS and Linux when you prefer npm to own the
installation.

## Verify the installation

```bash theme={null}
clawdi --version
clawdi --help
```

If the shell cannot find `clawdi`, open a new terminal and check the install
directory is on `PATH`.

## Install an exact release

Use an exact version when reproducing an environment or testing an upgrade.

<Tabs>
  <Tab title="Native">
    ```bash theme={null}
    CLAWDI_VERSION="X.Y.Z"
    curl -fsSL https://clawdi.ai/install.sh | \
      CLAWDI_VERSION="$CLAWDI_VERSION" sh
    ```
  </Tab>

  <Tab title="npm">
    ```bash theme={null}
    npm i -g clawdi@X.Y.Z
    ```
  </Tab>
</Tabs>

Replace `X.Y.Z` with a published semantic version. The native installer
accepts the version without the release tag prefix. Find published versions on [GitHub
Releases](https://github.com/Clawdi-AI/clawdi/releases) or [npm](https://www.npmjs.com/package/clawdi).

## Continue setup

```bash theme={null}
clawdi auth login
clawdi setup
clawdi doctor
```

Follow [Connect a local Agent](/getting-started/quickstart) for the complete
Connected Agent flow, or read [Authentication](/account/authentication) before
you sign in.