Installation

The Pullminder CLI runs on macOS, Linux, and Windows. Choose whichever installation method fits your workflow. All methods produce the same pullminder binary.

Quick install (curl)

The install script detects your OS and architecture, downloads the correct binary, and places it on your PATH.

curl -fsSL https://get.pullminder.com | sh

On macOS and Linux this installs to /usr/local/bin. You can set a custom location with the INSTALL_DIR environment variable:

curl -fsSL https://get.pullminder.com | INSTALL_DIR=$HOME/.local/bin sh

Homebrew (macOS and Linux)

brew install pullminder/tap/pullminder

Upgrade to the latest version at any time:

brew upgrade pullminder

npm

If you already have Node.js installed, you can install the CLI as a global npm package:

npm install -g @pullminder/cli

Or run it without installing via npx:

npx @pullminder/cli check

This is especially useful in CI environments where you want to pin a version in package.json rather than manage a standalone binary.

Manual binary download

Pre-built binaries are published on the GitHub releases page for every supported platform.

Platform	Architecture	Filename
Linux	x86_64	pullminder-linux-amd64
Linux	ARM64	pullminder-linux-arm64
macOS	Intel (x86_64)	pullminder-darwin-amd64
macOS	Apple Silicon	pullminder-darwin-arm64
Windows	x86_64	pullminder-windows-amd64.exe

After downloading, make the binary executable (macOS/Linux) and move it to a directory on your PATH:

chmod +x pullminder-darwin-arm64
sudo mv pullminder-darwin-arm64 /usr/local/bin/pullminder

On Windows, rename the file to pullminder.exe and add the containing folder to your system PATH.

Verify the installation

Run the following command to confirm the CLI is installed and working:

pullminder --version

You should see output like:

pullminder v1.2.0 (abc1234)

Shell completions

Generate completion scripts for your shell:

# Bash
pullminder completion bash > /etc/bash_completion.d/pullminder

# Zsh
pullminder completion zsh > "${fpath[1]}/_pullminder"

# Fish
pullminder completion fish > ~/.config/fish/completions/pullminder.fish

# PowerShell
pullminder completion powershell > pullminder.ps1

After generating the script, restart your shell or source the file to enable tab completions for all commands and flags.

Next steps

• Command reference — full list of every command and flag.
• CI integration — run Pullminder in GitHub Actions, GitLab CI, and other pipelines.