JSPM

@qlens/cli

0.2.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 4
  • Score
    100M100P100Q34147F
  • License MIT

Command-line interface for QualityPilot (qlens.dev) — scan repos, trigger AI auto-fixes, and check API key status from any terminal.

Package Exports

  • @qlens/cli
  • @qlens/cli/src/cli.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@qlens/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@qlens/cli

npm version npm downloads license Powered by QualityPilot

The qlens CLI brings QualityPilot to your terminal. Check the test-health grade of any GitHub repo, run a failing test through the AI Bug Detective, and verify your API key — without leaving the shell.

Install in 30 seconds

npm install -g @qlens/cli   # requires Node.js 20+
qlens demo                  # see an AI fix on a real repo, no setup

Or, even faster, with no install:

npx qlens demo

That picks a curated public repo, runs the same AI fix pipeline our paying customers use, and prints the proposed change in your terminal. No sign-in required.

Commands

qlens demo

Runs an AI fix proposal on a randomly selected curated repo (e.g. facebook/react, vercel/next.js). Useful for showing the product to a teammate without making them sign up first.

$ qlens demo
Demoing AI fix on facebook/react...
===========================================================
AI fix proposal — facebook/react
===========================================================
File:       packages/react-dom/src/__tests__/ReactDOMFizzServer-test.js
Confidence: 78%

Reasoning:
  The arbitrary 100ms timeout makes this test flake under CI load. Replacing
  it with an explicit waitFor(...) for the rendered marker is deterministic.

Proposed diff:
- await new Promise(r => setTimeout(r, 100));
+ await waitFor(() => screen.getByText('hydrated'));

Remaining free attempts today: 2

===========================================================
→ Want this on YOUR repo? `qlens login` then `qlens auto-fix <test-file>`

Add --json to dump the raw API response (useful for piping into jq).

The free tier is 3 attempts per IP per day (shared with the website's /scan/{owner}/{repo}/try-fix page).

qlens scan

Reads the current directory's .git/config, extracts the GitHub owner/repo, and prints the latest QualityPilot grade.

$ qlens scan
i-kosheliev/qualitypilot
  B  Test health grade  (71/100)
  Full report: https://www.qlens.dev/scan/i-kosheliev/qualitypilot

qlens auto-fix <test-file>

Sends a failing test file to the public AI Bug Detective playground and prints a proposed fix.

qlens auto-fix tests/cart.test.ts
qlens auto-fix tests/cart.test.ts -p src/cart.ts          # provide production source for better fixes
qlens auto-fix tests/checkout.spec.ts -f playwright       # explicit framework hint
qlens auto-fix tests/test_users.py -f pytest

The free tier allows 5 attempts per day per IP. Set QLENS_API_KEY to scale beyond that as the API gains key-aware access.

qlens status

Confirms your API key works and shows your recent auto-fix activity.

$ qlens status
QualityPilot CLI status
  API key: qlens_ab…1234
  Status:  key is valid
  Auto-fixes opened (30d): 12
  Auto-fixes merged (30d): 7

qlens login

Walks you through obtaining an API key — visit qlens.dev/dashboard/keys, then qlens config set api-key <your-key>.

qlens config set api-key <key> / qlens config get api-key

Stores the key at ~/.qlens/config.json (mode 0600 — owner read/write only). The CLI also honours QLENS_API_KEY from the environment, which takes priority over the file.

Environment variables

Var Purpose
QLENS_API_KEY Optional. Overrides the key stored in ~/.qlens/config.json. Same convention as the reporter packages.
QLENS_API_URL Optional. Override the base URL (handy for staging or a local next dev). Defaults to https://www.qlens.dev.
NO_COLOR Standard. Disables ANSI colour output.

Exit codes

  • 0 — happy path (scan rendered, fix returned, key valid, …).
  • 1 — user-facing error (no git remote, key invalid, network failure, no fix returned).
  • 2 — argument error (missing required argument; commander default).

set -e-friendly out of the box.

Need a key?

Sign in at qlens.dev with GitHub and create one at /dashboard/keys. Free tier includes 10 auto-fixes/month; the playground is anonymous with 5 attempts per day.

Docs

Full command reference and integration guide: qlens.dev/docs/cli.

License

MIT — built by IK Lab.