@prjct.app/pi-ui

A unified Pi interface with a transcript and a focused status line. Tool rows come from pi-activity.

Packages

Package details

extensiontheme

Install @prjct.app/pi-ui from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@prjct.app/pi-ui
Package
@prjct.app/pi-ui
Version
1.0.0
Published
Oct 15, 2026
Downloads
694/mo · 217/wk
Author
jlopezlira
License
MIT
Types
extension, theme
Size
1.6 MB
Dependencies
1 dependency · 4 peers
Pi manifest JSON
{
  "image": "https://raw.githubusercontent.com/prjct-app/pi-ui/main/docs/cover.png",
  "themes": [
    "./themes/prjct-theme.json"
  ],
  "extensions": [
    "./index.ts"
  ]
}

Security note

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

README

pi-ui

pi-ui — for PI Agent

A single Pi extension for the footer and transcript of PI Agent. It does not set a startup header. Tool rows and the activity inspector come from @prjct.app/pi-activity.

Features

  • A focused footer with project, session, Git branch, model, thinking level, and context usage.
  • The bundled prjct-theme dark palette for a consistent activity, footer, Markdown, diff, and syntax experience.
  • Pi Plan status at the start of the footer and the Codex Fast icon beside the model when those extensions are active.

Install

pi install npm:@prjct.app/pi-ui

For a project-only installation:

pi install -l npm:@prjct.app/pi-ui

Remove @prjct.app/pi-statusline when migrating. Install @prjct.app/pi-activity next to pi-ui for compact tool rows and the /activity inspector.

Select prjct-theme from /settings, or set it directly in settings.json:

{
  "theme": "prjct-theme"
}

To test a local checkout:

pi -e ./index.ts

Commands

Compatibility

Tested with Pi 0.85.1 and Node.js 22.19+. The extension uses documented Pi APIs and is active only where each interface is supported. The footer requires TUI mode.

The custom footer replaces Pi's default footer. It intentionally reads only Pi Plan and Codex Fast extension statuses rather than aggregating every extension status.

Development

npm install
npm run check
npm test
npm pack --dry-run

See docs/package.md for package structure and API details.

License

MIT.