Installation

witr ships as a single static binary with no runtime dependencies. Pick whichever route fits your machine.

If you use a package manager, prefer it — updates come with the rest of your system. Community packages sometimes lag the GitHub releases, since each ecosystem reviews independently.

Package managers#

Homebrew (macOS and Linux)
brew install witr
APT (Debian, Ubuntu and derivatives)

Available in the official repositories from Ubuntu 26.04 and Debian sid onward, plus derivatives like Kali, Devuan and Raspbian.

sudo apt install witr

The apt version may lag the latest release. For the newest features, use the install script.

Conda, mamba or pixi (all platforms)
conda install -c conda-forge witr
mamba install -c conda-forge witr
pixi global install witr
Arch Linux (AUR)
yay -S witr-bin
paru -S witr-bin
Winget or Scoop (Windows)
winget install -e --id PranshuParmar.witr
scoop install main/witr
Chocolatey (Windows)
choco install witr
MacPorts (macOS)
sudo port install witr
FreeBSD Ports
pkg install witr
npm (all platforms)
npm install -g @pranshuparmar/witr
Guix, AOSC, uniget, aqua, brioche, mise
guix install witr
oma install witr
uniget install witr
aqua g -i pranshuparmar/witr && aqua i pranshuparmar/witr
brioche install -r witr
mise use github:pranshuparmar/witr

Install script#

The fastest route if you do not use a package manager.

Unix (Linux, macOS, FreeBSD)

curl -fsSL https://raw.githubusercontent.com/pranshuparmar/witr/main/install.sh | bash

The script detects your OS and CPU architecture, downloads the latest released binary and man page, installs to /usr/local/bin/witr, and puts the man page in /usr/local/share/man/man1/. Override the location with INSTALL_PREFIX.

Windows (PowerShell)

irm https://raw.githubusercontent.com/pranshuparmar/witr/main/install.ps1 | iex

Downloads and checksum-verifies the latest release, extracts witr.exe to %LocalAppData%\witr\bin, and adds that directory to your user PATH.

From source#

go install github.com/pranshuparmar/witr/cmd/witr@latest

The binary lands in $GOPATH/bin or $HOME/go/bin. Make sure that directory is on your PATH.

Run without installing#

nix run github:pranshuparmar/witr -- --help
pixi exec witr --help

Prebuilt packages#

Native .deb, .rpm and .apk packages are attached to every GitHub release.

sudo apt install ./witr-*.deb
sudo rpm -i ./witr-*.rpm
sudo apk add --allow-untrusted ./witr-*.apk

Verify and finish setup#

witr --version
man witr

Tab completion works in bash, zsh, fish and PowerShell:

echo 'eval "$(witr completion bash)"' >> ~/.bashrc
echo 'eval "$(witr completion zsh)"' >> ~/.zshrc
witr completion fish > ~/.config/fish/completions/witr.fish

Uninstall#

If you installed through a package manager, use its uninstall command (brew uninstall witr and so on). For a script or manual install:

sudo rm -f /usr/local/bin/witr /usr/local/share/man/man1/witr.1
Remove-Item -Recurse -Force "$env:LocalAppData\witr"

Next: run your first trace, or explore the interactive TUI.

Powered by Docsbook