` | Navigate to URL and snapshot |\n| `snapshot` | Capture current page state |\n| `screenshot ` | Save a screenshot to a file |\n| `scroll
` | Scroll: up, down, top, bottom |\n| `back` | Navigate back |\n| `wait ` | Wait for time or text to appear |\n| `eval ` | Evaluate a JavaScript expression or function |\n| `run` | Execute a multi-step script from stdin |\n\n`eval` wraps plain input as `() => ()` before sending it to DevTools. For multi-statement logic, pass an arrow function or `function`. No-arg IIFE form `(...)()` is accepted too and unwrapped automatically.\n\n```sh\nchrome-devtools-axi eval \"document.title\"\nchrome-devtools-axi eval \"() => { const rows = [...document.querySelectorAll('tr')]; return rows.map((row) => row.textContent) }\"\n```\n\n### Interaction\n\n| Command | Description |\n| -------------------------- | ------------------------------ |\n| `click @` | Click an element by ref |\n| `fill @ ` | Fill a form field |\n| `type ` | Type text at current focus |\n| `press ` | Press a keyboard key |\n| `hover @` | Hover over an element |\n| `drag @ @` | Drag an element onto another |\n| `fillform @=...` | Fill multiple form fields |\n| `dialog ` | Handle a browser dialog |\n| `upload @ ` | Upload a file through an input |\n\n### Page Management\n\n| Command | Description |\n| ----------------- | --------------------------- |\n| `pages` | List all open tabs |\n| `newpage ` | Open a new tab |\n| `selectpage ` | Switch to a tab by ID |\n| `closepage ` | Close a tab by ID |\n| `resize ` | Resize the browser viewport |\n\n### Emulation\n\n| Command | Description |\n| --------- | ------------------------------- |\n| `emulate` | Emulate device/network/viewport |\n\n### DevTools Debugging\n\n| Command | Description |\n| ------------------ | ------------------------------ |\n| `console` | List console messages |\n| `console-get ` | Get a specific console message |\n| `network` | List network requests |\n| `network-get [id]` | Get a specific network request |\n\n### Performance\n\n| Command | Description |\n| --------------------------- | ----------------------------- |\n| `lighthouse` | Run a Lighthouse audit |\n| `perf-start` | Start a performance trace |\n| `perf-stop` | Stop the performance trace |\n| `perf-insight ` | Analyze a performance insight |\n| `heap ` | Capture a heap snapshot |\n\n### Bridge\n\n| Command | Description |\n| ------- | ----------------------- |\n| `start` | Start the bridge server |\n| `stop` | Stop the bridge server |\n\nRunning with no command shows the CLI home view. It prepends `bin` and\n`description` metadata, then includes the current snapshot when a browser\nsession is active or the no-session status/help block when one is not.\n\n### Flags\n\n| Flag | Description |\n| --------------------------- | ------------------------------------------- |\n| `--help` | Show usage information |\n| `-v`, `-V`, `--version` | Show the installed CLI version |\n| `--full` | Show complete output without truncation |\n| `--background` | Open new page in background (newpage) |\n| `--uid @` | Target a specific element (screenshot) |\n| `--full-page` | Capture entire scrollable page (screenshot) |\n| `--format ` | Image format: png, jpeg, webp (screenshot) |\n| `--viewport ` | Viewport like \"390x844x3,mobile\" (emulate) |\n| `--color-scheme ` | dark, light, or auto (emulate) |\n| `--network ` | Network throttle: Slow 3G, etc. (emulate) |\n| `--cpu ` | CPU throttling rate 1-20 (emulate) |\n| `--geolocation x` | Set geolocation (emulate) |\n| `--user-agent ` | Custom user agent (emulate) |\n| `--type ` | Filter by type (console, network) |\n| `--limit ` | Max items to return (console, network) |\n| `--page ` | Pagination (console, network) |\n| `--device ` | desktop or mobile (lighthouse) |\n| `--mode ` | navigation or snapshot (lighthouse) |\n| `--output-dir ` | Directory for reports (lighthouse) |\n| `--no-reload` | Skip page reload (perf-start) |\n| `--no-auto-stop` | Disable auto-stop (perf-start) |\n| `--file ` | Save trace data to file (perf-start/stop) |\n| `--response-file ` | Save response body (network-get) |\n| `--request-file ` | Save request body (network-get) |\n\n`console --type` accepts `log`, `debug`, `info`, `error`, `warn`, `dir`, `dirxml`, `table`, `trace`, `clear`, `startGroup`, `startGroupCollapsed`, `endGroup`, `assert`, `profile`, `profileEnd`, `count`, `timeEnd`, `verbose`, `issue`, and `all`.\n`network --type` accepts `document`, `stylesheet`, `image`, `media`, `font`, `script`, `texttrack`, `xhr`, `fetch`, `prefetch`, `eventsource`, `websocket`, `manifest`, `signedexchange`, `ping`, `cspviolationreport`, `preflight`, `fedcm`, `other`, and `all`.\nFor both commands, `all` or an omitted `--type` returns every item.\n\n## Configuration\n\nThe bridge server port defaults to `9224`. Override it with an environment variable:\n\n```sh\nexport CHROME_DEVTOOLS_AXI_PORT=9225\n```\n\nConnect to an existing Chrome instance instead of launching one:\n\n```sh\nexport CHROME_DEVTOOLS_AXI_BROWSER_URL=http://127.0.0.1:9222\n```\n\n`CHROME_DEVTOOLS_AXI_BROWSER_URL` accepts both `http://` or `https://` URLs and `ws://` or `wss://` endpoints:\n\n- `http(s)://` uses `--browserUrl` and fetches `/json/version` to discover the WebSocket URL.\n- `ws(s)://` uses `--wsEndpoint` directly.\n\nFor authenticated `ws://` or `wss://` endpoints, pass JSON headers with `CHROME_DEVTOOLS_AXI_WS_HEADERS`:\n\n```sh\nexport CHROME_DEVTOOLS_AXI_BROWSER_URL=wss://cluster.example/launch\nexport CHROME_DEVTOOLS_AXI_WS_HEADERS='{\"Authorization\":\"Bearer token\"}'\n```\n\nState is stored in `~/.chrome-devtools-axi/`:\n\n| File | Purpose |\n| --------------------- | ------------------------------------- |\n| `bridge.pid` | PID and port of the running bridge |\n| `snapshot-generation` | Counter used to detect stale uid refs |\n\n### Session Hooks\n\nOn supported agents, the packaged CLI also installs a `SessionStart` hook in `~/.claude/settings.json` and `~/.codex/hooks.json`, and enables `hooks` in `~/.codex/config.toml`.\n\nSet `CHROME_DEVTOOLS_AXI_DISABLE_HOOKS=1` to skip that auto-install behavior.\n\nDevelopment entrypoints such as `pnpm run dev` and `bin/chrome-devtools-axi.ts` do not modify those hook files.\n\n## Development\n\n```sh\npnpm run build # Compile TypeScript to dist/\npnpm run dev # Run CLI directly with tsx\npnpm test # Run tests with vitest\npnpm run test:watch # Run tests in watch mode\n```\n","readmeFilename":"README.md"}![\"npm\"](\"https://img.shields.io/npm/v/chrome-devtools-axi?style=flat-square\")
\n ![\"CI\"](\"https://img.shields.io/github/actions/workflow/status/kunchenguid/chrome-devtools-axi/ci.yml?style=flat-square&label=CI\")
\n ![\"Release\"](\"https://img.shields.io/github/actions/workflow/status/kunchenguid/chrome-devtools-axi/release-please.yml?style=flat-square&label=Release\")
\n ![\"Platform\"](\"https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-blue?style=flat-square\"){kind=icon}
\n ![\"X\"](\"https://img.shields.io/badge/X-@kunchenguid-black?style=flat-square\"){kind=icon}
\n ![\"Discord\"](\"https://img.shields.io/discord/1439901831038763092?style=flat-square&label=discord\")
\n