Chromeish DevTools CLI

Give your AI agents (Claude CLI, Cursor, Windsurf, VSCode extensions, etc.) the power to "see" and "interact with" everything Chrome/Edge/Chromium DevTools can see.
This CLI tool exposes a bidirectional JSON protocol over stdin/stdout.

Features

• Console, network, DOM, performance monitoring
• Commands: navigate, eval, queryDom, screenshot, describe
• Self-describing schema for agent discovery

Quick Start

1. Install deps: npm install
2. Launch Chrome: chrome.exe --remote-debugging-port=9222 --user-data-dir="C:\temp\cdp-profile"
3. Run tool: npm start or npx ts-node chromeish-devtools-cli.ts

Usage Instructions

Running the Agent

Start the CLI in one terminal:

npm start
# or
npx ts-node chromeish-devtools-cli.ts

Sending Commands

You can send commands to the CLI from any terminal, human, or automation tool. For example:

echo '{"action":"queryDom","selector":"dbaas-dashboard-user-custom-views-toolbar"}' | npx ts-node chromeish-devtools-cli.ts

• Replace the JSON with any supported action and parameters.
• The CLI will process the command and output the result as JSON.

Example Command

{"action":"navigate","url":"https://example.com"}

Example Event

{"type":"console","payload":{"level":"error","text":"Uncaught ReferenceError"},"timestamp":1696000000}

Notes

• No VSCode launch profile or debugger setup is required.
• Multiple users or agents can interact with the CLI by sending JSON commands via stdin.
• See the agent's schema for supported actions (e.g., navigate, eval, queryDom, screenshot).

Troubleshooting

• Ensure the CLI process is running before sending commands.
• Check terminal output for results or errors.

---

MIT License