Installation

Caspira is a single binary with no runtime dependencies. Pick the method that works for your setup.

Via cargo (recommended)

Requires Rust 1.78 or newer. If you don't have Rust installed, get it from rustup.rs.

cargo install caspira

The binary is placed in ~/.cargo/bin/. Make sure that directory is on your $PATH.

Via Homebrew (macOS / Linux)

brew tap emkay/tools
brew install caspira

The tap is updated within a day of each release.

Pre-built binaries

Signed binaries for macOS (arm64, x86_64) and Linux (x86_64, aarch64) are attached to each release. Download, make executable, and move to somewhere on your path:

# Example for Linux x86_64
curl -LO https://caspira.xyz/releases/v0.2.1/caspira-linux-x86_64.tar.gz
tar xzf caspira-linux-x86_64.tar.gz
sudo mv caspira /usr/local/bin/
caspira --version
# caspira 0.2.1 (a4f9c12)

Building from source

git clone https://github.com/emkay/caspira
cd caspira
cargo build --release
./target/release/caspira --version

Verify the installation

caspira --version
# caspira 0.2.1 (a4f9c12)

caspira --help

Shell completions

Caspira can generate completions for bash, zsh, and fish:

# zsh
caspira completions zsh > ~/.zfunc/_caspira
# then add `fpath=(~/.zfunc $fpath)` to your .zshrc

# bash
caspira completions bash >> ~/.bashrc

# fish
caspira completions fish > ~/.config/fish/completions/caspira.fish

Platform notes

Windows: Native Windows is not supported. WSL2 works well — install via cargo inside the WSL2 environment.

macOS Gatekeeper: Pre-built binaries are signed with an ad-hoc certificate. If macOS blocks the binary, run xattr -d com.apple.quarantine /usr/local/bin/caspira after moving it into place, or build from source instead.

Next: overview and core concepts →