# browser-verifier

browser-verifier — a subagent that verifies client-side vulnerabilities in a real browser. Takes a curl-based finding and determines whether it executes in the browser.

- subagent · `type=agent` · Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop) · ★ 1298 repo stars
- Author: H-mmer
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/H-mmer/pentest-agents/tree/HEAD/.claude/agents/browser-verifier.md
- Updated: 2026-06-12
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/browser-verifier

## What it does

The subagent runs XSS, DOM, postMessage and prototype pollution checks in a live browser via camofox (headless Firefox). The process: detect Cloudflare and WAF, spawn a tab, inject a detector (DOM marker, `fetch` callback or OOB exfiltration via `dns-prefetch`), navigate to the payload URL, snapshot the page and check whether it fired. If it did not fire, diagnose the reason: CSP blocked it, framework escaped output, WAF challenged the browser, or the context is non-executing.

Returns a verdict: `BROWSER_CONFIRMED` (executed), `BROWSER_REJECTED` (reflected in the response but the browser did not run it), or `BROWSER_PARTIAL` (executed but CSP limits exfiltration). Reflection in an HTTP response does not prove execution: React and Angular escape output automatically, CSP blocks `eval` and inline scripts, and some WAFs pass curl but challenge browsers. The subagent is dispatched automatically by `/hunt` and `/validate` for client-side vulnerability classes.

Requires a running camofox instance and access to `localhost:9377`. The `$CLAUDE_PROJECT_DIR/tools/camofox_ctl.sh` script starts the browser if it is not running.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/browser-verifier.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/browser-verifier.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/browser-verifier.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/H-mmer/pentest-agents/tree/HEAD/.claude/agents/browser-verifier.md

## When to use it
- verify whether an XSS payload executes in a real browser
- distinguish reflection in the response from actual DOM execution
- diagnose why CSP or a framework blocks the payload
- capture a screenshot of the fired vulnerability as evidence
- bypass WAF using a headless browser with a stealth profile

## Example prompts
- Verify finding `xss-reflected-001.json` in the browser and return a verdict
- Run browser-verifier on `findings/dom-xss-checkout.md`
- Diagnose why the payload in `xss-profile.json` did not fire in Firefox

## Similar
- [hunt-file-upload](https://affpapa.org/en/nevibecode/skills/hunt-file-upload.md) — skill · ★ 16193 repo stars
- [secure-headers-csp-builder](https://affpapa.org/en/nevibecode/skills/secure-headers-csp-builder.md) — skill · 323 installs
- [scanning-for-xss-vulnerabilities](https://affpapa.org/en/nevibecode/skills/scanning-for-xss-vulnerabilities.md) — skill · 2 installs
- [csp-bypass-advanced](https://affpapa.org/en/nevibecode/skills/csp-bypass-advanced.md) — skill · 4000 installs
- [frontend-security-coder](https://affpapa.org/en/nevibecode/agents/frontend-security-coder.md) — subagent · ★ 42780 repo stars
- [browser-search](https://affpapa.org/en/nevibecode/skills/browser-search.md) — skill · ★ 549 repo stars

From the same set: [h-mmer/pentest-agents](https://affpapa.org/en/nevibecode/by/h-mmer/pentest-agents.md) — 43 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
