# 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.

- 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-stealth-agent.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-stealth-agent

## What it does

The agent controls tabs in the local `camofox-browser` server: it navigates, clicks and types using element references from accessibility snapshots. It can save full-page screenshots and text snapshots for reports. Camoufox is a Firefox fork with C++ changes that spoof browser properties checked by bot-detection systems.

Its listed tasks include reconnaissance on Cloudflare-protected sites and browser-based checks for reflected or stored XSS. Cookie import requires `CAMOFOX_API_KEY`; GeoIP-gated pages can use proxy settings supplied through `PROXY_*` environment variables before server startup. The server is managed with `$CLAUDE_PROJECT_DIR/tools/camofox_ctl.sh`. If startup fails, the instructions say to inspect the logs and stop rather than use a broken server.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/browser-stealth-agent.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-stealth-agent.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-stealth-agent.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-stealth-agent.md

## When to use it
- open a bot-protected page for reconnaissance
- verify reflected XSS in a browser
- show the effect of stored XSS in a user session
- save screenshots and DOM snapshots as evidence
- test GeoIP-gated pages through a configured proxy

## Example prompts
- Check this reflected XSS on the Cloudflare-protected page and save a snapshot and screenshot under `evidence/`.
- Open the protected login page, complete the sign-in flow, and confirm the session state.
- Test this GeoIP-gated page using the configured proxy.

## Similar
- [Parallel Browser MCP](https://affpapa.org/en/nevibecode/mcp/parallel-browser-mcp.md) — MCP server · ★ 41 repo stars
- [playwright-stealth](https://affpapa.org/en/nevibecode/mcp/playwright-stealth.md) — MCP server · ★ 81 repo stars
- [anti-detect-browser](https://affpapa.org/en/nevibecode/skills/anti-detect-browser.md) — skill · 168800 installs
- [camoufox-cli](https://affpapa.org/en/nevibecode/skills/camoufox-cli.md) — skill · 896 installs
- [browse-config](https://affpapa.org/en/nevibecode/skills/browse-config.md) — skill · 107 installs
- [Stealthy Auto Browse](https://affpapa.org/en/nevibecode/mcp/stealthy-auto-browse.md) — MCP server · ★ 98 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
