← all repositories
reticlehq/reticle

The QA your coding agent never hired

Reticle drives your real running app and returns pass/fail with the exact file:line to fix — so "done" has to mean done.

★1.3k stars TypeScript Coding AssistantsLLMOps · Eval
reticle
Not currently ranked.
star history

What it does

Reticle is an MCP server that lets coding agents (Claude Code, Cursor, Windsurf, and a long list of others) verify their own work against the actual running app. You describe what should be true in plain English; it clicks through the app, watches network requests, console output, app state, and the React commit stream, and returns a verdict — pass, fail, or “couldn’t tell” — with evidence and the source line that caused the failure.

The interesting bit

It observes from inside the app rather than squinting at pixels from outside like Playwright or browser agents do. That’s how it catches the bugs that never reach the screen: a Pay button silently returning 500, a form firing its request twice, a badge showing “12” while the store holds 0. The verdict names PayButton.tsx:31, not “something looks off.”

Key highlights

  • No test syntax to write — assertions are plain-English instructions to your agent.
  • Beyond bug-checking: security behaviour (403s, forbidden calls, CSP violations), accessibility, performance metrics, SEO, and persona-driven exploration with isolated browser contexts per role.
  • gate in CI works out which saved flows your edits affect and fails the build unless a passing verification covers each one — an agent can’t declare victory by reasoning about its own diff.
  • The installer is unusually transparent: a --dry-run prints every file it would touch, and it writes nothing outside agent configs and ~/.reticle.
  • Explicitly complements Playwright rather than replacing it — Playwright for sites you don’t own, Reticle inside your agent’s loop.

Caveats

  • It edits your build config and pre-approves its own MCP tools in agents with per-server rules — reasonable, but worth knowing before running a pipe-to-shell installer.
  • Requires Node 20.11+, and Codex CLI users get four lines to paste manually rather than automatic registration.
  • The README’s benchmark section is truncated here, so claims about speed and token cost can’t be verified from this text alone.

Verdict

If an agent writes code in your repo and you’ve become its QA department, this is aimed squarely at you. If you don’t use coding agents or only test sites you don’t own, stick with Playwright.

Frequently asked

What is reticlehq/reticle?
Reticle drives your real running app and returns pass/fail with the exact file:line to fix — so "done" has to mean done.
Is reticle open source?
Yes — reticlehq/reticle is an open-source project tracked on heatdrop.
What language is reticle written in?
reticlehq/reticle is primarily written in TypeScript.
How popular is reticle?
reticlehq/reticle has 1.3k stars on GitHub.
Where can I find reticle?
reticlehq/reticle is on GitHub at https://github.com/reticlehq/reticle.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.