pi-zentui 0.27.1 → 0.29.0

package/README.md

@@ -1,6 +1,6 @@
 <h1 align="center">Zentui</h1>
 
-<p align="center">A modular terminal UI for <a href="https://pi.dev">Pi</a>.</p>
+<p align="center">A modular terminal UI for <a href="https://pi.dev">Pi</a> and <a href="https://omp.sh">Oh My Pi</a>.</p>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/pi-zentui"><img alt="npm version" src="https://shieldcn.dev/npm/pi-zentui.svg?variant=outline" /></a>
@@ -89,6 +89,29 @@ pi install npm:pi-zentui
 pi install git:github.com/lmilojevicc/pi-zentui
 ```
 
+### Oh My Pi
+
+Requires OMP **18.4.10 or newer**. From this checkout:
+
+```bash
+# Try without changing installed plugins
+npm run omp:dev
+
+# Persistently link the development checkout
+npm run omp:install-local
+```
+
+OMP loads `omp.ts` through the package's `omp.extensions` manifest; Pi keeps its existing entrypoint. Configuration is separate: `~/.omp/agent/zentui.json` by default, or the active OMP profile's agent directory.
+
+The OMP port is deliberately a small skin: **Editor, User messages, and Statusline only**. `/zentui` has those three sections; Working, thinking, selectors, and summaries remain OMP-owned. Pi keeps the full Zentui component set. Saved choices for unsupported OMP surfaces are not rewritten.
+
+Opencode and Minimalist metadata include OMP's supported `fast`/`ultrafast` mode. Existing custom templates are unchanged; add `$fast_mode` explicitly where wanted. Statusline supports the same token independently.
+
+OMP also exposes opt-in [template data](./docs/configuration.md#omp-template-data) for session ID, PR number/URL, subagent count, token rate, active processing time, hostname, provider quota, Vim/OMP modes, and collaboration/stream state. Use the same named variables in Opencode metadata, Minimalist slots, or Starship wide/compact formats. Defaults are unchanged; `$usage_quota` explicitly opts into OMP's usage-report API, which may refresh authenticated reports.
+
+**Statusline → Starship** replaces OMP's native status content rather than adding another line. **Hidden** suppresses native main status content and shows only permitted extension statuses; **Native** restores OMP's own line. This works with Zentui Editor enabled or disabled. OMP's inert `setFooter()` API is adapted through guarded, session-scoped native renderer decoration; native settings and other sessions/previews are left alone. All built-in composer layouts are supported; unfamiliar frame/message shapes fail open. See [OMP compatibility](./docs/configuration.md#oh-my-pi-compatibility).
+
+
 ## Configure
 
 Run `/zentui` inside Pi to configure Appearance, Editor, User messages, Thinking (Experimental), Working line, Footer, and Extension statuses. With Starship selected, Footer contains **Segments →** and **Git →** child pages. Use `Tab` and `Shift+Tab` to switch sections; compact help follows your configured selection keys. Every section has a direct route (for example, `/zentui footer`). `/zentui segments` and `/zentui git` open Footer child pages when Starship is active; under Native or Hidden they open Footer with a requires-Starship explanation. `/zentui extensions` always opens independent default/per-key status visibility, without changing Footer style or saved Starship placement/color preferences. The configured cancel key returns from a child to Footer; at the top level it closes settings. Extension statuses are published keyed Footer statuses, not extension management or Working line integrations. Inactive options retain their saved preferences. Most changes apply live. Active Streaming can switch live to Rail or Tree, and Rail and Tree can switch live between each other. Entering Streaming from a structural mode, first enable, and re-enable after a live disable require restarting Pi. Configuration is saved to:
@@ -162,13 +185,13 @@ Useful shortcuts:
 /zentui format clear
 ```
 
-**Thinking (Experimental)** uses one private `AssistantMessageComponent` renderer for Rail, Tree, and Streaming, tested against exact Pi versions 0.80.5, 0.82.1, 0.83.0, 0.84.0, 0.84.4, and 0.85.1. It is disabled by default and may break after Pi updates. Zentui installs an enabled startup mode before transcript restoration. A healthy installed controller lets active Streaming switch live to Rail or Tree, and lets Rail and Tree switch live between each other, without reinstalling its patch. Entering Streaming from Rail or Tree saves the choice but keeps the active structural mode until restart. Disabling live restores native thinking and releases Streaming resources. First enable and re-enable after a live disable are also restart-gated. Mode changes while disabled only preconfigure the next enable. Startup failures, missing constructors, incompatible private child layouts, parser limits, theme/render/width errors, and displaced patch ownership fail open to complete native thinking. If cleanup throws while leaving Streaming, disabling still restores native thinking and a structural selection still becomes active; the successful change warns that Streaming is unavailable for the rest of the session.
+**Thinking (Experimental)** uses one private `AssistantMessageComponent` renderer for Rail, Tree, and Streaming, tested against exact Pi versions 0.85.0 and 0.87.1. It is disabled by default and may break after Pi updates. Zentui installs an enabled startup mode before transcript restoration. A healthy installed controller lets active Streaming switch live to Rail or Tree, and lets Rail and Tree switch live between each other, without reinstalling its patch. Entering Streaming from Rail or Tree saves the choice but keeps the active structural mode until restart. Disabling live restores native thinking and releases Streaming resources. First enable and re-enable after a live disable are also restart-gated. Mode changes while disabled only preconfigure the next enable. Startup failures, missing constructors, incompatible private child layouts, parser limits, theme/render/width errors, and displaced patch ownership fail open to complete native thinking. If cleanup throws while leaving Streaming, disabling still restores native thinking and a structural selection still becomes active; the successful change warns that Streaming is unavailable for the rest of the session.
 
 Rail shows every parsed label in each native contiguous thinking run (`│ Label`, with only the open final phase shown as `│ • Label`). Tree independently shows the latest five labels in each run (`├─ · Label`, settled `└─ · Label`, open `└─ • Label`); it never aggregates across intervening text or tool blocks. Rail and Tree follow Pi's thinking visibility. Complete strict SGR styling is stripped before parsing; every other terminal control and unsafe or unstructured content keeps the complete run native. Labels are rendered by fresh host-shaped Pi Markdown instances before cropping, so emphasis, code, links, HTML, LaTeX, custom transforms, and native `thinkingText` styling remain host-controlled. Every label occupies one terminal row: ANSI/OSC/grapheme-aware cropping adds `…` only when needed. Native horizontal padding stays external. Connectors are styled directly with the current theme's `accent` callback on every render, so custom themes control them independently. Hidden native thinking remains hidden and keeps Pi's native hidden label.
 
 Streaming retains Pi's host-rendered final five rows under `Thinking 7.1s`, folds completed reasoning under `Thought` or current-session `Thought for 12.3s`, and owns the configured thinking-toggle binding (Ctrl+T by default) only when started in Streaming. Its input listener and timer are acquired only for an enabled Streaming session start; startup acquisition failure uses native thinking and marks Streaming unavailable. Restored completions cannot recover a duration because Pi does not persist the thinking-end timestamp. Expand/refold and lifecycle tracking are bounded to 256 retained assistant components; evicted entries are first restored natively. All modes restore/dispose on shutdown. Thinking (Experimental) never writes the Working line and does not change its existing **Thinking time** option, working text, Footer, Editor, statuses, or model behavior.
 
