docs(pi): unify split package trees; move live OMP pages to core
Two directories documented one concept (pi npm packages): top-level packages/ (browser-use, permission-system) and pi/packages/ (peon, web-access, subagents). Merged into pi/packages/ — one row per package in a single index, detail pages kept as archive records. The root index's 'OMP packages and skills' section was doubly wrong (packages/ was pi, not OMP); it becomes a Skills tooling section pointing at the consolidated /skills/ tree. Moved the two LIVE omp pages out of the retired-harness banner: pi/statusline.md -> core/statusline.md, pi/subagent-limits.md -> core/subagent-limits.md (both document omp behavior against agent/config.yml + the installed bundle; pi/index.md itself admitted the mis-shelf). Retargeted every inbound link (core/index, system/ dankserver, log x2, pi/index, settings x2, moved files' own xrefs). Refs #29
This commit is contained in:
Frank committed
1 parent
39385636be
commit
99b9a6a17c
13 files changed
+53
-80
No files matched your search
@@ -1,29 +1,27 @@
|
||||
# Pi Packages
|
||||
|
||||
Pi extends its functionality through npm packages installed via `pi install`. Each package provides extensions, skills, prompts, or themes.
|
||||
Pi extended itself through npm packages (`pi install npm:<name>`), each
|
||||
bundling extensions, skills, prompts, or themes. The harness is retired
|
||||
(2026-10-18); this page is the merged census of what was installed — one row
|
||||
per package, detail pages kept as historical records.
|
||||
|
||||
## Installed Packages
|
||||
## Installed packages
|
||||
|
||||
| Package | Version | Description |
|
||||
|---------|---------|-------------|
|
||||
| [[pi-peon|pi-peon]] | 0.1.1 | CESP/OpenPeon sound-pack player for pi lifecycle events |
|
||||
| [[pi-web-access|pi-web-access]] | 0.22.0 | Web search, URL fetching, GitHub cloning, PDF extraction, video understanding |
|
||||
| Package | Version | Detail | What it did |
|
||||
|---------|---------|--------|-------------|
|
||||
| `@wierdbytes/pi-peon` | 0.1.1 | [Pi Peon](pi-peon.md) | CESP/OpenPeon sound-pack player for pi lifecycle events. |
|
||||
| `pi-web-access` | 0.22.0 | [Pi Web Access](pi-web-access.md) | Web search, URL fetching, GitHub cloning, PDF extraction, video understanding. |
|
||||
| `pi-subagents` | 0.36.0 | [Pi Subagents](pi-subagents.md) | Core subagent delegation — chains, parallel execution, TUI clarification. |
|
||||
| `pi-browser-use` | — | [Pi Browser Use](pi-browser-use.md) | Browser automation wrapping chrome-devtools-mcp behind a `browser_` prefix. |
|
||||
| `pi-permission-system` | — | [Pi Permission System](pi-permission-system.md) | Permission enforcement and policy configuration; upstream docs are 10 interlinked pages. |
|
||||
|
||||
## Core Extension
|
||||
## Where the concepts live now
|
||||
|
||||
| Package | Version | Description |
|
||||
|---------|---------|-------------|
|
||||
| [[pi-subagents|pi-subagents]] | 0.36.0 | Core subagent delegation — chains, parallel execution, TUI clarification |
|
||||
|
||||
---
|
||||
* Subagent delegation → [OMP Subagent Limits & Fan-out Policy](/core/subagent-limits.md) (live caps).
|
||||
* Skill/package distribution → [Skills](/skills/index.md) (Agent Skills standard + `skills` CLI).
|
||||
* Web access → the `web/searxng` provider and MCP tooling; see [Agentic web research](/agentic-web-research/index.md).
|
||||
|
||||
## See Also
|
||||
|
||||
- [[settings|settings]] — Package configuration in settings.json
|
||||
- [pi](../index.md) — Pi configuration overview
|
||||
|
||||
* [Pi Peon](pi-peon.md) — CESP/OpenPeon sound-pack player for pi lifecycle events — peons, GLaDOS, battlecruisers, and 300+ community sound packs.
|
||||
|
||||
* [Pi Subagents](pi-subagents.md) — Core pi extension for delegating tasks to subagents with chains, parallel execution, and TUI clarification.
|
||||
|
||||
* [Pi Web Access](pi-web-access.md) — Web search, URL fetching, GitHub cloning, PDF extraction, and video understanding for Pi. Zero-config with Exa MCP.
|
||||
- [Pi Settings System](/core/settings.md) — where these packages were registered (`settings.json` archive).
|
||||
- [Pi Configuration](/pi/index.md) — pi-era overview.
|
||||
@@ -0,0 +1,117 @@
|
||||
---
|
||||
type: reference
|
||||
title: Pi Browser Use
|
||||
description: Browser automation extension wrapping chrome-devtools-mcp with a browser_ prefix for pi-coding-agent.
|
||||
resource: https://github.com/TGYD-helige/pi
|
||||
tags:
|
||||
- pi
|
||||
- package
|
||||
- browser
|
||||
- chrome-devtools-mcp
|
||||
- unverified
|
||||
timestamp: 2026-08-28
|
||||
---
|
||||
[pi-browser-use](https://github.com/TGYD-helige/pi) is a pi-coding-agent extension that wraps [chrome-devtools-mcp](https://github.com/ChromeDevTools/chrome-devtools-mcp), exposing all browser automation tools with a unified `browser_` prefix.
|
||||
|
||||
**License:** Apache-2.0
|
||||
|
||||
---
|
||||
|
||||
## 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
|
||||
|
||||
```bash
|
||||
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`:
|
||||
|
||||
```json
|
||||
{
|
||||
"pi-browser-use": {
|
||||
"headless": true,
|
||||
"channel": "stable",
|
||||
"viewport": "1280x720",
|
||||
"experimentalVision": true
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### As Standalone MCP Server
|
||||
|
||||
```bash
|
||||
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
|
||||
|
||||
```json
|
||||
{
|
||||
"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](/skills/index.md) for the skill toolchain that replaced pi-package distribution.
|
||||
- See [OKF Specification](/references/okf-spec.md) for the knowledge bundle format.
|
||||
@@ -81,5 +81,5 @@ The `/peon` command opens an interactive settings modal with:
|
||||
|
||||
## See Also
|
||||
|
||||
- [packages](../../packages/index.md) — Package overview
|
||||
- [Pi Packages](index.md) — Package overview
|
||||
- [pi](../index.md) — Pi configuration
|
||||
@@ -0,0 +1,37 @@
|
||||
---
|
||||
type: reference
|
||||
title: Pi Permission System
|
||||
description: Permission enforcement and policy configuration system for pi-coding-agent extensions.
|
||||
resource: https://github.com/gotgenes/pi-permission-system
|
||||
tags:
|
||||
- pi
|
||||
- package
|
||||
- permissions
|
||||
- unverified
|
||||
timestamp: 2026-08-28
|
||||
---
|
||||
[pi-permission-system](https://github.com/gotgenes/pi-permission-system) is the permission enforcement and policy configuration system for pi-coding-agent extensions.
|
||||
|
||||
---
|
||||
|
||||
## Documentation Index
|
||||
|
||||
| Document | File | Description |
|
||||
|----------|------|-------------|
|
||||
| Overview | README.md | Package overview, install, quick start, feature list |
|
||||
| Configuration | configuration.md | Full policy reference, runtime knobs, per-agent overrides, common recipes |
|
||||
| Session Approvals | session-approvals.md | Session-scoped rules, pattern suggestions, bash arity table |
|
||||
| Cross-Extension API | cross-extension-api.md | Service accessor, event bus, decision/UI-prompt broadcasts |
|
||||
| Subagent Integration | subagent-integration.md | Permission forwarding, coexistence with subagent extensions |
|
||||
| Frontmatter Convention | permission-frontmatter-for-subagent-extensions.md | Convention guide for subagent extension authors |
|
||||
| OpenCode Compatibility | opencode-compatibility.md | Shared concepts, divergences, porting guide |
|
||||
| Troubleshooting | troubleshooting.md | Common issues, diagnostic logging, threat model |
|
||||
| Migration: Legacy → Flat | legacy-to-flat.md | Migration from pre-v2 config layout |
|
||||
| Migration: Strict Validation | strict-config-validation.md | Strict config validation (breaking) — reading and fixing rejected configs |
|
||||
|
||||
---
|
||||
|
||||
## Cross-References
|
||||
|
||||
- See [Skills](/skills/index.md) for the skill toolchain that replaced pi-package distribution.
|
||||
- See [AGENTS.md Format](/core/agents-md-format.md) for the system-level instruction format that governs how this system is referenced in agent contracts.
|
||||
Reference in new issue
Block a user