SKIP TO CONTENT

Sniff

  • Plugin
  • Skill
  • MCP server
  • CLI

Catch broken pages in your web app before users do.

  • Bugs caught before users

    It found 21 of 21 bugs we planted on purpose, with 0 false findings.

  • Steps to repeat it

    Each page bug comes with its route, the steps to repeat it, and a fix.

  • Broken merges blocked

    --fail-on exits 1 on critical or high bugs, so your automatic checks stop the merge.

Works with: Any MCP (Model Context Protocol) client, any agent that reads skills, or the command line. Tested: Claude Code, Codex CLI. Not tied to one model: the walk uses a browser.

Try it with no install: npx sniff-qa --url http://localhost:3000.

Pick your agent

npx skills add Aboudjem/sniff -g

Works in more than 70 agents: pick yours in the menu. Supported agents (new tab)Installs for all your projects. Only this project: drop -g.This installs the skills only. The MCP server is one more line: pick your agent.Its page on skills.sh (new tab)

Limit: Sniff submits real forms, so use a dev or staging app.

github.com/Aboudjem/sniff (new tab)Version 0.9.5

What it does

  • Find bugs before your users do. It clicks buttons and fills forms in a real browser.
  • Fix fast, without hunting. Each page finding names the route, the steps and a fix.
  • See the proof. Most findings come with a screenshot.
  • Trust the results. It found 21 of 21 planted bugs, with 0 false findings (npm run build && npm run proof).
  • Block bad merges. --fail-on exits 1 on critical or high findings.

How it works

  1. 1. Start your app with the dev server your project already uses.
  2. 2. Run Sniff from a second terminal and give it the address of the app.
  3. 3. Read the findings. They print grouped by severity, each with its steps, a fix and a screenshot path.

Example

The top of a real run from the README, on the repository's test app with planted bugs. The verdict comes first.

$ npx sniff-qa --url http://localhost:4517

  VERDICT  FAIL: 26 findings (1 critical, 13 high, 11 medium, 1 low), 1 low-confidence finding hidden
  Walked 12 pages, checked 13 links, in 55.2s. --all shows the hidden one.

  Fix these first:
    1. Page returns HTTP 500 on /crash  [critical]
    2. Page returns HTTP 404 on /dead  [high]
    3. Page returns HTTP 404 on /missing  [high]

  CRITICAL (1)
    • [confirmed] Page returns HTTP 500
      /crash  (route/broken-page)
        - Navigate to /crash
        - Server responded with HTTP 500
      shot: sniff-reports/crawl/_crash-desktop.png

More ways to install

Claude Code plugin

claude plugin marketplace add Aboudjem/10x
claude plugin install sniff@10x

Agent skill, for Cursor, Codex and other agents

npx skills add Aboudjem/sniff

MCP (Model Context Protocol) server

claude mcp add sniff-qa -- npx -y sniff-qa --mcp

Command line, with no editor

npx sniff-qa --url http://localhost:3000

The npm package is sniff-qa. Do not run npx sniff: that is an unrelated package.

Limits

  • It submits real forms. Use a dev or staging app, not production.
  • It needs your app running. Without it, it only reads your source.
  • The first walk downloads about 440 MB once. That is about 730 MB on disk on a Mac.
  • It checks external links, so it sends requests to the sites you link to.
Good for
Finding broken pages, dead buttons and lost form state in a dev or staging app.
Not for
A production app: a walk submits real forms.

Questions

What is Sniff?

Sniff is an open-source tool that tests a running web app in a real browser. It reports each bug with the steps that reproduce it.

How do I install Sniff in Claude Code?

Run claude plugin marketplace add Aboudjem/10x, then claude plugin install sniff@10x. You can also add it as an MCP (Model Context Protocol) server with claude mcp add.

Which agents does Sniff work with?

Tested on 17 November 2026: Claude Code and Codex CLI used its MCP server, and Gemini CLI accepted its extension. The MCP server works in any MCP client, and the tool also runs from a terminal.

Is Sniff free?

Yes, it is open source under the Apache-2.0 license. It needs no API key and no account.