Installation

Install Suvadu on macOS or Linux using Homebrew, Cargo, a manual download, or the install script. Suvadu is a single compiled binary with no runtime dependencies.

Requirements

• Operating system: macOS (Apple Silicon or Intel) or Linux (x86_64 or ARM64)
• Shell: Zsh or Bash (Fish is on the roadmap but not yet supported)
• No other runtime dependencies are needed — Suvadu is a statically compiled Rust binary with SQLite embedded

Homebrew (Recommended)

The simplest way to install Suvadu on macOS or Linux with Homebrew:

brew tap AppachiTech/suvadu && brew install suvadu

This installs the suv binary and keeps it updated with brew upgrade suvadu.

Cargo (Rust Package Manager)

If you have the Rust toolchain installed, you can build from source via Cargo:

cargo install suvadu

This compiles Suvadu from source and installs the suv binary into ~/.cargo/bin/. Make sure ~/.cargo/bin is in your PATH.

Install Script

A one-line install script that detects your OS and architecture automatically:

curl -fsSL https://downloads.appachi.tech/suvadu/install.sh | bash

The script downloads the correct binary for your platform and places it in /usr/local/bin/.

Manual Download — macOS

Download the pre-built binary for macOS (works on both Apple Silicon and Intel):

curl -sL https://downloads.appachi.tech/macos/suv-macos-latest.tar.gz | tar xz && sudo mv suv /usr/local/bin/

Manual Download — Linux x86_64

Download the pre-built binary for Linux on x86_64 (AMD64):

curl -sL https://downloads.appachi.tech/linux/suv-linux-latest.tar.gz | tar xz && sudo mv suv /usr/local/bin/

Manual Download — Linux ARM64

Download the pre-built binary for Linux on ARM64 (aarch64):

curl -sL https://downloads.appachi.tech/linux-arm64/suv-linux-arm64-latest.tar.gz | tar xz && sudo mv suv /usr/local/bin/

Verify Installation

After installing with any method, verify that Suvadu is working:

suv status

You should see output showing the Suvadu version, database path, and recording state. If you get a "command not found" error, make sure the directory containing suv (e.g., /usr/local/bin/ or ~/.cargo/bin/) is in your PATH.

Next Step: Shell Integration

Installing Suvadu gives you the suv binary, but commands are not yet recorded automatically. You need to set up shell hooks so that Suvadu captures every command as you type it.

Continue to Shell Integration to complete the setup.