Installation
Badness is distributed as a single binary, badness. The current version is 0.29.0. Use the installer below or choose a package manager you already use.
Install script
The installer selects the release for your platform and installs it in a directory under your user account:
curl --proto '=https' --tlsv1.2 -sSf https://badness.dev/install | shpowershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://badness.dev/install.ps1 | iex"The default installation directory is ~/.local/bin on macOS and Linux, or %LOCALAPPDATA%\Programs\badness\bin on Windows. Make sure that directory is on your PATH before running badness from a terminal.
Homebrew
If you use Homebrew, install Badness from the jolars/tap tap:
brew install jolars/tap/badnessnpm
With Node.js and npm installed, install the badness command globally:
npm install -g badnessThe package includes a prebuilt binary for your platform, so no Rust toolchain is required.
PyPI
Install Badness as a command-line tool with uv:
uv tool install badnessIf you use pipx instead:
pipx install badnessThe PyPI package provides prebuilt binary wheels for supported platforms, so you do not need a Rust toolchain to install a wheel.
Cargo
With a Rust toolchain installed, build and install the published release from crates.io:
cargo install badnessCargo compiles Badness from source and installs it in Cargo’s bin directory.
AUR
On Arch Linux, install the badness-bin package from the AUR. With the yay AUR helper:
yay -S badness-binThis package installs a prebuilt binary.
Nix
Start a temporary shell with Badness available:
nix shell nixpkgs#badnessFor a persistent NixOS installation, add Badness to your system configuration and rebuild:
environment.systemPackages = [ pkgs.badness ];mise and Aqua
mise can install Badness through its Aqua backend:
mise use aqua:jolars/badnessCommit the resulting mise.toml to share the selected version. With Aqua directly, run aqua init if the project has no aqua.yaml, then add and install Badness:
aqua g -i jolars/badness
aqua installCommit aqua.yaml to share the selected version. Both tools use the jolars/badness registry entry.
VS Code and Open VSX
Install the Badness extension from the VS Code Marketplace or Open VSX. The extension also works in Positron and Cursor.
The extension bundles a platform-specific badness binary and starts the language server automatically, so you do not need to install the CLI separately to use it in your editor. See editor setup for configuration.
Mason (Neovim)
If you use Mason in Neovim, install Badness from its registry:
:MasonInstall badnessThen follow the Neovim setup to enable the language server.
Prebuilt binaries
To install manually, download the archive for your operating system and architecture from the releases page. Extract it and place the badness binary (badness.exe on Windows) in a directory on your PATH.
From source
Badness is written in Rust. With a Rust toolchain installed, build from a checkout:
git clone https://github.com/jolars/badness
cd badness
cargo build --releaseThe build places the binary at target/release/badness. Copy it to a directory on your PATH, or run it in place.
To install it into Cargo’s bin directory instead:
cargo install --path .Verifying the install
badness --versionThis should print badness 0.29.0.