Your agent said it works. Prove it.
prq checks what a coding agent says it finished. It locks the claims in the agent's own words, runs independent browser or command checks, and reports evidence behind each verdict in the terminal and JSON. The tester never sees the author's reasoning. A separate judge reviews the evidence without source files.
Use Node.js 24.8+, npm, Git, and an OpenAI or OpenRouter API key with required model access. Work inside your project's Git repository with a committed HEAD and installed dependencies.
Install the CLI once in your project:
npm install --save-dev @alterok/prqChoose direct OpenAI with OPENAI_API_KEY, or set PRQ_PROVIDER=openrouter, OPENROUTER_API_KEY, and PRQ_MODEL to your chosen OpenRouter model. Provider and model flags override environment settings. Direct OpenAI retains Decisions classification and judgment by default. OpenRouter uses structured model assessments; OpenAI can opt in with --decision-mode structured. Models must support structured output; browser testing and screenshot judgment also need image input.
For browser checks, also prepare the project:
export OPENAI_API_KEY="your-key"
npm install --save-dev e2e@0.22.0 @e2e-dev/web@0.15.4 @ai-sdk/openai@4.0.106 ai@7.0.158
npx --no-install e2e-web install chromium
npx prq initStart your app with its usual development command. Save the agent's completion message as done.md, then run:
npx prq --claims done.md --app-url http://localhost:3000prq uses an already running app. Command-only checks can skip browser installation and init.
The builder can supply exact claims in a versioned JSON handoff, then require a current report before creating the PR:
npx prq --project service --claims-json .pr/claims.json --strict --summary
npx prq rerun --run <report> --strict --summary
npx prq gate <report> --claims-json .pr/claims.json --jsonservice is an example project directory relative to the repository root. Omit --project to use your current directory. Follow the agent workflow for the handoff format, custom test commands and how to wire the gate into any agent's workflow. Test-suite claims need structured evidence; Vitest and Playwright adapters are available. The gate is local and makes no model calls. When the handoff includes the original task, PRQ assesses missing requirements and independently selects checks. This assessment can still miss omissions and does not replace CI and review.
Results appear in the terminal. Use --json for the complete report or --summary for a compact agent summary. No report server, generated HTML or automatic browser opening is needed.
npx prq --claims done.md --json
npx prq show
npx prq show --jsonReports stay in .pr/runs/<run-id>/. Models receive the completion message and selected evidence. See privacy and execution boundaries before sharing application data.
npx prq fix # broken claims as a prompt for your agent
# Apply the fix. Commit it before command checks.
npx prq rerun # same locked claims, fresh evidence
npx prq show # inspect the latest report in the terminalBrowser setup actions may replay from cache. Assertions run live.
Version 0.2 changes --json from a compact summary to the full report; use --summary for the former view. Historical 0.1 reports remain readable. See the migration notes.
| Verdict | Meaning |
|---|---|
| ✓ held | A completed check and its evidence support the claim. |
| ✗ broken | A completed check or evidence contradicts it. |
| ? needs a human | The claim is subjective or evidence is ambiguous. |
| ○ unverified | Execution or evidence was insufficient to decide. |
User guide · Spec · Benchmarks · Contributing
Run prq eval to check the deterministic safeguards without a key. Evaluation docs describe fixed cases, JSON output and explicit paid provider judgment.