Using KwikQA
Commands
analyze
$ npx kwikqa analyze [--report <path>] [--local] [--yes]
Diagnoses the failures in a Playwright JSON report.
| Option | Effect |
|---|
--report <path> | Read this report instead of looking in the default locations. |
--local | Build the evidence summary on your machine only. Nothing is sent, and no account is needed. |
--yes | Approve the request preview without asking. Needed when there is no terminal, as in CI. |
fix
$ npx kwikqa fix [--report <path>] [--propose-only] [--retry]
Proposes a repair for a test-support cause, shows the diff and validation commands, and applies the patch if you approve. It needs kwikqa.config.json and an interactive terminal, because a person approves every patch.
| Option | Effect |
|---|
--report <path> | Repair from this report. |
--propose-only | Stop after showing the proposal. Nothing is applied. |
--retry | After a failed validation, re-diagnose from the validation evidence and propose one revised patch. Free. |
validate
$ npx kwikqa validate
Runs the validation plan you approved with the patch. If every required check passes, the patch is kept. Otherwise it is rolled back. It sends nothing and counts nothing.
Account commands
| Command | What it does |
|---|
npx kwikqa init | Propose and write kwikqa.config.json, and offer to ignore .kwikqa/. |
npx kwikqa login | Sign in with GitHub's device flow. |
npx kwikqa status | Show your plan, this month's usage, and when it resets. |
npx kwikqa upgrade [plan] | List plans, or get a checkout link for pro, team, byo, or byo-team. --annual bills yearly (two months free); --seats <n> sets seats on team plans (3 or more). If you already pay, it points you to Billing in the dashboard instead. |
npx kwikqa billing | Open Paddle's customer portal to update your card or download invoices. |
npx kwikqa logout | Revoke this machine's token and remove it. |
npx kwikqa --version | Print the version. |
Environment variables
| Variable | Used for |
|---|
KWIKQA_TOKEN | A CLI or CI token, used instead of the stored sign-in. Create one in the dashboard. |
OPENROUTER_API_KEY | Your OpenRouter key, on the BYOK plans. |
KWIKQA_DIAGNOSIS_MODEL, KWIKQA_REPAIR_MODEL | Your own model routes on the BYOK plans, as author/model@provider. |
PLAYWRIGHT_JSON_OUTPUT_NAME | Where to find the report, if set. |
KWIKQA_CONFIG_DIR | Where the CLI keeps its sign-in. Defaults to ~/.config/kwikqa, or %APPDATA%\kwikqa on Windows. |
Exit codes
| Code | Meaning |
|---|
0 | Success, or an informative result such as diagnosed or inconclusive. |
1 | The repair or validation did not succeed: repair-failed, validation-unavailable, or operation-failed. |
2 | Usage error: an unknown option, or a command that needs a terminal. |
3 | Sign-in, plan, or usage-limit problem. |