-Pi 0.84 also provides a native fullscreen TUI with a sticky editor and Footer. Pi 0.84.4 is covered by a fullscreen live-transition PTY smoke in addition to the standard matrix. Zentui does not enable fullscreen automatically; select it from Pi's `/settings`, set `"tuiMode": "fullscreen"` in Pi settings, or launch Pi with `--tui-mode fullscreen`.
+Pi 0.84 also provides a native fullscreen TUI with a sticky editor and Footer. Both tested versions are covered by a fullscreen live-transition PTY smoke in addition to the standard matrix. Zentui does not enable fullscreen automatically; select it from Pi's `/settings`, set `"tuiMode": "fullscreen"` in Pi settings, or launch Pi with `--tui-mode fullscreen`.
 
 **Codex quota (opt-in):** Show remaining 5-hour/weekly quota for `openai-codex` through independent Editor and Starship Footer settings, both off by default. See [configuration and private-endpoint limitations](./docs/configuration.md#codex-account-quota), including `$codex_quota` for custom templates.
 
@@ -176,7 +199,7 @@ Minimalist can also show the latest assistant prompt's cache hit rate in its top
 
 ## Requirements
 
-- [Pi](https://pi.dev) coding agent 0.80.5 or newer
+- [Pi](https://pi.dev) coding agent 0.85.0 or newer
 - A [Nerd Font](https://www.nerdfonts.com/) for Nerd icons; Auto falls back to ASCII when no supported terminal signal is present
 
 ## Development

package/docs/configuration.md

@@ -2,7 +2,7 @@
 
 [Back to README](../README.md) · [Footer format template](./footer-format.md)
 
-Zentui reads optional user configuration from `~/.pi/agent/zentui.json`. Missing or invalid known values fall back to defaults. Unknown fields are ignored at runtime but preserved on disk by component save operations where they are user-owned migration or future-style data.
+Zentui reads optional user configuration from `~/.pi/agent/zentui.json` in Pi, or `~/.omp/agent/zentui.json` in Oh My Pi. The active host/profile agent-directory override is respected. Missing or invalid known values fall back to defaults. Unknown fields are ignored at runtime but preserved on disk by component save operations where they are user-owned migration or future-style data.
 
 ## Refresh and cache freshness
 
@@ -201,11 +201,11 @@ Reference only—not a starter file. Prefer the minimal overrides above. Optiona
       "viewportIndicators": true,
       "styles": {
         "opencode": {
-          "metadataFormat": "$model  $provider(  $thinking)(  $codex_quota)",
+          "metadataFormat": "$model  $provider(  $thinking)(  $fast_mode)(  $codex_quota)",
           "completionMenu": "palette"
         },
         "opencode-copy-friendly": {
-          "metadataFormat": "$model  $provider(  $thinking)(  $codex_quota)",
+          "metadataFormat": "$model  $provider(  $thinking)(  $fast_mode)(  $codex_quota)",
           "completionMenu": "palette"
         },
         "accent-rail": {
@@ -422,7 +422,7 @@ Reference only—not a starter file. Prefer the minimal overrides above. Optiona
 - Editor `modelLabel` uses `id` by default; `name` uses the display name with ID fallback. Footer has an independent `modelLabel` control.
 - `components.userMessages` owns User-message enablement, `framed | framed-copy-friendly | compact | labeled` style selection, and color source. Disabling it delegates byte-for-byte to Pi's native renderer.
 - `components.thinkingSteps` independently owns opt-in **Thinking (Experimental)** display. It defaults to `{ "enabled": false, "mode": "tree" }`; canonical modes are `rail | tree | streaming`. The former persisted `streaming-experimental` value is accepted only as a migration alias and is normalized to `streaming` on save.
-- All three modes decorate Pi's private host renderer and are tested on exact Pi versions 0.80.5, 0.82.1, 0.83.0, 0.84.0, 0.84.4, and 0.85.1. Active Streaming can switch live to Rail or Tree, and Rail and Tree can switch live between each other. Entering Streaming from a structural mode, first enable, and re-enable after live disable require restart; live disable restores native thinking. Disabled mode changes only preconfigure.
+- All three modes decorate Pi's private host renderer and are tested on exact Pi versions 0.85.0 and 0.87.1. Active Streaming can switch live to Rail or Tree, and Rail and Tree can switch live between each other. Entering Streaming from a structural mode, first enable, and re-enable after live disable require restart; live disable restores native thinking. Disabled mode changes only preconfigure.
 - `components.workingLine.enabled` is the sole Working-line ownership switch. Thinking (Experimental) never enables, configures, or owns the Working line and leaves the existing **Thinking time** option unchanged.
 - `components.workingLine.placement` (`above | border`) selects the default floating row or the Minimalist/Opencode top border. Accent Rail supports only Above. Disabled, native, unavailable, or unsafe/narrow editors and Pi versions without working-row visibility control fall back to Above without changing saved choices. Legacy `input` normalizes to `above`; the prompt remains available for typing.
 - `components.selectorBorders` owns selector-border enablement, fixed `zentui` style, and color source. Disable it for native Pi behavior.
@@ -456,7 +456,7 @@ This example enables only Editor quota, without changing any component's style o
 
 **Custom templates remain authoritative.** Saved nonempty formats, including copies of old defaults, are never rewritten or augmented outside the template. Add `(  $codex_quota)` to either Opencode variant's `metadataFormat`, `($sep$codex_quota)` to a Footer wide `format`, or `$wrap_sep($codex_quota)` to `compactFormat`. Tokens remain empty when the corresponding quota toggle is off or the provider is ineligible. Unlike ordinary Footer `segments` flags, quota consent cannot be bypassed by a template.
 
-**Compatibility and privacy:** Zentui uses Pi's public active-model metadata, `modelRegistry.getProvider("openai-codex")`, and `getProviderAuth("openai-codex")`, available on tested Pi 0.84.0 and 0.85.1. Hosts without safe model/provider routing metadata do not collect or display quota; unavailable auth shows placeholders. There is no fallback to private storage or older credential APIs; the overall Pi minimum is unchanged. Auth is sent only to `https://chatgpt.com/backend-api/wham/usage`, with redirects rejected. JWT decoding is limited to the account-routing claim and is not identity verification. An opaque credential change invalidates cached data conservatively.
+**Compatibility and privacy:** Zentui uses Pi's public active-model metadata, `modelRegistry.getProvider("openai-codex")`, and `getProviderAuth("openai-codex")`, available on supported Pi 0.85.0 and 0.87.1. Hosts without safe model/provider routing metadata do not collect or display quota; unavailable auth shows placeholders. There is no fallback to private storage or older credential APIs; the Pi minimum is 0.85.0. Auth is sent only to `https://chatgpt.com/backend-api/wham/usage`, with redirects rejected. JWT decoding is limited to the account-routing claim and is not identity verification. An opaque credential change invalidates cached data conservatively.
 
 The endpoint is undocumented and may change or reject some plans. Its path and seconds-based window field are corroborated by [OpenAI's Codex client](https://github.com/openai/codex/blob/rust-v0.98.0/codex-rs/backend-client/src/client.rs); this is not a public API guarantee. Automated verification uses synthetic responses, not a live account. No reset times, countdowns, alerts, or quota history are provided.
 
@@ -524,11 +524,7 @@ Set `components.editor.style` to `accent-rail` or select **Accent Rail** in `/ze
 
 Known autocomplete rows retain Pi's native text, descriptions, and scrolling on the same full-width surface. The selected native `→` becomes the configured rail without replacing Pi's selected-text color. Ambiguous third-party editor layouts fail open using already-rendered native rows.
 
-In fullscreen Pi 0.84.x, Zentui applies a private, shape-checked layout workaround only to the active owned one-row Accent Rail editor. Pi's dock currently reserves a three-row minimum for its bordered native editor; the workaround preserves that minimum but positions a one-row rail as `[blank, rail]`, leaving Pi's final padding row before the independent Footer. Other editor styles, regular mode, multiline input, viewport indicators, and autocomplete fail open unchanged. Unsupported Pi versions or changed internal shapes skip the workaround. Remove this compatibility path when [upstream Pi's fullscreen dock](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/src/modes/interactive/interactive-mode.ts) exposes composer minimum-size control or no longer hard-codes a three-row editor minimum. This link identifies the upstream source seam; it does not imply an upstream issue exists.
-
-Set `ZENTUI_DEBUG=1` when launching Pi to log the workaround diagnostic without adding normal UI noise. Maintainers can probe an explicitly installed compatible host with `ZENTUI_TEST_GLOBAL_PI=/path/to/pi npx vitest run test/accent-rail-layout-patch.test.ts -t "explicitly selected"`.
-
-`transparent` defaults to `false`. Set it to `true` or select **Transparent** in `/zentui` to remove only Zentui-owned input and autocomplete backgrounds while preserving geometry, rail/text colors, and native autocomplete backgrounds. The rail and gap are rendered decoration, not underlying prompt text; terminal drag or rectangular selection can still include them.
+`transparent` defaults to `false`. In `/zentui editor`, select **Editor style → Accent Rail**, then **Editor background → transparent** directly below it. Choose **filled** to restore Zentui's background. The control changes only `components.editor.styles.accent-rail.transparent`, removing Zentui-owned input and autocomplete backgrounds while preserving geometry, rail/text colors, and native selection backgrounds. It is also available as a saved preference while Editor is disabled. The rail and gap are rendered decoration, not underlying prompt text; terminal drag or rectangular selection can still include them.
 
 ### Minimalist
 
@@ -538,6 +534,132 @@ Path examples are `src` (`compact`), `zentui/src` (`project`), and `~/Projects/z
 
 Autocomplete stays inside the frame when Pi output can be split safely. Unknown third-party layouts fail open. Footer visibility remains independently controlled by `components.footer.style`; Minimalist does not remove Pi's header.
 
+### Minimalist metadata templates and custom values
+
+Minimalist has six independently configurable border slots under
+`components.editor.styles.minimalist.formats`: `topLeft`, `topMiddle`,
+`topRight`, `bottomLeft`, `bottomMiddle`, and `bottomRight`. Missing slots keep
+Zentui's generated layout; an empty string hides that slot's configurable
+metadata. No extra rows are added. Use **Editor → Metadata templates** in
+`/zentui` to edit a slot or **Reset / inherit** to delete its override.
+
+Templates use the existing `$variable`, `${variable}`, literal text, and
+conditional `( ... )` grammar. Layout is selected by the six slot names, not
+`$fill`. Viewport counts, Bash mode, and an embedded Working line remain
+operational indicators outside the templates. Explicit templates may show
+metadata whose ordinary visibility toggle is off, but can never bypass Editor
+Codex quota consent. Nothing is appended outside an explicit template.
+
+Custom values are published by other extensions. Give them simple local names
+with `variables`, then reference those names in any slot:
+
+```json
+{
+  "components": {
+    "editor": {
+      "style": "minimalist",
+      "styles": {
+        "minimalist": {
+          "variables": { "claude_quota": "@scope/usage:quota" },
+          "formats": {
+            "topMiddle": "$claude_quota",
+            "bottomMiddle": "$session_name"
+          },
+          "extensionColorMode": "original"
+        }
+      }
+    }
+  }
+}
+```
+
+**Editor → Custom variable aliases** edits the name-to-publisher-key JSON or
+resets the aliases. Names use letters, digits, and underscores, start with a
+letter or underscore, and cannot replace built-in/structural variables or
+prototype names. At most 16 aliases are accepted; keys are nonempty, at most
+64 UTF-16 code units, and contain no whitespace or terminal controls. Reset
+removes only the edited overrides. Unrelated owners/styles and unknown raw
+configuration remain untouched. These settings never enable Footer or Working
+line.
+
+Built-ins are `$model`, `$model_id`, `$model_name`, `$provider`, `$thinking`,
+`$fast_mode`, `$session_name`, `$turn_duration`, `$cost`, `$context`, `$cache_hit`,
+`$codex_quota`, `$cwd`, `$git_branch`, `$git_status`, `$tokens`, `$input_tokens`,
+and `$output_tokens`. `$turn_duration` is current/completed interaction time,
+not total session duration. Existing path, context, separator and color
+preferences still apply. `$sep` (alias `$separator`) uses the configured
+Minimalist dash/dot separator. Prefer optional groups such as
+`$model($sep$thinking)` to avoid separators around empty values.
+
+OMP additionally supports the [host template data](#omp-template-data) built-ins
+in all six slots and both Opencode metadata formats. These are separate from
+publisher aliases and are not included in `$extensions`.
+
+`$extensions` aggregates published custom values in deterministic key order.
+The generated top-right layout includes it after cost; setting an explicit
+slot lets you move or omit it. Values referenced through an alias anywhere in
+the six effective templates are excluded from the aggregate, avoiding an
+automatic duplicate. This is distinct from Footer's existing extension-status
+integration. Custom values do not automatically consume `ctx.ui.setStatus()`.
+
+Centers are terminal-centered and clamped between side labels; they disappear
+whole when they cannot fit. Custom values yield whole before built-in side
+metadata at narrow widths, rather than clipping quotas or activity labels.
+Large aggregates yield as one unit. Literal separators are template-owned;
+use conditional groups around optional values. Width cannot guarantee that
+all configured metadata is visible.
+
+**Custom value colors** offers Original (default) and Zentui. Original retains
+safe SGR and HTTP(S) links from the publisher, with closing resets so styles
+cannot leak into borders. Zentui strips publisher styling and applies the
+Editor color source and extension-status fallback style. Newlines and other
+terminal controls are sanitized; no publisher callbacks or commands run while
+rendering.
+
+#### Custom-value publisher protocol v1
+
+The versioned event-bus protocol publishes data, not a location. Probe before
+each refresh and keep the extension's normal fallback when inactive:
+
+```typescript
+const key = "@scope/usage:quota";
+const capability = { supported: false, active: false, key };
+pi.events.emit("zentui:variable-capability", capability);
+
+if (capability.active) {
+  pi.events.emit("zentui:variable", { key, text: "CC $459/1200" });
+  ctx.ui.setStatus(key, undefined); // remove this publisher's own fallback
+} else {
+  ctx.ui.setStatus(key, "CC $459/1200");
+}
+
+// Remove a value on publisher shutdown or when no longer applicable.
+pi.events.emit("zentui:variable", { key, text: undefined });
+```
+
+Zentui adds `version: 1` and `supported: true` to a mutable probe. Optional
+`key` tests demand for that particular publication; without it, `active`
+reports whether any custom value is demanded. Active requires the current TUI
+session and either an owned, enabled, safely decorated Minimalist/Opencode
+editor with a referencing alias or aggregate, or an owned Starship Footer with
+a referencing alias in its wide or responsive compact template. Availability
+is the union of independently owned consumers: disabling Editor never drops a
+value still demanded by Footer. It is not a guarantee of visibility at the
+current width. Startup probes may precede the first safe
+editor render: probe again on the publisher's next refresh. This protocol
+adds no Zentui poller and no capability-change notification.
+
+Use stable package-qualified keys. The namespace is global by convention;
+collisions are last-update-wins, and either publisher can remove a shared key.
+At most 16 unique values are retained, with keys up to 64 and raw text up to
+256 UTF-16 code units. Malformed/over-limit updates are ignored; existing
+keys can still update at capacity. Empty text also removes. Positive updates
+while inactive are ignored. Session replacement, shutdown, disable, loss of
+ownership, or loss of template demand drops inactive values; publishers must
+republish after reactivation. Publishers own their refresh resources, data
+freshness, and stale markers. Zentui neither fetches account data nor persists
+these values. Working-line protocol v1 remains unchanged.
+
 ### Opencode completion menu
 
 Both Opencode variants default to `completionMenu: "palette"` and can be configured independently. The transparent palette keeps captured native rows and embedded backgrounds, removes only a recognized selected `→` while preserving native emphasis, omits a narrowly recognized trailing count row such as `(1/47)`, fills available width without adding a background, and adds a bottom separator plus `↑↓ Navigate   Enter Use   Esc Close`.
@@ -584,6 +706,7 @@ The configured right zone and Pi's operational right status are right-aligned to
 | `$model_name` | display name; empty when unset |
 | `$provider` | formatted provider label |
 | `$thinking` | current level; empty when `off` |
+| `$fast_mode` | OMP's supported `fast` or `ultrafast` selection; empty when off, unsupported, or running Pi |
 | `$session_name` | current Pi session name; empty when unnamed |
 | `$context` | compact current context usage and window, for example `26.8%/272k` |
 | `$tokens` | cumulative session input/output tokens only, for example `↑76k ↓1.6k` |
@@ -592,9 +715,51 @@ The configured right zone and Pi's operational right status are right-aligned to
 
 `$context` uses Pi's current context snapshot and the live assistant context override, refreshing on the existing 250 ms streaming render cadence. `$tokens` and `$cache_hit` use authoritative persisted session snapshots, so they update at normal session synchronization boundaries rather than estimating in-progress totals. These variables are independent of Footer visibility, style, color source, and configuration.
 
+### Custom values in Opencode metadata
+
+Both Opencode styles can reference the same event-bus values used by Minimalist.
+Each style has independent `variables` and `extensionColorMode` settings:
+
+```json
+{
+  "components": {
+    "editor": {
+      "styles": {
+        "opencode": {
+          "variables": { "quota": "@scope/usage:quota" },
+          "metadataFormat": "$model( · $quota)$fill($session_name)",
+          "extensionColorMode": "original"
+        },
+        "opencode-copy-friendly": {
+          "variables": { "quota": "@scope/usage:quota" },
+          "metadataFormat": "$model$fill($quota)"
+        }
+      }
+    }
+  }
+}
+```
+
+Aliases and these formats are JSON-only for Opencode; Minimalist's settings
+controls still edit only Minimalist. Missing color mode means Original; Zentui
+uses Editor's color source and the historical extension-status fallback style.
+Custom values yield whole before built-in metadata when the row cannot fit.
+No value is automatically appended to an explicit format. Enabling/disabling
+Editor or changing a format never changes Footer choices.
+
+Starship independently supports aliases under
+`components.footer.styles.starship.variables` and Original/Zentui under
+`extensionColorMode`; both wide `format` and responsive `compactFormat` can
+reference them. See [custom Footer values](./footer-format.md#custom-extension-values).
+Native/Hidden Footer and existing `setStatus` placement/color choices are
+unchanged. Footer's compact `$extensions` continues to mean Pi's keyed extension
+statuses, not this new variable registry. Removing an alias/format reference
+releases only that consumer's demand; values survive while any other owned
+consumer still references them.
+
 Model variables use Editor `colors.model` (legacy `editorModel`), provider uses `colors.provider` (legacy `editorProvider`), and thinking uses the matching Editor level style. Literal text, session name, and usage metadata use the neutral editor-border theme style. ANSI/VT sequences, controls, and line-breaking whitespace are sanitized without collapsing ordinary spaces.
 
-Missing, non-string, or empty values use `$model  $provider(  $thinking)(  $codex_quota)`, with identical spacing while quota is off. A non-empty format that resolves to no metadata preserves the normal blank spacer and metadata rows. This option is JSON-only; `/zentui format` controls the Footer.
+Missing, non-string, or empty values use `$model  $provider(  $thinking)(  $fast_mode)(  $codex_quota)`, with identical Pi spacing while the optional values are empty. OMP's current per-family service tier is checked against the active model's capabilities each render, so `/fast` and model changes do not leave stale indicators. Saved nonempty templates are not rewritten; add `( · $fast_mode)` explicitly to opt in. A non-empty format that resolves to no metadata preserves the normal blank spacer and metadata rows. This option is JSON-only; `/zentui format` controls the Footer.
 
 ## User-message styles
 
@@ -624,7 +789,7 @@ Only an actually open thinking phase uses `•`; a text/tool transition or resto
 
 Streaming keeps the reviewed host-rendered behavior: while open it shows the latest five rendered terminal rows beneath `Thinking 7.1s`; completion folds under `Thought` or current-session `Thought for Ns`. Restored entries have no duration because Pi does not persist a reliable thinking-end timestamp. Only a session started in active Streaming owns its validated configured `app.thinking.toggle` binding and one-second timer. Ctrl+T expands/refolds native reasoning. Startup resource failures and private-shape/render failures use complete native thinking. A cleanup callback that throws while leaving Streaming is contained: Rail or Tree remains active, while Streaming becomes unavailable for that session. Component and timing tracking are bounded to 256; evicted entries are restored natively first.
 
-The exact all-mode private matrix covers Pi 0.80.5, 0.82.1, 0.83.0, 0.84.0, 0.84.4, and 0.85.1 under dark, light, and current themes, narrow/wide widths and resize; Pi 0.84.4 also has a fullscreen live-transition PTY smoke. Thinking (Experimental) never owns or writes the Working line, including its unchanged **Thinking time** option, and does not own Footer, Editor, widgets, statuses, or model behavior.
+The exact all-mode private matrix covers Pi 0.85.0 and 0.87.1 under dark, light, and current themes, narrow/wide widths and resize; both versions also have fullscreen live-transition PTY coverage. Thinking (Experimental) never owns or writes the Working line, including its unchanged **Thinking time** option, and does not own Footer, Editor, widgets, statuses, or model behavior.
 
 ## Working line
 
@@ -645,7 +810,9 @@ Classic and KITT move color across message and segments. **Animate spinner color
 
 Both speeds accept `30..1000` ms. Classic/KITT combine both cadences through one Pi Loader interval; exact cycles are used within 1024-frame/512-KiB limits. Pathological custom pairs use a bounded evenly distributed schedule with at most half a spinner-cycle and half a text-step rounding. Legacy `intervalMs` is accepted only as migration input for `spinnerIntervalMs` when the canonical field is absent.
 
-Content reserves the complete Tokens label and active extension segments first, then Message, Thought, Elapsed, and Tool allocation, while preserving visual order **Message · Tool · Elapsed · Thought · Tokens · Extensions** within the 80-column Loader-row contract. Active thought starts as `thinking 0s`; completed positive thought becomes `thought for Ns`. Rebuilds preserve spinner and visible color phase. Pi's working-row APIs are global and unkeyed, so another extension may win by writing last.
+Content reserves the complete Tokens label and active extension segments first, then Message, Thought, Elapsed, and Tool allocation, while preserving visual order **Message · Tool · Elapsed · Thought · Tokens · Extensions** within the 80-column Loader-row contract. Active thought starts as `thinking 0s`; completed positive thought becomes `thought for Ns`. Rebuilds preserve spinner and visible color phase.
+
+Pi's working-row APIs are global and unkeyed. While owning the row, Zentui reasserts its blank message on owned refreshes/reconciles (even with unchanged frames) and before a Border fallback reveals the Above row. A later external message write or reset can still win until the next such boundary; native spinner ticks alone do not repair it, and there is no added polling. Separate multiline widgets are unaffected; extensions sharing the working-message slot should use keyed segments below instead.
 
 ### Working-line extension integration
 
@@ -774,7 +941,100 @@ Pi 0.84 adds a native fullscreen TUI with sticky Editor and Footer plus an indep
 }
 ```
 
-Save this in Pi's `~/.pi/agent/settings.json`, select fullscreen in Pi's `/settings`, or use `--tui-mode fullscreen`. Zentui does not enable it automatically. Pi owns layout and scrolling while Zentui supplies configured components. Pi 0.80.5–0.83 remain supported for styling without native sticky placement.
+Save this in Pi's `~/.pi/agent/settings.json`, select fullscreen in Pi's `/settings`, or use `--tui-mode fullscreen`. Zentui does not enable it automatically. Pi owns layout and scrolling while Zentui supplies configured components. Zentui requires Pi 0.85.0 or newer.
+
+## Oh My Pi compatibility
+
+OMP 18.4.10+ uses `omp.ts` as a deliberately focused skin for **Editor, User messages, and Statusline only**. `/zentui` defaults to Editor and cycles through those three sections; `/zentui statusline` opens the canonical Footer owner. Footer-local Segments/Git controls and three-owner presets remain available. Working, thinking, selectors, turn summaries, and all-owner migration remain OMP-owned; their saved values are ignored by the focused runtime without being rewritten. Pi's full component set is unchanged.
+
+`npm run omp:dev` launches with only this extension; `npm run omp:install-local` links the checkout with `omp plugin link`. OMP remaps shared Pi package imports to its own host modules, avoiding duplicate runtime classes/theme state.
+
+| Surface | OMP behavior |
+| --- | --- |
+| Editor | All Zentui styles support OMP's built-in Box, Band, Claude, Pi, Borderless, Rule, Field, and Rail layouts, preserving multiline input, cursor markers, shell submission, and autocomplete. Public composer row capture leaves native input layout/preferences unchanged. Unknown/ambiguous chrome fails open; decorated mouse geometry is not guessed. |
+| Fast mode | `$fast_mode` is `fast` for supported priority service and `ultrafast` for supported OpenAI ultrafast service. Other families' preferences, off/default/flex tiers, and unsupported models render empty. This reports the selected supported tier, not a latency guarantee. |
+| User messages | Normal Markdown messages support Zentui styles. Native image, badge, synthetic, and unfamiliar message surfaces remain native. |
+| Statusline | Starship replaces the native lower status slot and suppresses native attached status content; there is no persistent footer widget or duplicate main line. Hidden suppresses main status content and retains only permitted extension statuses; Native delegates exact native behavior. Editor enablement is independent. |
+
+OMP's `setFooter()` is inert, so the adapter decorates exported native status renderers and restores only its own methods. Scope is established by matching session identity and mounted public `editor.composerFacts` identity. Verified ownership survives temporary dialog unmounting, but editor replacement, detached containers, session changes, and foreign method displacement release it; native startup/preview and other sessions remain untouched. The guarded runtime `session` field is the private compatibility boundary—changed/uninspectable shapes fail open to native. Native preferences/status maps are not rewritten. Extension statuses are recorded from successful public publications starting at extension initialization, including earlier `session_start` handlers; publications predating observation cannot be recovered. In TSP terminals, custom status is plain semantic composer text rather than ANSI frame/color parity; host-owned model-picker action/icon chrome remains native.
+
+OMP has no public editor-factory getter. Zentui observes public setter descriptors across handler scopes and preserves expanded drafts for its observed editors. Initial replacement is OMP's normal last-writer-wins behavior: an opaque pre-existing editor factory cannot be recovered or wrapped. Once a later setter is observed, cleanup restores only Zentui-owned state. Handler-local dialog cancellation remains scoped to the invoking command.
+
+### OMP template data
+
+The following explicit Zentui names are available in Opencode/copy-friendly
+`metadataFormat`, all Minimalist slots, and Starship `format`/`compactFormat`.
+OMP segment IDs are not automatically template variables. These names are
+reserved built-ins, not custom publisher aliases; `$extensions` is unchanged.
+Pi and unavailable OMP capabilities render these host values empty.
+
+| Variable | Data and distinctions |
+| --- | --- |
+| `$session_id` | Current session's full ID, not its human-readable `$session_name`. |
+| `$pr_number`, `$pr_url` | Current non-default branch's GitHub PR number and safe plain HTTPS URL. |
+| `$subagent_count` | Native active subagent badge count; background Bash/Eval jobs are not subagents. A known zero renders `0`. |
+| `$token_rate` | Output tokens/second, for example `42.5 tok/s`. Uses OMP's last-assistant average; observed live Vibe workers add the current streaming main rate, not an idle previous reply. Unknown timings remain empty. |
+| `$active_time` | Native accumulated active-processing time, including the open interval and excluding idle time, for example `1m 5s`. Not wall-clock `$session_duration` or current/completed `$turn_duration`; a known zero renders `0s`. |
+| `$hostname` | Machine hostname without the username. |
+| `$usage_quota` | Proven current-provider/model/account quota windows, for example `5 Hour: 80% left`. Distinct from independently consented `$codex_quota`. |
+| `$collaboration` | Native role and participant count, for example `host · 3 participants`; participants include the host. |
+| `$stream_state` | Native publisher state and remote viewer count. `live · 0 viewers` is active; no publisher renders empty. |
+| `$vim_mode` | Current native editor `insert`, `normal`, `visual`, or `visual-line` state. Disabled Vim renders empty. |
+| `$plan_mode`, `$goal_mode` | `Plan`/`Goal`, or `Plan paused`/`Goal paused` when the native paused state is known. |
+| `$prewalk_mode` | `Prewalk` while the attached session has a Prewalk target. |
+| `$vibe_mode` | `Vibe` while enabled. |
+| `$loop_mode` | `Loop waiting`, `Loop running`, or `Loop paused`; no loop renders empty. |
+
+Defaults and saved templates are never augmented. Add only the desired variables,
+with optional groups around labels:
+
+```json
+{
+  "components": {
+    "editor": {
+      "styles": {
+        "opencode": {
+          "metadataFormat": "$model( · $session_id)( · PR #$pr_number)( · $subagent_count agents)( · $active_time)( · $token_rate)( · $vim_mode)"
+        }
+      }
+    },
+    "footer": {
+      "styles": {
+        "starship": {
+          "format": "$cwd( · PR #$pr_number)( · $plan_mode)( · $goal_mode)( · $loop_mode)$fill$context",
+          "compactFormat": "$cwd$wrap(PR #$pr_number)$wrap($active_time)$wrap($token_rate)"
+        }
+      }
+    }
+  }
+}
+```
+
+PR data requires a matching GitHub remote, `gh`, and read access. Read-only lookups
+capture and recheck repository/branch identity, cache for up to 30 seconds, and
+invalidate on native project/branch changes. No PR, default/detached branches,
+unavailable tooling, or lookup failure renders empty rather than a placeholder.
+
+**`$usage_quota` is opt-in by explicit template reference.** It uses the current
+native session's public usage-report API and declared public account-routing
+capability, never credentials/keys or private native quota caches. OMP may refresh
+authenticated reports from its configured providers on a cache miss. Successful
+snapshots are cached for up to five minutes, shortened by window resets; there
+is no additional polling timer or default request. Missing identity, ambiguous
+accounts, mismatched provider/model scopes, failures, and expired windows omit
+the affected data. A real zero remaining quota stays visible. The Editor and
+Footer's `$codex_quota` toggles remain separate and are not changed.
+
+Session ID/hostname use public context/OS data. Other fields require a verified
+native component/session/editor association even when Footer is Native or Hidden.
+Current public Vim/session getters take precedence where supported; native
+Plan/Goal/Vibe pause flags, Loop, collaboration, stream state, and worker-rate
+callbacks are observed only after successful public publications. Publications
+predating observation cannot be recovered from private fields. Plan/Goal/Vibe
+snapshots reset with session identity; native UI-global states stay local to
+their component across focus changes. Locked or displaced setters disable
+observation, and disposal restores only still-owned descriptors. All rendered
+text follows the consuming component's sanitization and local colors.
 
 ## Compatibility and migration
 

package/docs/footer-format.md

@@ -53,6 +53,9 @@ Show model, provider, and active thinking level in the Footer:
 
 Add `$model $provider( $thinkingLevel)` to `components.footer.styles.starship.compactFormat` separately to keep these details in compact layouts. Defaults and the built-in Model info segment are unchanged.
 
+In OMP, include the independent fast-mode token with `/zentui format "$model $provider( $thinkingLevel)( · $fast_mode)"`. Add it to `compactFormat` separately if needed. `$fast_mode` uses the active model's service-tier family and OMP's model capability checks, not another provider family's saved priority preference.
+
+
 To keep metadata on the right, set both templates independently:
 
 ```json
@@ -93,6 +96,7 @@ The released flat `footerFormat` and `footerSegments` keys remain accepted only
 | `$model` | | selected Footer model label |
 | `$provider` | | formatted provider label |
 | `$thinkingLevel` | | current thinking level; empty when unavailable or `off` |
+| `$fast_mode` | | OMP's supported `fast` or `ultrafast` selection; empty when off, unsupported, or running Pi |
 | `$package` | | project package version as `is <glyph> <version>` |
 | `$package_version` | | raw project package version |
 | `$session_duration` | `$duration` | session running time |
@@ -112,6 +116,36 @@ The released flat `footerFormat` and `footerSegments` keys remain accepted only
 
 Each variable renders its core value without prose prefixes such as `on` or `via`; add those words as literals.
 
+### OMP host data
+
+OMP also supplies `$session_id`, `$pr_number`, `$pr_url`, `$subagent_count`,
+`$token_rate`, `$active_time`, `$hostname`, `$usage_quota`, `$collaboration`,
+`$stream_state`, `$vim_mode`, `$plan_mode`, `$prewalk_mode`, `$goal_mode`,
+`$vibe_mode`, and `$loop_mode`. These explicit built-ins also work in Opencode
+metadata and Minimalist slots; they are not aliases for OMP's segment IDs or
+third-party `$extensions`. Pi and unsupported/inactive capabilities render empty.
+See the [data/source reference](./configuration.md#omp-template-data).
+
+For example:
+
+```json
+{
+  "format": "$cwd( · PR #$pr_number)( · $plan_mode)( · $loop_mode)$fill$context( · $active_time)( · $token_rate)",
+  "compactFormat": "$cwd$wrap(PR #$pr_number)$wrap($active_time)$wrap($token_rate)"
+}
+```
+
+Keep `$session_id` separate from the session name and `$active_time` separate
+from wall-clock `$session_duration`. Optional groups hide unavailable fields,
+including missing PR/rate/quotas, without leaving their labels behind.
+`$pr_url` is safe plain HTTPS text, not an injected terminal hyperlink.
+
+Referencing `$usage_quota` explicitly opts into OMP's public usage-report API,
+which may refresh authenticated reports from configured providers. Snapshots
+are demand-driven and cached for up to five minutes, subject to window resets
+and current provider/model/account scope. Defaults make no new requests; this
+does not enable or configure the independent `$codex_quota` consent toggle.
+
 ### `$codex_quota` consent and freshness
 
 Set `components.footer.codexQuota: true` and select Starship to opt in. The built-in wide layout and shipped compact default include quota conditionally. Saved custom formats are unchanged; add `($sep$codex_quota)` to `format` and `$wrap_sep($codex_quota)` to `compactFormat` where desired. Templates without the token never have quota appended outside them.
@@ -158,6 +192,57 @@ Example:
 
 These tokens are structural in compact mode: `$wrap` and `$wrap_sep` render no text themselves, and `$extensions` is empty when no third-party status is active.
 
+## Custom extension values
+
+Publishers can provide named text through `zentui:variable` protocol v1, without
+owning or wrapping Footer. Map stable publisher keys to simple local names under
+`components.footer.styles.starship.variables`, then reference the names in either
+template:
+
+```json
+{
+  "components": {
+    "footer": {
+      "styles": {
+        "starship": {
+          "variables": { "quota": "@scope/usage:quota" },
+          "extensionColorMode": "original",
+          "format": "$cwd$fill($quota)($sep$cost)",
+          "compactFormat": "$cwd$fill($quota)$wrap_sep$tokens"
+        }
+      }
+    }
+  }
+}
+```
+
+These JSON-only aliases cannot replace built-in variables, aliases such as
+`branch`, structural tokens, or prototype names. Missing values are empty;
+conditional groups remove associated optional text. No custom value is appended
+outside an explicit template. A compact-only reference creates demand only
+while responsive mode is enabled. Native and Hidden never acquire this registry
+on behalf of Footer, and configuring aliases does not select Starship or enable
+Editor.
+
+Original is the default color mode and preserves permitted publisher SGR and
+HTTP(S) hyperlinks. Zentui strips incoming styling and uses Footer's own
+`colors.extensionStatus` role and color source. These choices are independent of
+Editor and of the existing `extensionStatuses.colorModes` preferences.
+
+Values are kept whole through wide alignment, reflow, and compact packing.
+When a value would be partially cropped or split, Footer recomposes without it
+instead of showing misleading partial quotas or labels. Width fitting uses safe
+internal probes that are restored before terminal output. Built-in narrow-width
+behavior remains unchanged, and template literals still own their spacing.
+
+The compact `$extensions` token above its existing configuration section
+continues to expand `ctx.ui.setStatus()` statuses; it is **not** an aggregate of
+new custom values. A publisher can use `setStatus()` as its own fallback when
+capability is inactive, and must remove only its own fallback when active to
+avoid duplicate output. See [publisher protocol](./configuration.md#custom-value-publisher-protocol-v1)
+for capability, bounds, session lifecycle, and ownership rules. Disabling one
+surface does not evict a value still consumed by another owned surface.
+
 ## `$fill` behavior
 
 In the wide template:

package/extensions/zentui/codex-quota.ts

@@ -3,6 +3,7 @@ import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 import type { ZentuiConfig } from "./config";
 import { sanitizeEditorMetadataText } from "./editor-metadata-format";
 import { collectFooterFormatReferences, parseFooterFormat } from "./footer-format";
+import { minimalistTemplateReferences } from "./minimalist-template";
 
 const INTERVAL = 60_000;
 const TIMEOUT = 10_000;
@@ -45,8 +46,9 @@ export function parseCodexQuota(value: unknown): CodexQuota | undefined {
 export function editorWantsCodexQuota(config: ZentuiConfig): boolean {
 	const editor = config.components.editor;
 	if (!editor.enabled || !editor.codexQuota) return false;
+	if (editor.style === "minimalist")
+		return minimalistTemplateReferences(editor.styles.minimalist).has("codex_quota");
 	return (
-		editor.style === "minimalist" ||
 		editor.style === "accent-rail" ||
 		collectFooterFormatReferences(
 			parseFooterFormat(sanitizeEditorMetadataText(editor.styles[editor.style].metadataFormat)),