Skip to main content
subagent CX Codex

browser-verifier — Claude Code subagent: what it does, how to install

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.

no license ★ 1,298 updated 2026-06-12

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/browser-verifier.md
Open on GitHub

What browser-verifier 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.

What it helps with

  • 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 for the agent

  • 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

How to install browser-verifier

Manually: put the files in place

.claude/agents/browser-verifier.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about browser-verifier

How do I install browser-verifier in Claude Code?

Place the .claude/agents/browser-verifier.md file in the project root. The subagent is dispatched automatically by /hunt and /validate for client-side vulnerabilities.

What does browser-verifier do?

The subagent verifies client-side vulnerabilities (XSS, DOM, postMessage, prototype pollution) in a real browser via camofox, snapshots the DOM and determines whether the payload executed. It distinguishes reflection in the HTTP response from actual execution in the browser.

Why verify in a browser if the payload already reflects in curl?

Reflection in the response does not prove execution. CSP can block inline scripts, React and Angular escape output automatically, a WAF may pass curl but challenge the browser, and the context may be non-executing. browser-verifier checks actual execution and diagnoses rejection causes.

Similar subagents

All subagents for Security →

From the same set43

The whole set →
browser-stealth-agent The browser-stealth-agent skill drives a local camofox-browser server to get past Cloudflare, Akamai, DataDome and PerimeterX bot checks, then verifies client-side bugs in a real browser. CX Codex +1 ★ 1,298repo stars sast-hunter The sast-hunter skill builds and runs a PoC for a specific suspected vulnerability. Use it after the candidate has passed code and condition checks. CX Codex +1 ★ 1,298repo stars browser-verifier browser-verifier takes a client-side finding backed by curl evidence and settles whether the payload fires in a real browser. Useful before an XSS report goes out. CX Codex +1 ★ 1,298repo stars business-logic The business-logic subagent probes application workflows for logic flaws, from price tampering to account-takeover paths. Use it when auditing purchases, sign-in flows, or trial limits. CX Codex +1 ★ 1,298repo stars sast-hunter sast-hunter validates candidate vulnerabilities from static analysis. Builds minimal test cases and runs them under sanitizers like ASan to confirm bugs or reject false alarms. CX Codex +1 ★ 1,298repo stars browser-stealth-agent The browser-stealth-agent subagent drives Camoufox through a local REST server to inspect bot-protected pages, verify client-side bugs, and save evidence. CX Codex +1 ★ 1,298repo stars sast-devils-advocate sast-devils-advocate is a Claude Code skill that challenges SAST vulnerability candidates against the code. Run it with /sast to look for reasons a finding cannot be exploited. CX Codex +1 ★ 1,298repo stars sast-devils-advocate sast-devils-advocate is a Claude Code subagent that challenges SAST findings by looking for reasons a reported flaw cannot be exploited. Run it with /sast. CX Codex +1 ★ 1,298repo stars

Project sponsors

Companies that keep this analytics open