pi-browser-tools

Browser automation tools for pi via Playwright (shared Chromium across sessions)

Packages

Package details

extensionskill

Install pi-browser-tools from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:pi-browser-tools

Package: pi-browser-tools
Version: 0.1.0
Published: Jun 4, 2026
Downloads: not available
Author: pankajudhas81
License: MIT
Types: extension, skill
Size: 65.6 KB
Dependencies: 1 dependency · 3 peers

Pi manifest JSON

{
  "extensions": [
    "./src/index.ts"
  ],
  "skills": [
    "./skills"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@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