Installation

qtz-discovery-cli is distributed as a single static binary. Download the binary for your platform, make it executable, and move it onto your PATH. All binaries are available on the CLI download page.

macOS

Apple Silicon (arm64)

curl -Lo qtz-discovery-cli https://quantizant.io/downloads/releases/qtz-discovery-cli-darwin-arm64
chmod +x qtz-discovery-cli
sudo mv qtz-discovery-cli /usr/local/bin/

Intel (amd64)

curl -Lo qtz-discovery-cli https://quantizant.io/downloads/releases/qtz-discovery-cli-darwin-amd64
chmod +x qtz-discovery-cli
sudo mv qtz-discovery-cli /usr/local/bin/

Linux

x86_64 (amd64)

curl -Lo qtz-discovery-cli https://quantizant.io/downloads/releases/qtz-discovery-cli-linux-amd64
chmod +x qtz-discovery-cli
sudo mv qtz-discovery-cli /usr/local/bin/

To install to a user-local directory instead:

mkdir -p ~/.local/bin
curl -Lo ~/.local/bin/qtz-discovery-cli https://quantizant.io/downloads/releases/qtz-discovery-cli-linux-amd64
chmod +x ~/.local/bin/qtz-discovery-cli

ARM64

curl -Lo qtz-discovery-cli https://quantizant.io/downloads/releases/qtz-discovery-cli-linux-arm64
chmod +x qtz-discovery-cli
sudo mv qtz-discovery-cli /usr/local/bin/

Windows

Download qtz-discovery-cli-windows-amd64.exe from the CLI download page, rename it to qtz-discovery-cli.exe, and add the folder containing it to your PATH.

From PowerShell (run as Administrator):

Invoke-WebRequest -Uri "https://quantizant.io/downloads/releases/qtz-discovery-cli-windows-amd64.exe" `
  -OutFile "$env:ProgramFiles\qtz-discovery-cli\qtz-discovery-cli.exe"
# Then add $env:ProgramFiles\qtz-discovery-cli to your PATH

Verify Installation

qtz-discovery-cli --version

You should see output like:

qtz-discovery-cli version 0.1.0

Connect to the Portal (optional)

By default, the CLI runs standalone. To upload findings to the portal and use AI analysis, pass --upload along with your credentials: 

qtz-discovery-cli scan source ./my-repo \
  --server https://discovery.quantizant.io/ \
  --org-id your-org-id \
  --api-key your-api-key \
  --upload

The optional --source-id <UUID> flag controls how the backend handles the result:

  • Without --source-id — the backend automatically creates a new source and records this scan as its first job.
  • With --source-id <UUID> — the scan result is imported as a new scan job under the specified existing source. Use this to accumulate scan history for a repository or asset you have already registered in the portal. 
# Let the backend create a new source automatically
qtz-discovery-cli scan source ./my-repo \
  --server https://discovery.quantizant.io/ \
  --org-id your-org-id \
  --api-key your-api-key \
  --upload

# Import into an existing source
qtz-discovery-cli scan source ./my-repo \
  --server https://discovery.quantizant.io/ \
  --org-id your-org-id \
  --api-key your-api-key \
  --source-id your-source-id \
  --upload

Find your source UUID in the portal under Sources → <source name> → Settings. See Configuration for the full config file reference.