sniff-qa 0.5.2 → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/plugin.json +2 -2
- package/CHANGELOG.md +87 -1
- package/README.md +274 -342
- package/SECURITY.md +3 -3
- package/dist/chunk-LJYT4MD5.js +1246 -0
- package/dist/chunk-LJYT4MD5.js.map +1 -0
- package/dist/cli/index.js +41 -12
- package/dist/cli/index.js.map +1 -1
- package/dist/crawl-666NLYDC.js +11 -0
- package/dist/crawl-666NLYDC.js.map +1 -0
- package/dist/crawl-command-3OB4IUBU.js +54 -0
- package/dist/crawl-command-3OB4IUBU.js.map +1 -0
- package/dist/{discover-ENPRVN5A.js → discover-Q363YJ5X.js} +2 -2
- package/dist/{domain-UQ34YE4B.js → domain-NNL2PPRK.js} +1 -1
- package/dist/index.d.ts +94 -1
- package/dist/index.js +9 -1
- package/dist/index.js.map +1 -1
- package/dist/mcp/server.js +76 -6
- package/dist/mcp/server.js.map +1 -1
- package/dist/{model-X5J2JR5U.js → model-2DTSAX7T.js} +1 -1
- package/dist/{quality-run-6SXCN5CD.js → quality-run-LLBZZI7X.js} +2 -2
- package/dist/{repo-analyzer-4OURSITY.js → repo-analyzer-WK5WP7NT.js} +1 -1
- package/dist/{report-OAHSB56I.js → report-IKRVVIW4.js} +2 -2
- package/dist/{unified-SKXQQX3Y.js → unified-67Z6YA64.js} +4 -4
- package/package.json +2 -2
- package/skills/sniff/SKILL.md +20 -25
- /package/dist/{discover-ENPRVN5A.js.map → discover-Q363YJ5X.js.map} +0 -0
- /package/dist/{domain-UQ34YE4B.js.map → domain-NNL2PPRK.js.map} +0 -0
- /package/dist/{model-X5J2JR5U.js.map → model-2DTSAX7T.js.map} +0 -0
- /package/dist/{quality-run-6SXCN5CD.js.map → quality-run-LLBZZI7X.js.map} +0 -0
- /package/dist/{repo-analyzer-4OURSITY.js.map → repo-analyzer-WK5WP7NT.js.map} +0 -0
- /package/dist/{report-OAHSB56I.js.map → report-IKRVVIW4.js.map} +0 -0
- /package/dist/{unified-SKXQQX3Y.js.map → unified-67Z6YA64.js.map} +0 -0
package/README.md
CHANGED
|
@@ -6,506 +6,438 @@
|
|
|
6
6
|
|
|
7
7
|
<p align="center">
|
|
8
8
|
<a href="https://www.npmjs.com/package/sniff-qa"><img src="https://img.shields.io/npm/v/sniff-qa?color=ef4444&logo=npm&label=npm&style=flat-square" alt="npm"></a>
|
|
9
|
+
<a href="https://www.npmjs.com/package/sniff-qa"><img src="https://img.shields.io/npm/dm/sniff-qa?color=ef4444&logo=npm&label=downloads&style=flat-square" alt="npm downloads"></a>
|
|
9
10
|
<a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache_2.0-ef4444?style=flat-square" alt="License"></a>
|
|
10
11
|
<a href="https://github.com/Aboudjem/sniff/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/Aboudjem/sniff/ci.yml?style=flat-square&label=CI" alt="CI"></a>
|
|
11
12
|
<a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%E2%89%A522-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node"></a>
|
|
13
|
+
<a href="https://github.com/Aboudjem/10x"><img src="https://img.shields.io/badge/10x-marketplace-ef4444?style=flat-square" alt="10x marketplace"></a>
|
|
12
14
|
<a href="https://github.com/Aboudjem/sniff/stargazers"><img src="https://img.shields.io/github/stars/Aboudjem/sniff?style=flat-square&color=ef4444" alt="Stars"></a>
|
|
13
15
|
</p>
|
|
14
16
|
|
|
15
|
-
<p align="center"
|
|
17
|
+
<p align="center">
|
|
18
|
+
<b>English</b> ·
|
|
19
|
+
<a href="READMEs/zh-CN.md">简体中文</a> ·
|
|
20
|
+
<a href="READMEs/ja.md">日本語</a> ·
|
|
21
|
+
<a href="READMEs/es.md">Español</a> ·
|
|
22
|
+
<a href="READMEs/fr.md">Français</a>
|
|
23
|
+
</p>
|
|
24
|
+
|
|
25
|
+
<p align="center"><b>Point it at your running app. It walks your real user flows in a real browser and tells you what's actually broken, with proof.</b></p>
|
|
16
26
|
|
|
17
27
|
<p align="center">
|
|
18
28
|
<a href="#get-started">Get started</a> ·
|
|
19
29
|
<a href="#what-it-finds">What it finds</a> ·
|
|
20
|
-
<a href="#
|
|
21
|
-
<a href="#
|
|
22
|
-
<a href="
|
|
30
|
+
<a href="#why-you-can-trust-it">Why trust it</a> ·
|
|
31
|
+
<a href="#how-it-works">How it works</a> ·
|
|
32
|
+
<a href="#demo">Demo</a> ·
|
|
33
|
+
<a href="#faq">FAQ</a>
|
|
23
34
|
</p>
|
|
24
35
|
|
|
36
|
+

