Update & Uninstall

Keep Suvadu up to date with one command. Your data is never touched during updates, and uninstalling leaves your history intact so you can come back anytime.

Update Methods

Choose whichever method matches how you originally installed Suvadu. All methods update the binary only — your database, config, and shell integration remain untouched.

Self-Update (Recommended)

The built-in self-update command auto-detects your platform, downloads the latest release, verifies the binary with Minisign, and replaces the existing binary in place.

suv update

This is the fastest method and works regardless of how you originally installed Suvadu.

Homebrew

If you installed via Homebrew, update through the standard Homebrew workflow.

brew update && brew tap AppachiTech/suvadu && brew upgrade suvadu

Cargo

If you installed from source via Cargo, reinstall to get the latest version from crates.io.

cargo install suvadu

Install Script

Re-running the install script will download and replace the binary with the latest version.

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

What Happens During an Update

• Your data is never touched. The database and config are stored separately from the binary (see paths below), so updating only replaces the suv executable.
• No need to re-run suv init. Your shell integration (the hook in .zshrc / .bashrc) does not change between versions.
• No need to re-source your shell config. The updated binary is picked up the next time you run any suv command.

Checking Your Version

Verify which version you are running at any time.

suv version

Shell Completions

Suvadu can generate shell completion scripts for tab-completing commands and flags. After updating, you may want to regenerate completions if new subcommands were added.

suv completions <SHELL>

See the Completions page for detailed setup instructions for Zsh, Bash, and Fish.

Man Page

Generate a man page for offline reference.

suv man

This outputs the man page to stdout. To install it system-wide:

suv man > /usr/local/share/man/man1/suv.1

Uninstalling

To remove Suvadu, run the built-in uninstall command.

suv uninstall

This removes the suv binary and any shell hooks from your config files. Your data is preserved — the history database and configuration remain on disk so you can reinstall later without losing anything.

Data Locations

If you want a complete removal, delete the data directory manually after running suv uninstall:

# macOS
rm -rf ~/Library/Application\ Support/suvadu/

# Linux
rm -rf ~/.local/share/suvadu/