Installation

Install the capa CLI once on your machine, then use it in any project. The binary is what you upgrade later with capa upgrade.

Install

macOS and Linux

curl -LsSf https://capa.infragate.ai/install.sh | sh

The script downloads the latest capa binary and puts it on your PATH (typically /usr/local/bin/capa, or ~/.local/bin/capa without sudo).

Windows

powershell -ExecutionPolicy ByPass -c "irm https://capa.infragate.ai/install.ps1 | iex"

The script installs to %USERPROFILE%\.capa\bin\capa.exe and updates your user PATH.

GitHub releases

Prefer a manual binary? Download the build for your OS from the capa GitHub releases page, place it somewhere on your PATH, and rename it to capa (or capa.exe on Windows).

Verify

capa --version

You should see the installed version printed. If the command is not found, restart the terminal or add the install directory to your PATH.

PATH tips

On macOS/Linux, user installs often need export PATH="$HOME/.local/bin:$PATH". On Windows, confirm %USERPROFILE%\.capa\bin is on your user PATH.

Upgrade

Keep the CLI current with:

capa upgrade

Re-run the install script or replace the binary from GitHub releases if you installed outside the usual layout.

Next steps

With capa on your PATH, initialize a project in the managed quick start, or jump to wrap if you already have a capabilities.yaml.