@jaggerxtrm/pi-extensions

Unified Pi extension entrypoint for xtrm-managed extensions

Packages

Package details

extension

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

npm repohome report
$ pi install npm:@jaggerxtrm/pi-extensions
Package
@jaggerxtrm/pi-extensions
Version
0.9.0
Published
Jun 7, 2026
Downloads
1,738/mo · 211/wk
Author
jaggerxtrm
License
MIT
Types
extension
Size
220.9 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

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

README

@jaggerxtrm/pi-extensions

Unified runtime package for xtrm-managed Pi extensions.

Publish contract

  • Package is published as @jaggerxtrm/pi-extensions (public npm package).
  • No build step is required. Pi loads raw TypeScript extension entrypoints at runtime.
  • prepublishOnly runs verify:runtime to ensure required runtime assets exist:
    • src/index.ts
    • src/registry.ts
    • extensions/
    • themes/
  • Files shipped to npm are controlled by files in package.json.

Release workflow

From repository root:

npm run release:pi-extensions

To publish both root xtrm-tools and this package in one pass:

npm run release:all

Install contract

Managed project runtime install path:

pi install npm:@jaggerxtrm/pi-extensions

Pi discovers this package through:

  • keywords: ["pi-package"]
  • pi.extensions: ["./src/index.ts"]

After install, keep .pi/settings.json package wiring pointed at npm:@jaggerxtrm/pi-extensions.

Managed extensions

Notable bundled extensions include:

  • xtrm-ui — XTRM Pi chrome, native tool summaries, selectable external tool chrome (/xtrm-ui chrome background|box).
  • sp-terminal-overlay — /sp-feed streaming overlay, /sp-ps snapshot overlay, and /xtrm-terminal shell overlay for specialist monitoring.
  • serena-pool — shared Serena MCP daemon per repo root; sets SERENA_MCP_PORT for pi-serena-tools, reuses daemons across sessions, and safely cleans up owned orphan process groups.