Get Started

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:

bash
brew install qualflare/tap/qf

To upgrade:

bash
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 ​

bash
# 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 ​

bash
# 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:

bash
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)

Upgrading ​

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

Next Steps ​

After installing qf: