Install Qualflare CLI - macOS, Linux, Windows

Install the Qualflare CLI (qf) on macOS, Linux, or Windows. Step-by-step guide for Homebrew and binary download installation methods.

Installation

Install qf, the Qualflare CLI tool, on your preferred platform. The CLI is available for macOS, Linux, and Windows across amd64 and arm64 architectures.

AI Command

Paste this prompt into your AI coding agent to install qf automatically:

Install the Qualflare CLI (`qf`) on my machine.

1. Detect my operating system (macOS, Linux, or Windows) and CPU architecture
   (amd64 or arm64).
2. If Homebrew is available (macOS/Linux), run: brew install qualflare/tap/qf
3. Otherwise, open https://github.com/qualflare/qualflare-cli/releases/latest,
   download the asset matching my OS and architecture
   (qf_<version>_<os>_<arch>.tar.gz, or .zip on Windows), extract it, and move
   the `qf` binary into a directory on my PATH.
4. Run `qf version` to confirm the install succeeded.

Homebrew (macOS/Linux)

The easiest way to install qf on macOS or Linux is via Homebrew:

brew install qualflare/tap/qf

To upgrade:

brew upgrade qualflare/tap/qf

Binary Download

Download the precompiled binary from the GitHub releases page. Replace VERSION in the commands below with the version shown on that page (e.g. 0.1.8).

macOS

# For Apple Silicon (M1/M2/M3)
VERSION=0.1.8
curl -L "https://github.com/qualflare/qualflare-cli/releases/download/v${VERSION}/qf_${VERSION}_darwin_arm64.tar.gz" -o qf.tar.gz
tar -xzf qf.tar.gz
sudo mv qf /usr/local/bin/

# For Intel
VERSION=0.1.8
curl -L "https://github.com/qualflare/qualflare-cli/releases/download/v${VERSION}/qf_${VERSION}_darwin_amd64.tar.gz" -o qf.tar.gz
tar -xzf qf.tar.gz
sudo mv qf /usr/local/bin/

Linux

# For AMD64
VERSION=0.1.8
curl -L "https://github.com/qualflare/qualflare-cli/releases/download/v${VERSION}/qf_${VERSION}_linux_amd64.tar.gz" -o qf.tar.gz
tar -xzf qf.tar.gz
sudo mv qf /usr/local/bin/

# For ARM64
VERSION=0.1.8
curl -L "https://github.com/qualflare/qualflare-cli/releases/download/v${VERSION}/qf_${VERSION}_linux_arm64.tar.gz" -o qf.tar.gz
tar -xzf qf.tar.gz
sudo mv qf /usr/local/bin/

Windows

Download the appropriate ZIP from the GitHub releases page (replace 0.1.8 with the current version):

qf_0.1.8_windows_amd64.zip — 64-bit Windows
qf_0.1.8_windows_arm64.zip — ARM Windows

Extract the archive and move qf.exe to a directory in your PATH.

Verify Installation

Confirm that qf is installed correctly:

qf version

You should see output similar to:

qf 0.1.8 (commit: 7ba8c3a, built: 2026-05-18T21:00:25Z, darwin/arm64, go1.25.10)

Here's what that looks like in a terminal:

Terminal output of qf version showing the installed CLI version, commit, build date, and platform

Upgrading

Homebrew: Run brew upgrade qualflare/tap/qf
Binary: Download the latest release and replace the existing binary

Next Steps

After installing qf:

Learn about the collect command
Explore other commands
Set up CI/CD integration

Install Qualflare CLI - macOS, Linux, Windows

On this page