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

# Install the Doppels CLI on macOS, Linux, or from Source

> Install the Doppels CLI on macOS or Linux using the curl installer, Homebrew tap, or by building from source with mise. The binary is named `doppels`.

The Doppels CLI is a single binary called **`doppels`** (not `doppel`). It runs on macOS and Linux and requires no runtime dependencies beyond a POSIX shell. Choose the installation method that fits your workflow: the curl installer is the fastest path, Homebrew integrates with your existing package management, and building from source gives you full control over the version you run.

<Note>
  **Pre-alpha software.** Doppels releases are currently tagged as prereleases (`v0.0.0-dev.*`). The CLI is functional for local use, but schemas and commands may change before a stable release. Pin a specific version if you need reproducibility across machines.
</Note>

## Installation methods

<Tabs>
  <Tab title="curl">
    Run the one-line installer to download the latest release from GitHub and place the binary at `~/.local/bin/doppels`:

    ```shell theme={null}
    curl -fsSL https://raw.githubusercontent.com/doppelshq/doppels/main/install.sh | sh
    ```

    If `~/.local/bin` is not on your `PATH`, add it:

    ```shell theme={null}
    export PATH="$HOME/.local/bin:$PATH"
    ```

    Add that line to your `~/.bashrc`, `~/.zshrc`, or equivalent shell config file to make it permanent.

    **Pin a specific version**

    While only prereleases exist, you may want to pin a specific tag to avoid surprises on re-install:

    ```shell theme={null}
    curl -fsSL https://raw.githubusercontent.com/doppelshq/doppels/main/install.sh \
      | DOPPELS_VERSION=v0.0.0-dev.1 sh
    ```

    Replace `v0.0.0-dev.1` with any tag listed on the [GitHub Releases page](https://github.com/doppelshq/doppels/releases).
  </Tab>

  <Tab title="Homebrew">
    First, add the Doppels tap to Homebrew:

    ```shell theme={null}
    brew tap doppelshq/tap
    ```

    If you are running Homebrew 6 or later, trust the tap before installing:

    ```shell theme={null}
    brew trust doppelshq/tap
    ```

    Then install the CLI:

    ```shell theme={null}
    brew install doppels
    ```

    Homebrew will manage future upgrades via `brew upgrade doppels`.
  </Tab>

  <Tab title="From source">
    Building from source requires [mise](https://mise.jdx.dev) and [Task](https://taskfile.dev). Clone the repository and use the provided Taskfile:

    ```shell theme={null}
    git clone https://github.com/doppelshq/doppels.git
    cd doppels
    mise install
    task setup
    task build:cli
    ```

    The compiled binary is written to `./bin/doppels`. With the mise shell hook active, `bin/` is automatically on your `PATH` inside the project directory.

    To install the binary to a location on your system `PATH`, copy it manually:

    ```shell theme={null}
    cp ./bin/doppels ~/.local/bin/doppels
    ```
  </Tab>
</Tabs>

## Verify the installation

After installing by any method, confirm the binary is reachable and check the version:

```shell theme={null}
doppels --version
```

You should see output like:

```text theme={null}
doppels version v0.0.0-dev.1
```

If the command is not found, check that the install directory is on your `PATH` and that you have opened a new shell session (or sourced your shell config) since adding the export.

## Next steps

With the CLI installed, install the freeze skill and initialize your first Space:

```shell theme={null}
npx skills add doppelshq/doppels --skill doppel-freeze
doppels spaces init
```

Or follow the [Quickstart](/quickstart) to run your first Capability using the example Space bundled in the repository.