command-center/omp-docs/packages/pi-browser-use.md at 39385636be99e9fdd19242eee19b31b99f27e5bf

0 Fork 0

Files

T

Frank 651924a4bc docs(skills): collapse three overlapping skills trees into one verified tree

Three parallel trees documented the same ecosystem: omp-docs/skills/
(two overview pages), tools/npx-skills/ (10 pi-era npm pages), and
tools/vercel-labs-skills/ (11 CLI pages), plus a fourth leaderboard page
at engineering/skills-ecosystem.md. Verbatim overlap (identical SKILL.md
field tables in skills-spec.md vs skill-format.md; 13-agent vs 68-agent
copies of the same upstream table). Consolidated to four concept pages:

- skills/agent-skills.md: standard, format, loading, authoring (merges
  skills-spec, skill-format, skill-file-structure, skill-loading,
  best-practices, skills-vs-extensions)
- skills/skills-cli.md: CLI reference (merges commands, source-formats,
  installation-scope, skill-discovery, lock-file, env-variables,
  agent-support, related-links)
- skills/store-wiring.md: moved, fleet ops, links retargeted
- skills/ecosystem.md: replaces skills-ecosystem.md; stale 2026-08-12
  top-50 table dropped, replaced with a live top-10 re-queried from the
  skills.sh API tonight and the API contract re-verified (zero-based,
  200/page, {skills,total,hasMore,page}, total 9909)

All facts re-verified 2026-10-19 against primary sources:
agentskills.io, vercel-labs/skills README + src/cli.ts (command set,
--full-depth) + src/skill-lock.ts (v3 lock, XDG path, wipe-on-old),
live skills.sh API. Deleted superseded core/index-doc.md (old pi-era
docs index). Retargeted all inbound links (tools/index, engineering x3,
packages x3, pi/skills, core/index). Pi-era npm skill packaging is
listed as archived under /pi/.

Refs #29

2026-10-19 02:58:52 -07:00

3.0 KiB

Raw Blame History

type, title, description, resource, tags, timestamp

type

title

description

resource

Features

Dynamic tool discovery — auto-proxies all upstream chrome-devtools-mcp tools with browser_ prefix
Tool description augmentation — adds usage hints for key tools
Result post-processing — strips embedded snapshots, detects overlay/stale element issues
Optional visual analysis — browser_analyze_screenshot via configurable vision model
Standalone mode — runnable as independent MCP server via CLI

Requirements

Node.js >= 20, Chrome (stable or newer), @earendil-works/pi-coding-agent >= 0.74.0.

Installation

pi install npm:@amaster.ai/pi-browser-use

Usage

As pi-coding-agent Extension (Recommended)

Auto-discovers and loads on session_start. Configure in .pi/settings.json:

{
  "pi-browser-use": {
    "headless": true,
    "channel": "stable",
    "viewport": "1280x720",
    "experimentalVision": true
  }
}

As Standalone MCP Server

npx @amaster.ai/pi-browser-use --headless --viewport=1280x720

Configuration

Session Mode

Mode	Description
`persistent` (default)	Reuses shared profile at `~/.pi/browser-profile`
`isolated`	Fresh ephemeral profile each session
`existing`	Connects to running browser instance

Browser Options

Option	Type	Default	Description
`headless`	`boolean`	`false`	Run headless
`channel`	`string`	—	Chrome channel: `canary`, `dev`, `beta`, `stable`
`viewport`	`string`	—	Viewport size, for example `1280x720`
`userDataDir`	`string`	—	Custom user data directory

Vision Model

{
  "pi-browser-use": {
    "visionModel": {
      "provider": "openai",
      "model": "gpt-4o"
    }
  }
}

Resolves API key and base URL from the model registry automatically.

Key Tools

Tool	Hint
`browser_click`	Use element uid from snapshot; UIDs invalidated after action
`browser_fill`	Does not work on canvas/custom widgets
`browser_press_key`	Accepts single key name only
`browser_take_snapshot`	Call first to get uids, and after every state-changing action

Cross-References

See Skills for the skill toolchain that replaced pi-package distribution.
See OKF Specification for the knowledge bundle format.

3.0 KiB Raw Blame History