Assay
CLI Setup

Verify Your Code with the CLI

Find bugs that tests miss, linters ignore, and code review overlooks. 5 minutes to set up.

Before you start

  • Node.js 20+ — check with node --version
  • A code project you want to verify (any language)
1

Create your Assay account

Sign up free. No credit card required.

Create Free Account

Already have an account? Log in

2

Copy your API key

Go to API Keys, click Generate New Key, copy the lk_live_ key.

Save your key — you cannot see it again after leaving the page.

bash
export ASSAY_API_KEY="lk_live_your_key_here"
3

Open your project

Navigate to your project root in the terminal.

bash
cd ~/projects/my-web-app
4

Run the assessment

Scans your project, extracts claims, verifies each one. No install needed.

bash
npx tryassay assess .

Point at a subfolder: npx tryassay assess ./src

Pipeline

  1. Scan — Indexes files and codebase structure
  2. Extract — Finds implicit claims (security, correctness, edge cases)
  3. Verify — Checks each claim against the implementation
  4. Report — Shows pass/fail and how to fix
5

Read your results

text
Assay Assessment Report
=======================
Project: my-web-app
Files scanned: 47
Claims extracted: 312

Verification Results
--------------------
  Passed:    278 (89.1%)
  Failed:     23 (7.4%)
  Partial:    11 (3.5%)

Critical Issues (3)
--------------------
  CLAIM-042  [security]   SQL injection in user search endpoint
  CLAIM-108  [correctness] Payment calculation uses wrong tax rate
  CLAIM-201  [security]   API key exposed in client-side bundle

High Issues (8)
--------------------
  CLAIM-015  [correctness] Pagination returns duplicate records
  CLAIM-067  [edge-case]  Empty cart checkout not handled
  ...

Full report saved to: .assay/iterations/report-2026-02-20.json
Passed

Claims are correct. Code does what it says.

Failed

Bugs. Implementation doesn't match claims. Fix first.

Partial

Partially correct. Usually a missing edge case.

Critical

Security vulnerabilities or data loss risks.

Full report saved to .assay/iterations/. Re-run after fixing to track improvements.

Other commands

CommandWhat it does
npx tryassay assess .Full assessment — scan, extract, verify, report
npx tryassay initSet up a project config file (interactive)
npx tryassay verifyVerify claims from a previous extraction
npx tryassay reportGenerate a report from verification results
npx tryassay reverseGenerate verified code from a task description
npx tryassay --helpSee all available commands
Prefer your editor? MCP Setup Guide