C02-1010751281/pi-browser-debug
Watch
1
0
Fork
You've already forked pi-browser-debug
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
2 commits 1 branch 2 tags 94 KiB
  • TypeScript 96.4%
  • JavaScript 2.9%
  • Shell 0.7%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
呼啸山庄 76e260383b fix(packaging): drop package.json so git installs need no npm 
pi discovers extensions/ by convention when no pi manifest is present;
these packages have no runtime dependencies, so npm install was pure
overhead and broke startup on machines without npm.
2026-09-12 22:36:51 +08:00
.codestable feat: browser-debug pi extension 2026-09-12 22:08:17 +08:00
extensions/browser-debug feat: browser-debug pi extension 2026-09-12 22:08:17 +08:00
tests feat: browser-debug pi extension 2026-09-12 22:08:17 +08:00
.gitignore feat: browser-debug pi extension 2026-09-12 22:08:17 +08:00
install.sh feat: browser-debug pi extension 2026-09-12 22:08:17 +08:00
LICENSE feat: browser-debug pi extension 2026-09-12 22:08:17 +08:00
README.md fix(packaging): drop package.json so git installs need no npm 2026-09-12 22:36:51 +08:00

README.md

browser-debug

pi extension：浏览器调试。安装：pi install git:github.com/P02-1010751281/pi-browser-debug@v0.1.1（源码 extensions/browser-debug/）。本包无 package.json（pi 按约定目录 extensions/ 自动发现），git 安装不依赖 npm；不要再加回。

Pi extension: browser debugging tools for Chromium (CDP) and Firefox (WebDriver BiDi). No npm dependencies — drivers are implemented directly on the global WebSocket/fetch.

Tools

Tool What it does
browser_launch Launch Chromium (CDP) or Firefox (BiDi). Default: headless Chromium
browser_attach Connect to an already running browser's debug port
browser_status Show connection info + tabs
browser_tabs List / select / close tabs
browser_open Open a URL in a new tab (auto-launches headless Chromium if needed)
browser_navigate Navigate an existing tab and wait for load
browser_eval Run JS and get the JSON result
browser_console Buffered console messages + uncaught exceptions
browser_network Buffered requests: method, status, URL, MIME, timing, failures
browser_screenshot PNG screenshot (viewport or full page), returned as an image + saved to /tmp/pi-browser-shots/
browser_dom outerHTML of a selector or whole document
browser_click Real mouse click by CSS selector
browser_type Focus + type text (optional clear / Enter)
browser_wait Wait for selector / text / URL / delay
browser_close Disconnect; kills the process if this extension launched it

Slash command: /browser [status|tabs|launch [url]|close] — /browser launch opens a visible Chromium.

Attaching to your own browser

  • Chromium (Chrome, Chromium, Helium, Brave, Edge): google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/debug-profile then browser_attach { "browser": "chromium", "port": 9222 }.
  • Firefox: must be a fresh instance started with remote debugging: firefox --no-remote --profile /tmp/debug-profile --remote-debugging-port 9222 then browser_attach { "browser": "firefox", "port": 9222 }. An already-running Firefox cannot be attached to; the flag must be set at startup.

Notes

  • Chromium binary lookup order: executablePath → PI_CHROMIUM_PATH → /opt/helium-browser-bin/chrome → google-chrome → chromium → brave-browser → microsoft-edge.
  • Firefox lookup: executablePath → PI_FIREFOX_PATH → /usr/bin/firefox → firefox.
  • Launched browsers use a fresh temporary profile unless profile is passed.
  • Headless browsers launched by this extension are terminated on /quit / session shutdown. Attached browsers are only disconnected.
  • Firefox console/network capture relies on WebDriver BiDi log and network events; on old Firefox builds the network list may stay empty.