pi-footer

A compact footer/status bar extension for pi coding agent.

This plugin is a simplified take on nicobailon/pi-powerline-footer, with a smaller configuration model plus a few extra features such as custom segment ordering, custom extension-status items, rainbow coloring, and a prompted input editor.

Features

• Powerline-style footer segments
• Presets for different levels of detail
• Fully custom segment order via footer.segments
• Custom items sourced from extension statuses
• rainbow color support for custom items
• Responsive overflow: segments that do not fit on the first footer line move to the next line
• Input editor polish:
  • left/right outer margin
  • single > prompt marker
  • multiline input alignment

Installation

pi install npm:@smoose/pi-footer

Basic configuration

Configure the plugin under the footer key in ~/.pi/agent/settings.json or project-local .pi/settings.json.

Minimal example:

{
  "footer": "default"
}

Object form:

{
  "footer": {
    "preset": "default"
  }
}

Presets

Available presets:

default
minimal
compact
full
nerd
ascii
custom

You can switch presets inside pi with:

/footer default
/footer minimal
/footer compact
/footer full
/footer nerd
/footer ascii
/footer custom

Running /footer with no arguments toggles the footer on/off for the current session.

Segment order

Use footer.segments to control the exact segment order.

{
  "footer": {
    "preset": "default",
    "segments": [
      "model",
      "thinking",
      "path",
      "git",
      "context_pct",
      "cache_read",
      "cost"
    ]
  }
}

The footer renders segments in the array order. If the line is too narrow, later visible segments overflow onto a second footer line.

If segments is omitted, the selected preset's default order is used and custom items are appended after preset segments.

Built-in segments

Supported built-in segment ids:

Segment	Description
model	Current model name
thinking	Current thinking level, e.g. think:med
shell_mode	Shell mode status, when available
path	Current working directory
git	Git branch and dirty state
subagents	Reserved segment; currently hidden
token_in	Input tokens
token_out	Output tokens
token_total	Input + output + cache tokens
cost	Session cost or (sub) for subscription usage
context_pct	Context usage percentage and window size
context_total	Context window size
time_spent	Session elapsed time
time	Current time
session	Session id prefix
hostname	Hostname
cache_read	Cache read tokens
cache_write	Cache write tokens
extension_statuses	Remaining extension statuses not lifted into custom items

Custom items

Custom items display values from pi extension statuses.

If another extension calls:

ctx.ui.setStatus("soul-mood", "👻 Susan·厌恶");

then you can show it in the footer with:

{
  "footer": {
    "preset": "default",
    "segments": [
      "custom:soul",
      "model",
      "thinking",
      "path",
      "git",
      "context_pct",
      "cache_read",
      "cost"
    ],
    "customItems": [
      {
        "id": "soul",
        "statusKey": "soul-mood",
        "color": "rainbow"
      }
    ]
  }
}

Custom segment ids are referenced as:

custom:<id>

For example:

custom:soul

Custom item fields

Field	Description
id	Custom item id; used by custom:<id>
statusKey	Key from ctx.ui.setStatus(key, value); defaults to id
color	Optional color name, hex color, or rainbow
prefix	Optional prefix shown before the status value
hideWhenMissing	Hide the item when no status exists; default true
excludeFromExtensionStatuses	Exclude this status from extension_statuses; default true

Colors

Custom item colors can be:

Hex colors

{
  "color": "#00afaf"
}

pi theme color names

Examples:

accent
success
warning
error
muted
dim
text
thinkingHigh
thinkingMedium
borderMuted

Rainbow

{
  "color": "rainbow"
}

rainbow applies the plugin's built-in per-character rainbow coloring.

Example configuration

{
  "footer": {
    "preset": "default",
    "segments": [
      "custom:soul",
      "model",
      "thinking",
      "path",
      "git",
      "context_pct",
      "cache_read",
      "cost",
      "extension_statuses"
    ],
    "customItems": [
      {
        "id": "soul",
        "statusKey": "soul-mood",
        "color": "rainbow"
      }
    ]
  }
}