Install the CLI

Get the intropy CLI installed in about a minute.

Before you begin

• A supported OS: macOS 13+, Linux x86_64/arm64, or Windows 11 (WSL2)
• .NET 10 SDK — every Component and system host is a .NET 10 project
• Docker Desktop 27+ — or another OCI-compatible engine (Rancher Desktop, Colima, podman). The local run starts its broker and service mocks as containers
• Dapr CLI 1.16 — runs the local sidecars every Intropy Component depends on
• Task — optional. Scaffolded projects ship a Taskfile.yml wrapping the common commands; everything it wraps can also be run by hand with dotnet

Install

macOS

The CLI is distributed as a Homebrew cask:

brew tap integrio-intropy/tap
brew trust --tap integrio-intropy/tap
brew install intropy

The brew trust step is required on current Homebrew (6.x+), where HOMEBREW_REQUIRE_TAP_TRUST is the default; on older versions you can skip it. The cask also installs shell completions for bash, zsh, and fish.

Prefer not to use Homebrew? The install script under the Linux tab works on macOS too.

Linux

Install from the GitHub releases:

curl -fsSL https://github.com/integrio-intropy/intropy-cli/releases/latest/download/install.sh | sh

The script detects your OS and architecture, downloads the matching release archive, verifies the SHA256 checksum, and installs the binary and shell completions.

To pin a version or change the install prefix, pass flags through sh -s --:

curl -fsSL https://github.com/integrio-intropy/intropy-cli/releases/latest/download/install.sh | sh -s -- --version v0.8.0 --prefix ~/.local

Windows (WSL)

Windows is not a supported native target: the CLI relies on Unix path conventions and signal handling. Install and run intropy inside WSL 2, using the same script as on Linux:

curl -fsSL https://github.com/integrio-intropy/intropy-cli/releases/latest/download/install.sh | sh

Run the rest of the toolchain (the .NET SDK, the Dapr CLI) inside WSL as well. Docker Desktop for Windows works, with its WSL 2 integration enabled for your distribution.

After installing the Dapr CLI, bootstrap the local Dapr environment once:

dapr init

Verify

intropy --version

You should see a version line (intropy version v0.8.0 or newer). intropy --help lists the commands; the CLI reference describes each one.