@phux/pi

Pi integration for controlling shared phux terminals

Packages

Package details

extensionskill

Install @phux/pi from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@phux/pi

Package: @phux/pi
Version: 0.5.0
Published: Oct 13, 2026
Downloads: 611/mo · 206/wk
Author: phall
License: Apache-2.0
Types: extension, skill
Size: 475.4 KB
Dependencies: 1 dependency · 3 peers

Pi manifest JSON

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

Security note

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

README

@phux/pi

Pi package for selecting, orchestrating, and supervising shared phux terminals through the external canonical CLI. It appends cache-preserving fleet context at user-turn boundaries and provides bounded pane inventory, literal paste, acknowledged agent turns, finite screen/agent/resource waits, runtime discovery, spawn/launch with local placement, insert/move/swap topology edits, confirmed kill/destructive-signal controls, tags, asks, finite event collection, composited snapshots, and branch-local aliases/groups. Input and destructive actions reject Pi's hosting pane after target resolution; broad raw write selectors are refused. It does not expose pairing credentials or emulate missing CLI operations. Input-authority tools are blocked upstream: the CLI's connection-scoped lease is released as soon as a one-shot invocation disconnects, so it cannot provide a durable Pi tool action. Installation, compatibility, the exact tool and command surface, lifecycle behavior, and safety boundaries live in the canonical Pi integration guide.

Development and validation

Install the locked development dependencies from this directory:

npm ci
npm run gates

The real integration harness is opt-in:

PHUX_PI_REAL_SMOKE=1 npm run smoke:real

pack:check, smoke:load, and smoke:real own the package-local artifact and harness checks. Consumer setup and operational interpretation remain in the Pi integration guide.