|
|
37
|
+
|
|
25
38
|
<picture>
|
|
26
39
|
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Aboudjem/sniff/main/.github/assets/sniff-diagram.svg">
|
|
27
|
-
<img alt="Sniff flow:
|
|
40
|
+
<img alt="Sniff flow: your running app -> headless browser walk -> findings with proof" src="https://raw.githubusercontent.com/Aboudjem/sniff/main/.github/assets/sniff-diagram.svg" width="100%">
|
|
28
41
|
</picture>
|
|
29
42
|
|
|
30
43
|
---
|
|
31
44
|
|
|
32
|
-
##
|
|
45
|
+
## What is this?
|
|
46
|
+
|
|
47
|
+
Sniff is an autonomous QA scanner. You point it at a running web app and it **walks your app's real user flows in a real (headless) browser** (clicking buttons, filling forms, following links) and reports what's actually broken.
|
|
33
48
|
|
|
34
|
-
|
|
49
|
+
It is **not** a linter and **not** a static scanner. It opens your pages, interacts with them like a user would, and watches what happens.
|
|
35
50
|
|
|
36
|
-
|
|
51
|
+
Every bug it reports comes with **proof**: the exact page, the ordered steps to reproduce it, a screenshot, and the console or network excerpt that caught it. A finding without reproduction proof is not a finding.
|
|
37
52
|
|
|
38
53
|
```bash
|
|
39
|
-
npx sniff-qa
|
|
54
|
+
npx sniff-qa --url http://localhost:3000
|
|
40
55
|
```
|
|
41
56
|
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
### Why developers love it
|
|
57
|
+
One command, no config, no API key, no Playwright setup. Point it at your running app, or just run `npx sniff-qa` from your project and it auto-detects a dev server on common ports.
|
|
45
58
|
|
|
46
|
-
|
|
47
|
-
- **Zero API keys by default.** Deterministic local QA is the default. Codex, Claude, Gemini, Ollama, Anthropic, and OpenAI providers are optional enhancements.
|
|
48
|
-
- **Eight checks, every time.** Accessibility + visual regression + performance + dead links + API contracts + source scanning + broken imports + browser runtime hooks — out of the box.
|
|
49
|
-
- **Talks to your editor.** Ships as an MCP server. Just say *"scan this project"* in Claude / Cursor / Copilot / Continue / Windsurf / Codex / Gemini.
|
|
50
|
-
- **CI-ready.** `sniff --ci` emits JUnit, tracks flakes, and fails on severity thresholds you set. `sniff ci` generates the GitHub Actions workflow.
|
|
51
|
-
- **Actually explains the fix.** Every finding cites the rule, the file, the line — and `/sniff-fix` generates the patch.
|
|
59
|
+
> Sniff walks a **running app**. If no dev server is running, it falls back to a source-code scan and tells you exactly how to start the real walk. See [Get started](#get-started).
|
|
52
60
|
|
|
53
61
|
---
|
|
54
62
|
|
|
55
63
|
## Get started
|
|
56
64
|
|
|
57
|
-
|
|
65
|
+
You need **Node.js 22+** and a web app you can run locally (or a URL).
|
|
66
|
+
|
|
67
|
+
> **Naming:** the npm package is **`sniff-qa`**, so use `npx sniff-qa` or `npm install -D sniff-qa`. Once installed, the binary is **`sniff`** (the `sniff-qa` binary works too). Don't run `npx sniff`, that's a different package.
|
|
68
|
+
|
|
69
|
+
### 1. Start your app
|
|
58
70
|
|
|
59
71
|
```bash
|
|
60
|
-
|
|
61
|
-
npx sniff-qa # that's it
|
|
72
|
+
npm run dev # or however you start your app
|
|
62
73
|
```
|
|
63
74
|
|
|
64
|
-
|
|
75
|
+
### 2. Walk it
|
|
65
76
|
|
|
66
|
-
|
|
77
|
+
In another terminal:
|
|
67
78
|
|
|
68
79
|
```bash
|
|
69
|
-
npx sniff-qa --url http://localhost:3000
|
|
70
|
-
npx sniff-qa --url https://myapp.com # production URL
|
|
80
|
+
npx sniff-qa --url http://localhost:3000 # point it at your running app
|
|
71
81
|
```
|
|
72
82
|
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
### Use from your AI editor
|
|
76
|
-
|
|
77
|
-
Sniff ships as an MCP server. Add it to your editor, then ask your AI to scan.
|
|
78
|
-
|
|
79
|
-
<details>
|
|
80
|
-
<summary><b>Claude Code plugin marketplace</b> (one-command install)</summary>
|
|
83
|
+
That's the reliable one-liner. Sniff also **auto-detects** a dev server on common ports, so from your project folder you can often just run `npx sniff-qa` with no flags. If your app is on a non-standard port (or auto-detect misses it), pass `--url` (that always works). It also walks a deployed URL:
|
|
81
84
|
|
|
82
85
|
```bash
|
|
83
|
-
|
|
84
|
-
claude plugin install sniff@10x
|
|
86
|
+
npx sniff-qa --url https://staging.myapp.com
|
|
85
87
|
```
|
|
86
88
|
|
|
87
|
-
|
|
88
|
-
</details>
|
|
89
|
+
> **Found bugs? It exits non-zero, on purpose.** A walk that finds issues exits with code `1` so CI fails the build; it is **not** a crash (you'll see a `✓ Scan complete` line). Pass `--fail-on none` to always exit `0`.
|
|
89
90
|
|
|
90
|
-
|
|
91
|
-
|
|
91
|
+
> **First run downloads a browser.** The first time Sniff opens a browser it downloads a Chromium build (~165 MB, one-time). You'll see the progress. You need internet access for that first run; after that it's cached.
|
|
92
|
+
|
|
93
|
+
### 3. Read the report
|
|
94
|
+
|
|
95
|
+
Findings print to your terminal, grouped by severity, each with steps to reproduce. Want a shareable page?
|
|
92
96
|
|
|
93
97
|
```bash
|
|
94
|
-
|
|
98
|
+
npx sniff-qa --url http://localhost:3000 --report # runs a walk, then writes sniff-reports/sniff-report.html (self-contained)
|
|
95
99
|
```
|
|
96
|
-
</details>
|
|
97
100
|
|
|
98
|
-
|
|
99
|
-
<summary><b>Cursor</b></summary>
|
|
101
|
+
**No app running?** Sniff doesn't fail silently. It runs a source-only scan and prints a clear next step (start your dev server or pass `--url`) so you can get to the real flow-walk. You can also run the source scan on purpose:
|
|
100
102
|
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
{ "mcpServers": { "sniff-qa": { "type": "stdio", "command": "npx", "args": ["sniff-qa", "--mcp"] } } }
|
|
103
|
+
```bash
|
|
104
|
+
npx sniff-qa scan # source-only scan, no browser
|
|
104
105
|
```
|
|
105
|
-
</details>
|
|
106
106
|
|
|
107
|
-
|
|
108
|
-
<summary><b>VS Code + Copilot</b></summary>
|
|
107
|
+
Stuck? Run `npx sniff-qa doctor` to check your environment (Node, browser, dev server).
|
|
109
108
|
|
|
110
|
-
|
|
111
|
-
```json
|
|
112
|
-
{ "servers": { "sniff-qa": { "type": "stdio", "command": "npx", "args": ["-y", "sniff-qa", "--mcp"] } } }
|
|
113
|
-
```
|
|
114
|
-
</details>
|
|
109
|
+
---
|
|
115
110
|
|
|
116
|
-
|
|
117
|
-
<summary><b>Codex CLI</b></summary>
|
|
111
|
+
## What it finds
|
|
118
112
|
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
113
|
+
Sniff walks your app and looks for **12 classes of real bugs**:
|
|
114
|
+
|
|
115
|
+
| # | Class | Examples |
|
|
116
|
+
|:--|:------|:---------|
|
|
117
|
+
| 1 | **Broken pages / routes** | 4xx/5xx responses, blank renders, crash screens |
|
|
118
|
+
| 2 | **Broken links** | Dead internal and external links |
|
|
119
|
+
| 3 | **Console & network errors** | Uncaught exceptions and failed requests *during interaction* |
|
|
120
|
+
| 4 | **Empty & fake data** | Missing data, plus placeholders like `lorem ipsum`, `TODO`, `test@test.com` |
|
|
121
|
+
| 5 | **Broken forms** | Dead submit buttons, validation that never fires |
|
|
122
|
+
| 6 | **State loss** | Fill a form, hit back, and it's wiped |
|
|
123
|
+
| 7 | **Flow regressions / dead-ends** | A journey that can't be completed |
|
|
124
|
+
| 8 | **Bad loading & error states** | Infinite spinners, missing error states |
|
|
125
|
+
| 9 | **Broken async outcomes** | Submitted but no success feedback (flagged "needs out-of-band verification") |
|
|
126
|
+
| 10 | **Responsive issues** | Overflow and tiny tap targets (a 375px mobile pass) |
|
|
127
|
+
| 11 | **Accessibility** | Missing alt text and labels, contrast, via [axe-core](https://github.com/dequelabs/axe-core) |
|
|
128
|
+
| 12 | **Unclear primary actions** | The main call-to-action is buried or ambiguous |
|
|
129
|
+
|
|
130
|
+
Each finding ships with:
|
|
131
|
+
|
|
132
|
+
- **Reproduction proof**: the exact route, the ordered steps, a screenshot, and the console/network excerpt.
|
|
133
|
+
- **A severity**, so you fix the right thing first.
|
|
134
|
+
- **A confidence**: `confirmed`, `likely`, or `uncertain`. Uncertain findings are hidden by default; add `--all` to see them.
|
|
135
|
+
- **A suggested fix.**
|
|
123
136
|
|
|
124
|
-
<
|
|
125
|
-
<
|
|
137
|
+
<picture>
|
|
138
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Aboudjem/sniff/main/.github/assets/features-dark.svg">
|
|
139
|
+
<source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/Aboudjem/sniff/main/.github/assets/features-light.svg">
|
|
140
|
+
<img alt="The bug classes Sniff finds" src="https://raw.githubusercontent.com/Aboudjem/sniff/main/.github/assets/features-light.svg" width="100%">
|
|
141
|
+
</picture>
|
|
126
142
|
|
|
127
|
-
|
|
128
|
-
```json
|
|
129
|
-
{ "mcpServers": { "sniff-qa": { "command": "npx", "args": ["sniff-qa", "--mcp"] } } }
|
|
130
|
-
```
|
|
131
|
-
</details>
|
|
143
|
+
---
|
|
132
144
|
|
|
133
|
-
|
|
134
|
-
<summary><b>Gemini CLI</b></summary>
|
|
145
|
+
## Why you can trust it
|
|
135
146
|
|
|
136
|
-
|
|
137
|
-
```json
|
|
138
|
-
{ "mcpServers": { "sniff-qa": { "command": "npx", "args": ["sniff-qa", "--mcp"] } } }
|
|
139
|
-
```
|
|
140
|
-
</details>
|
|
147
|
+
Most scanners drown you in false positives until you stop reading them. Sniff is built the opposite way.
|
|
141
148
|
|
|
142
|
-
|
|
143
|
-
<summary><b>Continue.dev</b></summary>
|
|
149
|
+
We measured it on a fixture app planted with **21 bugs across all 12 classes**, plus a clean control page that should produce zero findings:
|
|
144
150
|
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
+
| | Old engine | New engine |
|
|
152
|
+
|:--|:--|:--|
|
|
153
|
+
| Bugs found | 9 / 21 (43%) | **21 / 21 (100%)** |
|
|
154
|
+
| Precision | ~13% | **100%** |
|
|
155
|
+
| False positives | 125 | **0** |
|
|
156
|
+
| Findings on the clean page | n/a | **0** |
|
|
157
|
+
| Flagship command | crashed | works |
|
|
151
158
|
|
|
152
|
-
|
|
153
|
-
<summary><b>OpenClaw</b></summary>
|
|
159
|
+
Those numbers are locked as a regression test. The full suite is **441 tests**.
|
|
154
160
|
|
|
155
|
-
|
|
156
|
-
clawhub install sniff-qa
|
|
157
|
-
```
|
|
158
|
-
</details>
|
|
161
|
+
**How it keeps false positives near zero:**
|
|
159
162
|
|
|
160
|
-
|
|
163
|
+
- A first-party **noise filter** drops the junk that isn't your bug: favicons, analytics, hot-module-reload chatter, expected auth redirects, engine aborts.
|
|
164
|
+
- Accessibility findings are backed by **axe-core**, which is zero-false-positive by design.
|
|
165
|
+
- **Uncertain findings are suppressed by default** (use `--all` to see them).
|
|
166
|
+
- A broken page is reported **once**, not re-flagged on every link that points to it.
|
|
161
167
|
|
|
162
|
-
|
|
168
|
+
If Sniff can't prove a bug, it doesn't claim one.
|
|
163
169
|
|
|
164
|
-
|
|
170
|
+
---
|
|
165
171
|
|
|
166
|
-
|
|
167
|
-
npm install -D sniff-qa
|
|
168
|
-
```
|
|
172
|
+
## How is it different?
|
|
169
173
|
|
|
170
|
-
|
|
171
|
-
{
|
|
172
|
-
"scripts": {
|
|
173
|
-
"qa": "sniff"
|
|
174
|
-
}
|
|
175
|
-
}
|
|
176
|
-
```
|
|
174
|
+
Linters read your source. End-to-end frameworks make *you* write the tests. Link checkers only check links. Sniff drives your real app and judges the result.
|
|
177
175
|
|
|
178
|
-
|
|
176
|
+
| | **Sniff** | linkinator | pa11y | Playwright codegen | QA-Wolf-style services |
|
|
177
|
+
|:--|:--|:--|:--|:--|:--|
|
|
178
|
+
| Walks real user flows in a browser | **Yes** | No | No | You script it | Yes |
|
|
179
|
+
| Zero setup, zero test-writing | **Yes** | Yes | Yes | No (you write tests) | No (onboarding) |
|
|
180
|
+
| Broken links | **Yes** | Yes | No | Manual | Manual |
|
|
181
|
+
| Accessibility (axe-core) | **Yes** | No | **Yes** | Manual | Some |
|
|
182
|
+
| Empty / placeholder / fake data | **Yes** | No | No | No | No |
|
|
183
|
+
| State-loss (back-button wipes a form) | **Yes** | No | No | Manual | Manual |
|
|
184
|
+
| One-shot reproduction proof per finding | **Yes** | No | Partial | No | Varies |
|
|
185
|
+
| Self-contained HTML report | **Yes** | No | Partial | No | Dashboard |
|
|
186
|
+
| Runs locally, no account, no API key | **Yes** | Yes | Yes | Yes | No (service) |
|
|
179
187
|
|
|
180
|
-
|
|
188
|
+
What Sniff uniquely does in one command: catch **empty/placeholder data**, **state-loss**, and **broken async outcomes**, and hand you a single proof report, with **no scripts to write and no service to sign up for**.
|
|
181
189
|
|
|
182
190
|
---
|
|
183
191
|
|
|
184
|
-
##
|
|
192
|
+
## Commands
|
|
185
193
|
|
|
186
|
-
```
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
194
|
+
```
|
|
195
|
+
sniff Walk your app (auto-detects the dev server). The default.
|
|
196
|
+
sniff --url <url> Walk a specific URL
|
|
197
|
+
sniff scan Source-only scan, no browser (placeholders, TODOs, dead links, etc.)
|
|
198
|
+
sniff report Show the results from the last run
|
|
199
|
+
sniff doctor Check your environment (Node, browser, config, dev server)
|
|
200
|
+
sniff ci Generate a GitHub Actions workflow
|
|
201
|
+
sniff fix Auto-fix safe issues (console.log, debugger, etc.)
|
|
202
|
+
sniff --help Show every command and flag
|
|
203
|
+
sniff --version Show the version
|
|
195
204
|
```
|
|
196
205
|
|
|
197
|
-
|
|
206
|
+
### Useful flags
|
|
207
|
+
|
|
208
|
+
| Flag | What it does |
|
|
209
|
+
|:-----|:-------------|
|
|
210
|
+
| `--url <url>` | Walk this URL instead of auto-detecting |
|
|
211
|
+
| `--report` | Write a self-contained HTML report to `sniff-reports/sniff-report.html` |
|
|
212
|
+
| `--all` | Also show low-confidence (`uncertain`) findings |
|
|
213
|
+
| `--max-pages <n>` | Cap how many pages to walk (default: 25) |
|
|
214
|
+
| `--no-mobile` | Skip the 375px responsive pass |
|
|
215
|
+
| `--headed` | Show the browser window while it walks |
|
|
216
|
+
| `--json` | Machine-readable JSON output |
|
|
217
|
+
| `--ci` | CI mode (stable output, non-interactive) |
|
|
218
|
+
| `--fail-on <sev>` | Exit non-zero on findings at or above this severity |
|
|
198
219
|
|
|
199
220
|
---
|
|
200
221
|
|
|
201
|
-
##
|
|
222
|
+
## Demo
|
|
202
223
|
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
<img alt="Sniff checks: source bugs, dead links, API endpoints, broken imports, accessibility, visual regression, performance, optional AI explorer" src="https://raw.githubusercontent.com/Aboudjem/sniff/main/.github/assets/features-light.svg" width="100%">
|
|
207
|
-
</picture>
|
|
224
|
+
A real run against a buggy app: 21 real issues, zero false positives, every finding with severity, confidence, reproduction steps, and a fix. Watch Sniff walk the app and stream findings in (the animated demo plays at the top of this README, [`.github/assets/demo.gif`](.github/assets/demo.gif)).
|
|
225
|
+
|
|
226
|
+
Below is the same run as a stylized terminal still:
|
|
208
227
|
|
|
209
|
-
|
|
228
|
+
<img alt="Sniff walking a buggy app and reporting 21 real issues with zero false positives" src="https://raw.githubusercontent.com/Aboudjem/sniff/main/.github/assets/demo.svg" width="100%">
|
|
210
229
|
|
|
211
230
|
---
|
|
212
231
|
|
|
213
|
-
##
|
|
232
|
+
## Use it from your AI editor
|
|
214
233
|
|
|
215
|
-
|
|
216
|
-
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Aboudjem/sniff/main/.github/assets/report-dark.svg">
|
|
217
|
-
<source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/Aboudjem/sniff/main/.github/assets/report-light.svg">
|
|
218
|
-
<img alt="Sniff terminal output" src="https://raw.githubusercontent.com/Aboudjem/sniff/main/.github/assets/report-light.svg" width="100%">
|
|
219
|
-
</picture>
|
|
234
|
+
Sniff ships as an MCP server too. Add it once, then just ask your assistant *"scan this project for bugs"* or *"walk my app."* If your app is running, Sniff auto-detects it, so you don't have to pass a URL.
|
|
220
235
|
|
|
221
|
-
|
|
236
|
+
**One unified `sniff` tool, three modes:**
|
|
222
237
|
|
|
223
|
-
|
|
238
|
+
- `walk`: **recommended.** Walks your running app's real flows (the flow-walk above).
|
|
239
|
+
- `scan`: source-only scan, no browser.
|
|
240
|
+
- `report`: show the last run's results.
|
|
224
241
|
|
|
225
|
-
|
|
242
|
+
(`run` and `discover` are legacy modes kept for back-compat.)
|
|
226
243
|
|
|
227
|
-
|
|
228
|
-
|:--------|:-------------|
|
|
229
|
-
| `/sniff` | Scan the project. Auto-detects dev server, runs source + browser checks |
|
|
230
|
-
| `/sniff-fix` | Scan and auto-fix safe issues (debugger, console.log, etc.) |
|
|
231
|
-
| `/sniff-report` | Show results from the last scan |
|
|
244
|
+
### Slash commands and MCP tools
|
|
232
245
|
|
|
233
|
-
|
|
246
|
+
As a Claude Code plugin, Sniff adds three slash commands:
|
|
234
247
|
|
|
248
|
+
| Slash command | What it does |
|
|
249
|
+
|:--------------|:-------------|
|
|
250
|
+
| `/sniff` | Walk your running app and find real bugs (the flow-walk). |
|
|
251
|
+
| `/sniff-fix` | Scan and auto-fix safe issues (stray `console.log`, `debugger`, etc.). |
|
|
252
|
+
| `/sniff-report` | Show the results from the last run. |
|
|
253
|
+
|
|
254
|
+
As an MCP server, the surface is **one unified `sniff` tool** that takes `{ mode, rootDir, baseUrl? }`. The three modes above (`walk` / `scan` / `report`) are how you drive it, and the unified tool is what you should use. Narrow, single-purpose tools (`sniff_scan`, `sniff_run`, `sniff_report`, plus `sniff_discover` and `sniff_install`) stay registered for back-compat and scoped capabilities, but new work should go through the unified `sniff` tool.
|
|
255
|
+
|
|
256
|
+
### Install the skills into any AI CLI
|
|
257
|
+
|
|
258
|
+
The MCP server above works in every MCP-capable client. To also load the `/sniff` skills directly into another CLI, run the one-line installer. It symlinks the three skills into that CLI's skills directory; `--update` pulls the latest and relinks, `--uninstall` removes them.
|
|
259
|
+
|
|
260
|
+
```bash
|
|
261
|
+
curl -fsSL https://raw.githubusercontent.com/Aboudjem/sniff/main/install.sh | bash -s codex
|
|
235
262
|
```
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
```
|
|
263
|
+
|
|
264
|
+
On Windows, run `install.ps1 <platform>` from a checkout (Developer Mode or an elevated shell is needed for symlinks).
|
|
265
|
+
|
|
266
|
+
| Platform | Skills directory | One-liner |
|
|
267
|
+
|:--|:--|:--|
|
|
268
|
+
| Claude Code | (plugin) | `claude plugin install sniff@10x` |
|
|
269
|
+
| Codex / Gemini / OpenCode / Pi | `~/.agents/skills` | `install.sh codex` |
|
|
270
|
+
| VS Code (Copilot) | `~/.copilot/skills` | `install.sh copilot` |
|
|
271
|
+
| Trae | `~/.trae/skills` | `install.sh trae` |
|
|
272
|
+
| Vibe | `~/.vibe/skills` | `install.sh vibe` |
|
|
273
|
+
| OpenClaw | `~/.openclaw/skills` | `install.sh openclaw` |
|
|
274
|
+
| Antigravity | `~/.gemini/antigravity/skills` | `install.sh antigravity` |
|
|
275
|
+
| Hermes / Cline / Kimi | `~/.<cli>/skills` | `install.sh hermes` |
|
|
276
|
+
|
|
277
|
+
Skill-directory conventions change between CLI releases. If a link does not resolve, fall back to the MCP server (it works everywhere). Run `install.sh all` to link every platform at once.
|
|
252
278
|
|
|
253
279
|
<details>
|
|
254
|
-
<summary><b>
|
|
280
|
+
<summary><b>Claude Code</b></summary>
|
|
255
281
|
|
|
256
|
-
|
|
257
|
-
|:-----|:-------------|
|
|
258
|
-
| `--url <url>` | Enable browser checks (accessibility, visual, performance, AI) |
|
|
259
|
-
| `--ci` | CI mode: skip AI explorer, add JUnit output, track flaky tests |
|
|
260
|
-
| `--explore` | Opt into AI-assisted exploration after browser checks |
|
|
261
|
-
| `--no-explore` | Compatibility flag; exploration is off by default |
|
|
262
|
-
| `--no-browser` | Source only even if `--url` is set |
|
|
263
|
-
| `--max-steps <n>` | Limit AI explorer steps (default: 50) |
|
|
264
|
-
| `--no-headless` | Show the browser window |
|
|
265
|
-
| `--headed` | Alias for `--no-headless` |
|
|
266
|
-
| `--format html,json,junit` | Choose report formats |
|
|
267
|
-
| `--fail-on critical,high` | Severities that cause non-zero exit |
|
|
268
|
-
| `--track-flakes` | Track test flakiness across runs |
|
|
269
|
-
| `--json` | JSON output for scripts |
|
|
270
|
-
| `--verbose` | Print classifier top-3 guesses and matched signals per dimension |
|
|
271
|
-
| `--dry-run` | Discover: generate scenarios without launching browser or writing reports |
|
|
272
|
-
| `--force-app-type <type>` | Discover: bypass the classifier (e.g. `saas`, `ecommerce`, `booking`) |
|
|
273
|
-
| `--app-type <types>` | Discover: filter classifier guesses to these app types (comma-separated) |
|
|
282
|
+
One-command plugin install from the [10x marketplace](https://github.com/Aboudjem/10x):
|
|
274
283
|
|
|
275
|
-
|
|
284
|
+
```bash
|
|
285
|
+
claude plugin marketplace add Aboudjem/10x
|
|
286
|
+
claude plugin install sniff@10x
|
|
287
|
+
```
|
|
276
288
|
|
|
277
|
-
|
|
289
|
+
Or add just the MCP server:
|
|
278
290
|
|
|
279
|
-
|
|
291
|
+
```bash
|
|
292
|
+
claude mcp add sniff-qa npx -- -y sniff-qa --mcp
|
|
293
|
+
```
|
|
294
|
+
</details>
|
|
280
295
|
|
|
281
|
-
|
|
296
|
+
<details>
|
|
297
|
+
<summary><b>Cursor</b></summary>
|
|
282
298
|
|
|
283
|
-
|
|
284
|
-
<tr>
|
|
285
|
-
<td align="center" width="14%"><b>React</b><br/><sub>JSX / TSX</sub></td>
|
|
286
|
-
<td align="center" width="14%"><b>Next.js</b><br/><sub>App + Pages</sub></td>
|
|
287
|
-
<td align="center" width="14%"><b>Vue</b><br/><sub>SFC</sub></td>
|
|
288
|
-
<td align="center" width="14%"><b>Svelte</b><br/><sub>Components</sub></td>
|
|
289
|
-
<td align="center" width="14%"><b>Angular</b><br/><sub>Templates</sub></td>
|
|
290
|
-
<td align="center" width="14%"><b>Express</b><br/><sub>Routes</sub></td>
|
|
291
|
-
<td align="center" width="14%"><b>Vanilla</b><br/><sub>HTML / CSS</sub></td>
|
|
292
|
-
</tr>
|
|
293
|
-
</table>
|
|
299
|
+
Add to `~/.cursor/mcp.json`:
|
|
294
300
|
|
|
295
|
-
|
|
301
|
+
```json
|
|
302
|
+
{ "mcpServers": { "sniff-qa": { "command": "npx", "args": ["-y", "sniff-qa", "--mcp"] } } }
|
|
303
|
+
```
|
|
304
|
+
</details>
|
|
296
305
|
|
|
297
|
-
|
|
306
|
+
<details>
|
|
307
|
+
<summary><b>VS Code (Copilot)</b></summary>
|
|
298
308
|
|
|
299
|
-
|
|
309
|
+
Add to `.vscode/mcp.json`:
|
|
310
|
+
|
|
311
|
+
```json
|
|
312
|
+
{ "servers": { "sniff-qa": { "type": "stdio", "command": "npx", "args": ["-y", "sniff-qa", "--mcp"] } } }
|
|
313
|
+
```
|
|
314
|
+
</details>
|
|
300
315
|
|
|
301
|
-
|
|
316
|
+
<details>
|
|
317
|
+
<summary><b>Codex CLI</b></summary>
|
|
302
318
|
|
|
303
319
|
```bash
|
|
304
|
-
|
|
305
|
-
npx sniff-qa init --ts # force TypeScript config
|
|
306
|
-
npx sniff-qa init --js # force JavaScript config (respects package.json "type")
|
|
320
|
+
codex mcp add sniff-qa -- npx -y sniff-qa --mcp
|
|
307
321
|
```
|
|
322
|
+
</details>
|
|
308
323
|
|
|
309
324
|
<details>
|
|
310
|
-
<summary><b>
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
// Save your URL so you can just run `sniff`
|
|
317
|
-
browser: {
|
|
318
|
-
baseUrl: 'http://localhost:3000',
|
|
319
|
-
projects: ['chromium'], // also supports 'firefox' and 'webkit'
|
|
320
|
-
},
|
|
321
|
-
|
|
322
|
-
// Viewports to test
|
|
323
|
-
viewports: [
|
|
324
|
-
{ name: 'mobile', width: 375, height: 667 },
|
|
325
|
-
{ name: 'desktop', width: 1280, height: 720 },
|
|
326
|
-
],
|
|
327
|
-
|
|
328
|
-
// Toggle scanner groups
|
|
329
|
-
scanners: ['source', 'repo-analyzer', 'e2e', 'accessibility', 'visual', 'performance'],
|
|
330
|
-
accessibility: { enabled: true, standard: 'wcag21aa' },
|
|
331
|
-
visual: { enabled: true, threshold: 0.1 },
|
|
332
|
-
performance: { enabled: true, budgets: { lcp: 2500, fcp: 1800, tti: 3800 } },
|
|
333
|
-
|
|
334
|
-
// Optional AI providers. Default is deterministic local QA with provider: 'none'.
|
|
335
|
-
ai: {
|
|
336
|
-
provider: 'none', // codex-cli, claude-code, anthropic-api, openai-api, gemini-cli, ollama
|
|
337
|
-
model: undefined,
|
|
338
|
-
command: undefined,
|
|
339
|
-
baseUrl: undefined,
|
|
340
|
-
},
|
|
341
|
-
|
|
342
|
-
// Optional AI explorer, run only with --explore
|
|
343
|
-
exploration: { enabled: true, maxSteps: 50 },
|
|
344
|
-
|
|
345
|
-
// Dead link checker
|
|
346
|
-
deadLinks: {
|
|
347
|
-
scanCode: false, // docs/HTML by default; opt into JSX/TSX/JS/TS to reduce noise
|
|
348
|
-
checkExternal: true,
|
|
349
|
-
timeout: 5000,
|
|
350
|
-
retries: 2,
|
|
351
|
-
ignorePatterns: [],
|
|
352
|
-
maxConcurrent: 10,
|
|
353
|
-
},
|
|
354
|
-
|
|
355
|
-
// API endpoint discovery
|
|
356
|
-
apiEndpoints: {
|
|
357
|
-
checkErrorHandling: true,
|
|
358
|
-
checkValidation: true,
|
|
359
|
-
checkAuth: true,
|
|
360
|
-
checkSecrets: true,
|
|
361
|
-
frameworks: [], // empty = auto-detect all
|
|
362
|
-
},
|
|
363
|
-
|
|
364
|
-
// Turn off specific rules
|
|
365
|
-
rules: {
|
|
366
|
-
'debug-console-log': 'off',
|
|
367
|
-
},
|
|
368
|
-
});
|
|
325
|
+
<summary><b>Gemini CLI</b></summary>
|
|
326
|
+
|
|
327
|
+
Add to `~/.gemini/mcp_config.json`:
|
|
328
|
+
|
|
329
|
+
```json
|
|
330
|
+
{ "mcpServers": { "sniff-qa": { "command": "npx", "args": ["-y", "sniff-qa", "--mcp"] } } }
|
|
369
331
|
```
|
|
332
|
+
</details>
|
|
370
333
|
|
|
371
|
-
|
|
334
|
+
<details>
|
|
335
|
+
<summary><b>Windsurf</b></summary>
|
|
372
336
|
|
|
337
|
+
Add to `~/.codeium/windsurf/mcp_config.json`:
|
|
338
|
+
|
|
339
|
+
```json
|
|
340
|
+
{ "mcpServers": { "sniff-qa": { "command": "npx", "args": ["-y", "sniff-qa", "--mcp"] } } }
|
|
341
|
+
```
|
|
373
342
|
</details>
|
|
374
343
|
|
|
375
344
|
<details>
|
|
376
|
-
<summary><b>
|
|
377
|
-
|
|
378
|
-
| Rule | Severity | What it checks |
|
|
379
|
-
|:-----|:---------|:---------------|
|
|
380
|
-
| `debug-console-log` | medium | console.log/debug/info |
|
|
381
|
-
| `debug-debugger` | high | debugger statements |
|
|
382
|
-
| `placeholder-lorem` | high | Lorem ipsum text |
|
|
383
|
-
| `placeholder-todo` | medium | TODO comments |
|
|
384
|
-
| `placeholder-fixme` | high | FIXME comments |
|
|
385
|
-
| `placeholder-tbd` | medium | TBD markers |
|
|
386
|
-
| `hardcoded-localhost` | medium | localhost URLs |
|
|
387
|
-
| `hardcoded-127` | medium | 127.0.0.1 URLs |
|
|
388
|
-
| `broken-import` | medium | Unresolved imports |
|
|
389
|
-
| `dead-link-internal` | high | Broken file links |
|
|
390
|
-
| `dead-link-external` | medium | 404 external URLs |
|
|
391
|
-
| `dead-link-anchor` | medium | Missing anchors |
|
|
392
|
-
| `api-no-error-handling` | medium | Routes without try/catch |
|
|
393
|
-
| `api-no-validation` | medium | POST/PUT without validation |
|
|
394
|
-
| `api-no-auth` | low | Routes without auth |
|
|
395
|
-
| `api-hardcoded-secret` | critical | Hardcoded API keys |
|
|
396
|
-
|
|
397
|
-
Set any to `'off'` to disable.
|
|
345
|
+
<summary><b>Continue.dev</b></summary>
|
|
398
346
|
|
|
347
|
+
Add to `.continue/mcpServers/sniff-qa.yaml`:
|
|
348
|
+
|
|
349
|
+
```yaml
|
|
350
|
+
mcpServers:
|
|
351
|
+
sniff-qa: { command: npx, args: ["-y", "sniff-qa", "--mcp"], type: stdio }
|
|
352
|
+
```
|
|
399
353
|
</details>
|
|
400
354
|
|
|
355
|
+
> The first browser-based walk downloads Chromium (~165 MB). Over MCP, Sniff returns a structured `needsSetup` payload instead of blocking the editor on a long download: run the install it shows you, then ask again.
|
|
356
|
+
|
|
357
|
+
---
|
|
358
|
+
|
|
359
|
+
## How it works
|
|
360
|
+
|
|
361
|
+
1. **Find the app.** Sniff auto-detects your running dev server (or you pass `--url`).
|
|
362
|
+
2. **Walk the flows.** It opens pages in a headless browser and interacts with them like a user (clicking, filling forms, following links) across desktop and a 375px mobile pass.
|
|
363
|
+
3. **Watch everything.** It records console errors, failed network requests, broken renders, missing feedback, and accessibility issues as it goes.
|
|
364
|
+
4. **Filter the noise.** The first-party noise filter and axe-core drop the false positives; uncertain findings are held back.
|
|
365
|
+
5. **Report with proof.** Each surviving finding gets a severity, a confidence, reproduction steps, a screenshot, and a suggested fix, in the terminal and an optional HTML report.
|
|
366
|
+
|
|
367
|
+
<img alt="How sniff works: crawl, act, assert, prove, report" src="https://raw.githubusercontent.com/Aboudjem/sniff/main/.github/assets/how-it-works.svg" width="100%">
|
|
368
|
+
|
|
401
369
|
---
|
|
402
370
|
|
|
403
371
|
## CI integration
|
|
404
372
|
|
|
405
|
-
Run Sniff
|
|
373
|
+
Run Sniff in your pipeline and fail the build on real bugs:
|
|
406
374
|
|
|
407
375
|
```bash
|
|
408
|
-
npx sniff-qa --ci --
|
|
376
|
+
npx sniff-qa --ci --fail-on high
|
|
409
377
|
```
|
|
410
378
|
|
|
411
|
-
Generate a GitHub Actions workflow:
|
|
379
|
+
Generate a ready-to-commit GitHub Actions workflow:
|
|
412
380
|
|
|
413
381
|
```bash
|
|
414
382
|
npx sniff-qa ci
|
|
415
383
|
```
|
|
416
384
|
|
|
417
|
-
This writes `.github/workflows/sniff.yml` with
|
|
418
|
-
|
|
419
|
-
**Flakiness quarantine:** Tests that fail 3 of 5 runs get quarantined. They still run, still report, but won't block your pipeline.
|
|
385
|
+
This writes `.github/workflows/sniff.yml` with browser caching and report artifacts.
|
|
420
386
|
|
|
421
387
|
---
|
|
422
388
|
|
|
423
|
-
##
|
|
389
|
+
## FAQ
|
|
424
390
|
|
|
425
|
-
|
|
426
|
-
|
|
427
|
-
sniff discover --regenerate-only # write sniff-scenarios/ and exit (no run)
|
|
428
|
-
```
|
|
391
|
+
**Does it work without a dev server?**
|
|
392
|
+
Sniff is built to walk a *running* app, so that's where it shines. If no server is running, it doesn't fail silently: it runs a source-only scan and tells you exactly how to start the real walk (start your dev server or pass `--url`). You can also run `npx sniff-qa scan` to get the source scan on purpose.
|
|
429
393
|
|
|
430
|
-
|
|
394
|
+
**What gets downloaded on first run?**
|
|
395
|
+
The first time Sniff opens a browser, it downloads a Chromium build (~165 MB, one-time, then cached). You'll see the progress, and you need internet access for that first run. Nothing else is installed and no account is created.
|
|
431
396
|
|
|
432
|
-
|
|
397
|
+
**Do I need an API key?**
|
|
398
|
+
No. Sniff runs entirely on your machine with no API key and no signup. Your code and your app never leave your computer.
|
|
433
399
|
|
|
434
|
-
**
|
|
400
|
+
**How is it different from a linter?**
|
|
401
|
+
A linter reads your source files and never runs your app, so it can't see a dead submit button, an infinite spinner, a wiped form, or a 500 page. Sniff opens your real app, interacts with it, and reports what actually broke, with a screenshot and steps to reproduce.
|
|
435
402
|
|
|
436
|
-
**
|
|
403
|
+
**How is it different from Playwright codegen (or writing E2E tests)?**
|
|
404
|
+
Playwright codegen records a script that *you* author and maintain; it tests only the path you clicked. Sniff writes nothing for you to maintain: it explores your flows on its own and judges the outcome, catching things a recorded happy-path never checks (empty/placeholder data, state-loss, missing success feedback).
|
|
437
405
|
|
|
438
|
-
|
|
439
|
-
- `sniff-
|
|
440
|
-
- Flakiness quarantine for scenarios that fail 3 of the last 5 runs.
|
|
406
|
+
**Will it change my code?**
|
|
407
|
+
No, not during a walk. Walking and scanning are read-only. The separate `sniff fix` command applies safe auto-fixes (like stray `console.log`/`debugger`) and only when you run it.
|
|
441
408
|
|
|
442
|
-
**
|
|
443
|
-
|
|
444
|
-
| Flag | What it does |
|
|
445
|
-
|:-----|:-------------|
|
|
446
|
-
| `--url <url>` | Target URL (default: auto-detect dev server) |
|
|
447
|
-
| `--max-scenarios <n>` | Cap total scenarios (default: 50) |
|
|
448
|
-
| `--max-variants-per-scenario <n>` | Cap edge variants per scenario (default: 3) |
|
|
449
|
-
| `--max-variants-per-run <n>` | Cap edge variants per run (default: 40) |
|
|
450
|
-
| `--realism <profile>` | `robot`, `careful-user`, `casual-user` (default), `frustrated-user`, `power-user` |
|
|
451
|
-
| `--seed <n>` | Replay a specific random seed |
|
|
452
|
-
| `--only <filter>` | Filter scenarios by id substring or app type |
|
|
453
|
-
| `--app-type <types>` | Filter classifier guesses to these app types (comma-separated, kept for back-compat) |
|
|
454
|
-
| `--force-app-type <type>` | Bypass the classifier entirely — treat the app as this type |
|
|
455
|
-
| `--verbose` | Print classifier breakdown (top 3 guesses + matched signals per dimension) |
|
|
456
|
-
| `--dry-run` | Generate scenarios without launching the browser or writing reports |
|
|
457
|
-
| `--regenerate` | Regenerate `sniff-scenarios/` before running |
|
|
458
|
-
| `--regenerate-only` | Regenerate and exit (no browser) |
|
|
459
|
-
| `--force-regenerate` | Overwrite hand-edits without prompting |
|
|
460
|
-
| `--non-interactive` | Skip prompts and the production-URL countdown |
|
|
461
|
-
| `--verbose` | Print classification breakdown (top 3 guesses + matched signals per dimension) |
|
|
462
|
-
| `--no-llm` | Skip Claude Code CLI polish (deterministic only) |
|
|
463
|
-
|
|
464
|
-
**Production-URL safety:** when the target is not a local address, sniff prints a 5-second countdown banner before running. Hit Ctrl+C to cancel. No `--allow-destructive` flag.
|
|
465
|
-
|
|
466
|
-
**LLM polish (optional):** discovery can use the `claude` CLI to break close-call app-type classifications. Responses are cached under `.sniff/discover/cache/`. Pass `--no-llm` to skip.
|
|
409
|
+
**What stacks does it work with?**
|
|
410
|
+
Any web app you can open in a browser: React, Next.js, Vue, Svelte, Angular, Remix, SvelteKit, Astro, plain HTML, and more. It walks the rendered app, so the framework doesn't matter for the browser checks.
|
|
467
411
|
|
|
468
412
|
---
|
|
469
413
|
|
|
470
|
-
##
|
|
414
|
+
## Works first-class in
|
|
471
415
|
|
|
472
|
-
|
|
473
|
-
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Aboudjem/sniff/main/.github/assets/pipeline-dark.svg">
|
|
474
|
-
<source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/Aboudjem/sniff/main/.github/assets/pipeline-light.svg">
|
|
475
|
-
<img alt="Sniff pipeline" src="https://raw.githubusercontent.com/Aboudjem/sniff/main/.github/assets/pipeline-light.svg" width="100%">
|
|
476
|
-
</picture>
|
|
477
|
-
|
|
478
|
-
<details>
|
|
479
|
-
<summary><b>Architecture</b></summary>
|
|
480
|
-
|
|
481
|
-
<picture>
|
|
482
|
-
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Aboudjem/sniff/main/.github/assets/architecture-dark.svg">
|
|
483
|
-
<source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/Aboudjem/sniff/main/.github/assets/architecture-light.svg">
|
|
484
|
-
<img alt="Sniff architecture" src="https://raw.githubusercontent.com/Aboudjem/sniff/main/.github/assets/architecture-light.svg" width="100%">
|
|
485
|
-
</picture>
|
|
486
|
-
|
|
487
|
-
</details>
|
|
416
|
+
Claude Code · Cursor · VS Code (Copilot) · Codex · Gemini CLI · Windsurf · Continue.dev, via the MCP server (command `npx`, args `["-y", "sniff-qa", "--mcp"]`) or the CLI directly.
|
|
488
417
|
|
|
489
418
|
---
|
|
490
419
|
|
|
491
|
-
##
|
|
492
|
-
|
|
493
|
-
No telemetry. No signup. No data collection. No API keys required. Your code stays on your machine unless you explicitly configure an API-backed AI provider.
|
|
420
|
+
## Star History
|
|
494
421
|
|
|
495
|
-
>
|
|
496
|
-
>
|
|
422
|
+
<a href="https://star-history.com/#Aboudjem/sniff&Date">
|
|
423
|
+
<picture>
|
|
424
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=Aboudjem/sniff&type=Date&theme=dark" />
|
|
425
|
+
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=Aboudjem/sniff&type=Date" />
|
|
426
|
+
<img alt="Star history chart for Aboudjem/sniff" src="https://api.star-history.com/svg?repos=Aboudjem/sniff&type=Date" width="70%" />
|
|
427
|
+
</picture>
|
|
428
|
+
</a>
|
|
497
429
|
|
|
498
430
|
---
|
|
499
431
|
|
|
500
432
|
## Contributing
|
|
501
433
|
|
|
502
|
-
|
|
434
|
+
Issues and PRs welcome. See [CONTRIBUTING.md](CONTRIBUTING.md).
|
|
503
435
|
|
|
504
436
|
---
|
|
505
437
|
|
|
506
438
|
<p align="center">
|
|
507
439
|
<sub>
|
|
508
|
-
Built on <a href="https://playwright.dev">Playwright</a> · <a href="https://github.com/dequelabs/axe-core">axe-core</a> · <a href="https://developer.chrome.com/docs/lighthouse">Lighthouse</a> · <a href="https://github.com/mapbox/pixelmatch">pixelmatch</a> · <a href="https://zod.dev">Zod</a> · <a href="https://github.com/modelcontextprotocol/typescript-sdk">MCP SDK</a>
|
|
440
|
+
Built on <a href="https://playwright.dev">Playwright</a> · <a href="https://github.com/dequelabs/axe-core">axe-core</a> · <a href="https://developer.chrome.com/docs/lighthouse">Lighthouse</a> · <a href="https://github.com/mapbox/pixelmatch">pixelmatch</a> · <a href="https://zod.dev">Zod</a> · <a href="https://github.com/modelcontextprotocol/typescript-sdk">MCP SDK</a>
|
|
509
441
|
</sub>
|
|
510
442
|
</p>
|
|
511
443
|
|