Command reference

The CLI exposes both mm and llmstatus — same binary, pick your favorite.

Commands

Command	What it does
`mm status [dir]`	Free offline model-health check — no account needed
`mm`	Launch the TUI (inventory · scan · what’s-new · alerts · account)
`mm login [api_key]`	Browser sign-in with polling (or paste a key)
`mm signup`	Create an account in the browser
`mm scan [dir]`	Scan + upload usages; interactive TUI, or `--ci`/`--json` for pipelines
`mm sources`	List detection sources and whether each can run on this machine
`mm upgrade`	Open Stripe checkout, poll until Pro is active
`mm logout`	Forget the saved API key
`mm help`	Print help

Common flags


--api URL               override the API base URL (default https://llmstatus.ai)
--key KEY               use this API key for this call (won't be saved)
--project ID-OR-NAME       pick the project to scan into
--yes                     don't prompt — non-interactive mode
--json                    machine-readable output
--ci                      shorthand for --yes --json
--dry-run                 print what would upload, don't upload
--offline                 use the cached registry only (mm status)
--sources LIST          which scan sources to run (default: filesystem)
                          values: filesystem, env, aws-secrets, k8s, helm, sql, all
--region REGION              AWS region for aws-secrets
--namespace NS          k8s namespace
--kube-context CONTEXT        kubectl context
--db DSN                postgres dsn for the sql source
--sql-table TABLE           narrow the sql source to one table

Environment variables

Env var	What it does
`LLMSTATUS_REGISTRY_URL`	Override the CDN base for the signed registry (point at a private mirror)
`LLMSTATUS_NO_OPEN`	Set to anything truthy to skip the auto-open of browser tabs (login, upgrade)
`MM_VERSION`	Used by `install.sh` — pin a specific version (default: `latest`)
`MM_INSTALL_DIR`	Used by `install.sh` — where to install the binary (default: `/usr/local/bin`)
`MM_CDN`	Used by `install.sh` — override the binary CDN base (default: `https://cdn.llmstatus.ai`)

Exit codes

Code	Meaning
`0`	Success
`1`	Error (network, parse, etc. — message on stderr)
`2`	`--check` mode found a retiring or retired model (CI-friendly)

Examples


# Snapshot a single repo, free, no account:
mm status
 
# Same but only use the cache (no network):
mm status --offline
 
# Full project scan + non-interactive upload to a named project:
mm scan --ci --project web-app
 
# Preview what scan would upload — including secret-source candidates:
mm scan --sources all --dry-run
 
# Use a private API mirror:
LLMSTATUS_API_URL=https://api.acme-internal.com mm scan
 
# CI: fail the build if anything is retiring or retired:
npx @modelstatus/cli scan --check