pi-browser-tools

内容来源:README.md(说明文档) · 原始地址 · 查看安装指南

原始内容

@pankajudhas81/pi-browser

Browser automation tools for pi via Playwright. Spawns a single shared Chromium on first use, persists cookies and logins, and exposes a snapshot-driven tool surface. All concurrent pi sessions attach to the same Chromium over CDP — a fresh login is visible everywhere.

Install

pi install npm:@pankajudhas81/pi-browser

Or reference a local checkout in settings.json:

{
    "packages": ["/absolute/path/to/pi-browser"]
}

Prerequisites

  • pi installed
  • Chromium is downloaded by Playwright on first launch

Tools

Tool Purpose
browser_navigate / browser_back / browser_forward Navigation
browser_wait_for Wait for text, URL, or load state
browser_snapshot Accessibility-tree snapshot with [ref=N] markers
browser_click / browser_type / browser_hover / browser_select Interaction
browser_upload Attach files to a file input
browser_screenshot PNG of viewport, full page, or element
browser_eval / browser_console Run JS / read console + page errors
browser_tabs_list / browser_tabs_new / browser_tabs_select / browser_tabs_close Tab management

Commands

Command Description
/browser-status Summary of the shared browser (endpoint, tabs)
/browser-quit Terminate the shared Chromium across all pi sessions
/browser-headless Toggle headless mode for the next launch

Skill

The browser skill teaches the snapshot → ref → act → re-snapshot loop, login flow with the persistent profile, and when to screenshot vs snapshot.

License

MIT