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.

Already have shell history? After setting up shell integration, you can import your existing Zsh or Bash history with suv import. See Import & Export for details.

Frequently Asked Questions

Which installation method should I use?

On macOS and Linux, Homebrew is the recommended path — it installs the suv binary and keeps it current with brew upgrade suvadu. Use Cargo only if you already have the Rust toolchain and prefer building from source. The install script and manual downloads are best for servers or CI environments where Homebrew isn't available.

Do I need Rust installed to use Suvadu?

No. Suvadu ships as a single statically compiled binary with SQLite embedded and no runtime dependencies. You only need the Rust toolchain if you choose the cargo install suvadu method, which builds from source.

Does Suvadu run on Windows?

Suvadu targets macOS and Linux. On Windows, run it inside WSL2, where the Linux x86_64 build works the same as on a native Linux machine.

How do I fix "suv: command not found"?

This means the directory containing the suv binary isn't in your PATH. Add the relevant directory — /usr/local/bin for Homebrew, manual, or install-script installs, or ~/.cargo/bin for Cargo — to your PATH, then open a new terminal and run suv status again.

How do I update or uninstall Suvadu later?

With Homebrew, run brew upgrade suvadu. For other install methods and uninstall instructions, see Update & Uninstall.