@zigai/pi-footer

Pi package that replaces Pi's footer with a compact status line.

Packages

Package details

extension

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

npm repohome report
$ pi install npm:@zigai/pi-footer
Package
@zigai/pi-footer
Version
0.5.0
Published
Jul 17, 2026
Downloads
2,225/mo · 240/wk
Author
zigai
License
MIT
Types
extension
Size
283.8 KB
Dependencies
2 dependencies · 2 peers
Pi manifest JSON
{
  "image": "https://raw.githubusercontent.com/zigai/pi-tweaks/master/packages/pi-footer/assets/footer.png",
  "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 Footer

A minimalistic, single-line replacement for Pi's footer.

Pi Footer screenshot

Footer contents:

  • current working directory
  • git branch, with optional upstream ahead/behind counts
  • provider and model
  • thinking level
  • MCP status
  • context usage

Install

pi install npm:@zigai/pi-footer

Configuration

Global settings are stored in ~/.pi/agent/extension-settings/pi-footer.json.

Option Type Default Description
separator string "·" Text placed between visible footer slots.
showGitAheadBehind boolean false Show upstream commit counts (↑ahead ↓behind) beside the branch. Hidden when the branch has no upstream.
layout.left (branch | context | mcp | model | path | provider | thinking | string)[] ["path","branch","provider","model","thinking"] Footer slot IDs shown on the left in display order.
layout.right (branch | context | mcp | model | path | provider | thinking | string)[] ["context"] Footer slot IDs shown on the right in display order.
layout.hidden (path | branch | provider | model | thinking | mcp | context | string)[] [] Footer slot IDs hidden from both sides. 
{
  "$schema": "./schemas/pi-footer.schema.json",
  "separator": "·",
  "showGitAheadBehind": false,
  "layout": {
    "left": [
      "path",
      "branch",
      "provider",
      "model",
      "thinking"
    ],
    "right": [
      "context"
    ],
    "hidden": []
  }
}

Extension API

Other extensions can register custom footer slots through @zigai/pi-footer/api.

import { registerFooterSlot } from "@zigai/pi-footer/api";

const status = registerFooterSlot({
  id: "my-extension.status",
  defaultSide: "right",
  text: "ready",
});

status.setText("working");
status.clear();
status.dispose();

License

MIT