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-onexits 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 -gWorks 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-onexits 1 on critical or high findings.
How it works
- 1. Start your app with the dev server your project already uses.
- 2. Run Sniff from a second terminal and give it the address of the app.
- 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.pngMore ways to install
Claude Code plugin
claude plugin marketplace add Aboudjem/10xclaude plugin install sniff@10xAgent skill, for Cursor, Codex and other agents
npx skills add Aboudjem/sniffMCP (Model Context Protocol) server
claude mcp add sniff-qa -- npx -y sniff-qa --mcpCommand line, with no editor
npx sniff-qa --url http://localhost:3000The 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.