@pi-unipi/info-screen

Dashboard overlay that shows what's running. Displays module status, registered tools, custom data groups, and load times in a tabbed interface.

Every Unipi module registers itself via MODULE_READY events. Info-screen picks these up and builds a live dashboard. Other packages add their own data groups — ralph shows active loops, memory shows counts, compactor shows token savings.

Commands

Command	Description
/unipi:info	Show info screen dashboard
/unipi:info-settings	Configure info display (groups, stats, visibility)

Special Triggers

Info-screen listens for MODULE_READY events from @pi-unipi/core. When a module loads, info-screen adds it to the modules group automatically. No registration needed for basic module tracking.

Packages that want custom data groups use the registry API:

import { infoRegistry } from "@pi-unipi/info-screen";

infoRegistry.registerGroup({
  id: "my-module",
  name: "My Module",
  icon: "📦",
  priority: 60,
  config: {
    showByDefault: true,
    stats: [
      { id: "status", label: "Status", show: true },
      { id: "count", label: "Count", show: true },
    ],
  },
  dataProvider: async () => ({
    status: { value: "running" },
    count: { value: "42", detail: "items processed" },
  }),
});

The footer package reads info-screen data for its extension status segment.

Registry API

Method	Description
registerGroup(group)	Register an info group
unregisterGroup(id)	Remove a group
getGroups()	Get visible groups (sorted by priority)
getAllGroups()	Get all groups (including hidden)
getGroupData(id)	Get data for a group (cached)
updateGroupData(id, data)	Manually update group data
getVisibleStats(id)	Get enabled stats for a group
invalidateCache(id)	Invalidate cached data

The registry is a singleton, also available globally via globalThis.__unipi_info_registry.

Load Tracking

import { startLoadTracking, recordLoadTime, finishLoadTracking, recordModuleStart } from "@pi-unipi/info-screen";

startLoadTracking();
recordModuleStart("@pi-unipi/memory");
// ... module loads ...
recordLoadTime("@pi-unipi/memory", "module", 150);
finishLoadTracking();

Configurables

Settings in pi settings.json:

{
  "unipi": {
    "infoScreen": {
      "showOnBoot": true,
      "bootTimeoutMs": 8000,
      "groups": {
        "modules": { "show": true },
        "ralph": { "show": true },
        "memory": { "show": false }
      },
      "groupOrder": ["modules", "ralph", "subagents"]
    }
  }
}

Setting	Default	What It Does
showOnBoot	true	Show dashboard when session starts
bootTimeoutMs	8000	How long to wait for modules before showing
groups.{id}.show	true	Toggle group visibility
groupOrder	priority sort	Custom group ordering

License

MIT