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

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.

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.

Installation methods

curl
Homebrew
From source

Run the one-line installer to download the latest release from GitHub and place the binary at ~/.local/bin/doppels:

curl -fsSL https://raw.githubusercontent.com/doppelshq/doppels/main/install.sh | sh

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

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 versionWhile only prereleases exist, you may want to pin a specific tag to avoid surprises on re-install:

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.

First, add the Doppels tap to Homebrew:

brew tap doppelshq/tap

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

brew trust doppelshq/tap

Then install the CLI:

brew install doppels

Homebrew will manage future upgrades via brew upgrade doppels.

Building from source requires mise and Task. Clone the repository and use the provided Taskfile:

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:

cp ./bin/doppels ~/.local/bin/doppels

Verify the installation

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

doppels --version

You should see output like:

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:

npx skills add doppelshq/doppels --skill doppel-freeze
doppels spaces init

Or follow the Quickstart to run your first Capability using the example Space bundled in the repository.

Get Started

Core Concepts

Guides

Agent Skills

Reference

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

Installation methods

Verify the installation

Next steps

​Installation methods

​Verify the installation

​Next steps

Installation methods

Verify the installation

Next steps