@cheetahbyte/pi-header

Pi extension that replaces the interactive header with a compact view of prompts, skills, extensions, and context.

Packages

Package details

extension

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

npm repo home report

$ pi install npm:@cheetahbyte/pi-header

Package: @cheetahbyte/pi-header
Version: 0.3.0
Published: Oct 4, 2026
Downloads: 196/mo · 17/wk
Author: cheetahbyte
License: MIT
Types: extension
Size: 11.7 KB
Dependencies: 0 dependencies · 2 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

Pi header

@cheetahbyte/pi-header replaces Pi's interactive header with a compact view of prompts, skills, extensions, and context.

Install

pi install npm:@cheetahbyte/pi-header

This package is part of Pi kit. If you install the kit, don't install this package separately.

Context display

The Context row keeps the working-directory name and shows the exact source paths reported by Pi's ResourceLoader, in Pi's built-in order:

getSystemPromptSource()
getAppendSystemPromptSources()
getAgentsFiles().agentsFiles

Paths inside the working directory are project-relative. Other paths use a home-relative form when possible.

Internal API coupling

Pi does not currently expose the resource loader through ExtensionContext. This extension installs an in-memory monkey patch on the exported AgentSession prototype. It captures the session's public resourceLoader during bindExtensions() and refreshes it during reload() before Pi emits session_start.

The patch is version-coupled to Pi's exported AgentSession and ResourceLoader APIs. If those APIs are unavailable, the extension warns and omits context paths. It never scans the filesystem, parses prompts, or guesses standard filenames. The patch changes only in-memory prototypes and state in the current Pi process.