Installation

stagelint is a single binary with no runtime. Install it however your project already installs tools, or download a prebuilt binary directly.

Node

npm

npm install --save-dev @stagelint/stagelint

pnpm

pnpm add -D @stagelint/stagelint

yarn

yarn add --dev @stagelint/stagelint

bun

bun add --dev @stagelint/stagelint

deno

deno add --dev @stagelint/stagelint

If you do not already use a hook manager, add the hook to your prepare script so it installs itself for the whole team:

{
  "scripts": {
    "prepare": "stagelint init"
  }
}

Python

Add it to your project:

uv

uv add --dev stagelint

Poetry

poetry add --dev stagelint

Or install it globally:

uv

uv tool install stagelint

pipx

pipx install stagelint

pip

python -m pip install --user stagelint

Rust

Download a prebuilt binary using cargo-binstall:

cargo binstall stagelint

Or compile it from source:

cargo install stagelint

Homebrew

brew install abemedia/tap/stagelint

Scoop

scoop bucket add abemedia https://github.com/abemedia/scoop-bucket
scoop install stagelint

Nix

nix profile add nur#repos.abemedia.stagelint

Alternatively, add NUR using its installation guide, then add stagelint to your configuration:

{ pkgs, ... }: {
  home.packages = with pkgs; [
    nur.repos.abemedia.stagelint
  ];
}

mise

mise use aqua:abemedia/stagelint

Devbox

devbox add nur#repos.abemedia.stagelint

Install script

Download, verify and install a prebuilt binary:

curl -fsSL https://stagelint.dev/install.sh | sh

It installs to /usr/local/bin when that is writable, otherwise to ~/.local/bin. Set STAGELINT_INSTALL_DIR to choose the directory, or STAGELINT_VERSION to install a specific version:

curl -fsSL https://stagelint.dev/install.sh | STAGELINT_VERSION=0.2.0 sh

Manual install

Download a prebuilt binary or Linux package from the release page.