📊 ompbar

Hub: 🔌 OMP Extensions · Contract: 🧭 Extension UX Contract · Runtime: omp only.

1. 💎 Blueprint

id: ompbar                 # display/SSOT id
runtime_file: ~/.omp/agent/extensions/statusbar.ts
rebrand: planned separately; do not load duplicate wrappers
config: ~/.omp/agent/statusbar.json
surface: widget          # colored · aboveEditor
command: /statusbar
command_owner: ompbar
api: pi.on(session_*) + pi.setWidget | pi.setStatus
deps: "@oh-my-pi/pi-tui"
status: planned          # loads; interactive HUD verification remains

2. 🎯 Purpose

Event-driven telemetry strip: model · context · tokens · TPS · git · tools · agents · quota · todos · update.

No polling loop — one change-gated render per tick; async work carries session epoch.

3. ⚙️ Config quick-ref

Key	Yours	Meaning
surface	widget	Color HUD (status = plain, ANSI stripped)
placement	aboveEditor	Widget position
order	brand→model→…→update	Segment left-to-right
segments.*.enabled	most on	Toggle per segment

4. 🎮 Commands

Command	Effect
/statusbar	Interactive config panel
/statusbar widget	Colored widget mode
/statusbar status	Plain status line
/statusbar debug	surface=widget todo=… quota=…
/statusbar reload	Hot-reload statusbar.json

5. 🔌 Optional event bus

OMP does not emit these — extensions or scripts can:

pi.events.emit("statusbar:loop", { remaining: 6 });   // ∞⁶
pi.events.emit("statusbar:mode", { key: "plan", text: "▤" });

Subagent lifecycle: listens on task:subagent:lifecycle.

6. 🏗️ Architecture

flowchart LR
  E[OMP events] --> S[statusbar.ts]
  C[statusbar.json] --> S
  S --> W[setWidget / setStatus]
  W --> TUI[Editor HUD]

7. ✅ Done when

• Bar visible above editor in interactive omp
• /statusbar debug → surface=widget
• Context + token segments update per turn
• Git segment refreshes after file saves

8. 🚧 Next (optional)

• Enable activity / clock segments in config
• Emit statusbar:loop from custom automation
• Deduplicate extensions/statusline/ dev copy if unused