← ClaudeAtlas

browser-debugginglisted

Debug the running NXTG-Forge web dashboard by driving a headless Chromium via the Playwright MCP server — read console errors, take screenshots, inspect the DOM accessibility tree, and watch network requests. Use when the dashboard renders blank or broken after a UI change, when the user reports browser console errors, after fixing a React bug (infinite loop, "Maximum update depth", stale state) to confirm it's gone, or when verifying a visual/interactive change (Command Center, Infinity Terminal) in the real running app rather than from tests alone.
nxtg-ai/forge-plugin · ★ 5 · Web & Frontend · score 73
Install: claude install-skill nxtg-ai/forge-plugin
# Browser Debugging Skill Drive a real (headless) Chromium against the running NXTG-Forge dashboard from inside Claude Code, using the **Playwright MCP** server. No Windows Chrome dependency — Playwright launches its own headless Chromium inside WSL. ## Where the tools come from (read first) The Playwright MCP server is registered in **`forge-ui/.mcp.json`**, NOT in the plugin's `.mcp.json` (which only registers governance / orchestrator / semgrep). The `browser_*` tools only exist when a Claude Code session has `forge-ui/.mcp.json` loaded — i.e. you are working in the `forge-ui/` repo. From the plugin repo alone they are unavailable. Config as shipped: ```jsonc "playwright": { "command": "npx", "args": ["@playwright/mcp@latest", "--headless", "--console-level", "debug"] } ``` Two consequences of that exact config: - `--console-level debug` → `browser_console_messages` returns **verbose debug logs**, not just errors. Filter for `error`/`warning` yourself; do not assume a clean-looking tail means no errors. - **No `--caps`** flag → the `pdf`, `vision` (coordinate clicks/screenshots), and `devtools` capabilities are OFF. `browser_pdf_save` and coordinate-based interaction are not available here. ## Prerequisites Start both servers from `forge-ui/` (one command starts Vite :5050 + Express API :5051): ```bash cd forge-ui && npm run dev ``` Confirm they're up before driving the browser: ```bash curl -sf http://localhost:5050 >/dev/null && echo "UI up" curl -sf http:/