@pi-unipi/footer

Persistent status bar at the bottom of the terminal. Shows live stats from all Unipi packages — compactor tokens saved, memory count, MCP status, Ralph loops, workflow state, kanboard tasks, notifications.

Subscribes to events from every package and renders segments using Pi's setFooter + setWidget APIs. Responsive layout adjusts to terminal width, with a secondary row for narrow terminals.

Commands

| Command | Description | |---------|-------------| | /unipi:footer | Toggle footer on/off | | /unipi:footer <preset> | Switch preset (default, minimal, compact, full, nerd, ascii) | | /unipi:footer sep:<style> | Change separator style | | /unipi:footer icon:<style> | Change icon style (nerd, emoji, text) | | /unipi:footer on / /unipi:footer off | Enable/disable explicitly | | /unipi:footer-settings | Open settings TUI for per-group/per-segment toggles |

Special Triggers

Footer subscribes to events from every Unipi package:

| Group | Events | Segments | |-------|--------|----------| | core | Pi SDK | model, thinking, path, git, context_pct, cost, tokens, session | | compactor | COMPACTOR_STATS_UPDATED | session_events, compactions, tokens_saved, compression_ratio | | memory | MEMORY_STORED/DELETED/CONSOLIDATED | project_count, total_count, consolidations | | mcp | MCP_SERVER_STARTED/STOPPED/ERROR | servers_total, servers_active, tools_total | | ralph | RALPH_LOOP_START/END/ITERATION_DONE | active_loops, total_iterations, loop_status | | workflow | WORKFLOW_START/END | current_command, sandbox_level, command_duration | | kanboard | Direct registry read | docs_count, tasks_done, tasks_total, task_pct | | notify | NOTIFICATION_SENT | platforms_enabled, last_sent |

Footer works even if packages load after it — late-arriving events update the cache.

Presets

| Preset | Description | |--------|-------------| | default | Balanced: model, thinking, path, git, context, cost + compactor + memory + ralph | | minimal | Essentials only: path, git, context | | compact | Core + key stats: model, git, cost, context + compactor + memory | | full | Everything from all groups | | nerd | Full + hostname + time + session + extensions | | ascii | Core segments with ASCII icons |

Segment Groups

| Group | Default | Data Source | |-------|---------|-------------| | core | ON | Pi SDK (ctx.sessionManager, footerData) | | compactor | ON | COMPACTOR_STATS_UPDATED event | | memory | ON | MEMORY_STORED/DELETED/CONSOLIDATED events | | mcp | ON | MCP_SERVER_STARTED/STOPPED/ERROR events | | ralph | ON | RALPH_LOOP_START/END/ITERATION_DONE events | | workflow | ON | WORKFLOW_START/END events | | kanboard | ON | Kanboard registry (direct read) | | notify | OFF | NOTIFICATION_SENT event | | status_ext | ON | footerData.getExtensionStatuses() |

Configurables

Settings in ~/.pi/agent/settings.json under unipi.footer:

{
  "unipi": {
    "footer": {
      "enabled": true,
      "preset": "default",
      "separator": "powerline-thin",
      "iconStyle": "nerd",
      "groups": {
        "compactor": {
          "show": true,
          "segments": {
            "session_events": true,
            "compactions": true,
            "tokens_saved": true
          }
        }
      }
    }
  }
}

Separator Styles

| Style | Look | |-------|------| | powerline | Thick powerline arrows | | powerline-thin | Thin powerline arrows (default) | | slash | / | | pipe | | | | dot | Middle dot | | ascii | > < |

Icon Styles

| Style | Description | |-------|-------------| | nerd | Nerd Font glyphs (auto-detected) | | emoji | Unicode symbols (works on most terminals) | | text | Plain text abbreviations (works everywhere) |

When iconStyle is not set, footer auto-detects Nerd Font support and defaults to nerd if available, emoji otherwise.

Responsive Layout

Wide terminal (>120 cols):
  model | thinking | path | git | context | cost | compactions | tokens_saved | project_count

Narrow terminal (<120 cols):
  Row 1: model | thinking | path | git | context | cost
  Row 2: compactions | tokens_saved | project_count | ralph | workflow

License

MIT