pi-header

Give PI Agent a minimal startup header showing the Pi logo and installed version.

@prjct.app/pi-header · Custom startup header and logo asset; one extension.

Install

Requires Pi installed separately and Node.js 22.19 or later. Compatibility is tested with Pi 0.85.1; newer versions are not yet verified. This is an independent community package.

Install with Pi's package manager:

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

For project-only installation, add -l: pi install -l npm:@prjct.app/pi-header. Restart Pi after installation. Do not install the same extension from both GitHub and npm: Pi treats those as different package identities.

Usage

Start an interactive Pi session to see the Pi logo and installed version in the header. It is enabled on load and has no additional commands.

The header replaces Pi's default startup header. Use one custom-header extension at a time. It does nothing in RPC, JSON, and print modes. Pi's image component supplies a textual fallback when the terminal cannot display the logo inline.

Manage the package

For an npm installation:

pi list
pi update npm:@prjct.app/pi-header
pi remove npm:@prjct.app/pi-header

Use pi config to enable or disable individual resources. Use pi config -l for project settings and add -l to removal when you installed locally.

To pin version 0.1.3, use pi install npm:@prjct.app/pi-header@0.1.3. Pi skips pinned npm versions during package updates. For a Git installation, update or remove using the same git:github.com/prjct-app/pi-header source instead of the npm source.

When switching from GitHub to npm, remove the Git installation first, then install the npm package and restart Pi.

Troubleshooting

If only text is visible, the terminal may not support inline images. If no custom header appears, confirm TUI mode and check for another custom-header extension.

Package and API documentation

Uses session_start, ctx.ui.setHeader(), the public Pi version export, and TUI Container, Image, and Text components.

See Package structure and compatibility for the manifest, dependency policy, shipped resources, and official references. This package follows the official Pi package guide and extension API guide for the tested version.

Development

From a repository checkout:

npm ci --ignore-scripts
npm run check
npm test
npm run check:package

Pi loads the TypeScript entry point directly; no build step is required. To try this checkout for one run, use pi -e .. Tests use isolated temporary state and do not call model APIs. See CONTRIBUTING.md for contribution rules and CHANGELOG.md for release notes.

License

MIT.

Third-party code or assets are credited in THIRD_PARTY_NOTICES.md; the accompanying licenses are included.