# Zentui A Starship-inspired statusline and Opencode-style TUI for [Pi](https://pi.dev). ## Screenshots ![Zentui](https://raw.githubusercontent.com/lmilojevicc/pi-zentui/main/assets/zentui.png) ## What is this? Zentui brings two popular aesthetics to Pi: - **[Starship](https://starship.rs/) footer** — shows your current directory, git branch, git status indicators, and runtime/version detection in a compact, icon-rich format - **[Opencode](https://github.com/opencode-ai/opencode) editor** — clean bordered input box with accent rail, copy-friendly mode, and model/provider display inside the editor frame ## Features ### Footer (Starship-inspired) - `dirname` — current directory (`basename` by default; optional `full` path with directory depth via `pathDisplay`) - `on branch` — git branch with icon - `[!?↑]` — git status indicators (modified, untracked, ahead/behind, stashed, etc.) - `via v5.5.0` — runtime detection with version and Starship-style Nerd Font runtime/language modules - Optional segments (off by default): selected model/provider, `user@host`, current time, OS icon, session duration, and the **project package version** (e.g. `package.json` → `0.6.0`) — distinct from the runtime segment, which shows the installed toolchain - Right side shows context usage, token counts, and cost - Built-in footer segments can be shown or hidden individually from `/zentui` - Fully custom Starship-style layout via a `footerFormat` template string — see [Footer Format Template](#footer-format-template) - Third-party Pi extension statuses from `ctx.ui.setStatus()` can be shown on the left, middle, or right side, or hidden per status key from `/zentui` ### Editor (Opencode-inspired) - Bordered input box with configurable accent rail and border colors - Model name and provider displayed inside the editor frame - Configurable model, provider, and thinking-level indicator colors - Prompt-box-style user messages matching the ZentUI input chrome - Copy-friendly mode hides editor and previous-message rail glyphs so terminal selection copies less chrome - **Fixed editor** (experimental, opt-in): Pin the editor and footer at the bottom of the terminal while the transcript scrolls above ### Git Status Icons | Icon | Meaning | | ---- | ---------- | | `!` | Modified | | `?` | Untracked | | `+` | Staged | | `✘` | Deleted | | `»` | Renamed | | `=` | Conflicted | | `$` | Stashed | | `↑` | Ahead | | `↓` | Behind | | `⇕` | Diverged | ### Runtime Detection Detects Starship Nerd Font runtime/language modules, uses the Starship Nerd Font symbols, and keeps Starship-style defaults such as `bold green` for Node.js. By default Zentui maps those styles through your active Pi theme; switch the Starship/footer color source to `terminal` in `/zentui` if you want your terminal colorscheme to supply the exact ANSI colors. | Runtime/language | Detection examples | | ---------------- | ------------------------------------------------------------- | | Buf | `buf.yaml`, `buf.gen.yaml`, `buf.work.yaml` | | Bun | `bun.lock`, `bun.lockb` | | C | `.c`, `.h` files | | C++ | `.cpp`, `.cc`, `.cxx`, `.hpp` files | | CMake | `CMakeLists.txt`, `CMakeCache.txt` | | COBOL | `.cbl`, `.cob` files | | Conda | `CONDA_DEFAULT_ENV` environment | | Crystal | `.cr` files, `shard.yml` | | Dart | `.dart` files, `pubspec.yaml`, `.dart_tool/` | | Deno | `deno.json`, `deno.jsonc`, `deno.lock` | | .NET | `.csproj`, `.fsproj`, `global.json`, `Directory.Build.*` | | Elixir | `mix.exs` | | Elm | `.elm` files, `elm.json`, `elm-stuff/` | | Erlang | `rebar.config`, `erlang.mk` | | Fennel | `.fnl` files | | Fortran | `.f`, `.f90`, `.f95`, `.f03`, `.f08`, `.f18`, `fpm.toml` | | Gleam | `.gleam` files, `gleam.toml` | | Go | `go.mod` | | Gradle | `build.gradle`, `build.gradle.kts`, `gradle/` | | Guix shell | `GUIX_ENVIRONMENT` environment | | Haskell | `.hs`, `.cabal`, `stack.yaml`, `cabal.project` | | Haxe | `.hx`, `.hxml`, `haxelib.json`, `.haxerc` | | Helm | `helmfile.yaml`, `Chart.yaml` | | Java | `.java-version` | | Julia | `.jl` files, `Project.toml`, `Manifest.toml` | | Kotlin | `.kt`, `.kts` files | | Lua | `.lua` files, `stylua.toml`, `.luarc.json`, `lua/` dir | | Maven | `pom.xml` | | Meson | `MESON_DEVENV=1` and `MESON_PROJECT_NAME` environment | | Mojo | `.mojo` files | | Nim | `.nim`, `.nims`, `.nimble`, `nim.cfg` | | Nix shell | `IN_NIX_SHELL=pure` or `IN_NIX_SHELL=impure` environment | | Node.js | `package.json`, `.nvmrc`, `.node-version` | | OCaml | `.opam`, `.ml`, `.mli`, `dune`, `_opam/`, `esy.lock/` | | Odin | `.odin` files | | OPA/Rego | `.rego` files | | Perl | `.pl`, `.pm`, `Makefile.PL`, `cpanfile`, `META.*` | | PHP | `composer.json` | | Pixi | `pixi.toml`, `pixi.lock`, `PIXI_ENVIRONMENT_NAME` environment | | Pulumi | `Pulumi.yaml`, `Pulumi.yml` | | PureScript | `.purs` files, `spago.dhall`, `spago.yaml`, `spago.lock` | | Python | `pyproject.toml`, `requirements.txt`, `setup.py`, `Pipfile` | | R | `.R`, `.Rmd`, `.Rproj`, `DESCRIPTION`, `.Rproj.user/` | | Raku | `.raku`, `.rakumod`, `.p6`, `.pm6`, `META6.json` | | Red | `.red`, `.reds` files | | Ruby | `Gemfile`, `.ruby-version` | | Rust | `Cargo.toml` | | Scala | `.scala`, `.sbt`, `build.sbt`, `.metals/` | | Solidity | `.sol` files | | Spack | `SPACK_ENV` environment | | Swift | `.swift` files, `Package.swift` | | Terraform | `.tf`, `.tfplan`, `.tfstate`, `.terraform/` | | Typst | `.typ` files, `template.typ` | | Vagrant | `Vagrantfile` | | V | `.v` files, `v.mod`, `vpkg.json` | | Xmake | `xmake.lua` | | Zig | `.zig` files, `build.zig` | ## Install ```bash # From npm pi install npm:pi-zentui # From git pi install git:github.com/lmilojevicc/pi-zentui ``` ## Config User config lives at `~/.pi/agent/zentui.json`. The file is optional: missing or invalid known values fall back to Zentui defaults, unknown keys are ignored at runtime, and `/zentui` can patch color-source settings, UI feature toggles, built-in footer segment visibility, and active third-party status placements. The interactive `/zentui` menu is split into exactly six sections, in this order. Use `Tab` and `Shift+Tab` to switch sections. Every listed control patches the shown JSON equivalent: 1. **Appearance** — Starship/footer colors (`colorSources.starship`); editor + previous-message colors (`colorSources.editor` and `colorSources.userMessages`); separator (`separator`); icon mode (`icons.mode`). 2. **Editor** — editor enabled (`features.editor`); editor border color mode (`editorBorderColorMode`); editor model label (`editorModelLabel`); copy-friendly mode (`features.copyFriendly`); viewport indicators (`features.viewportIndicators`); fixed editor (`fixedEditor.enabled`); and, while fixed editor is enabled, mouse scroll (`fixedEditor.mouseScroll`) and copy notice (`fixedEditor.copyNotice`). 3. **Footer** — status line enabled (`features.statusLine`); responsive footer (`responsiveFooter`); compact footer rows (`compactFooterMaxLines`); context style (`contextStyle`); path display (`pathDisplay.mode`); path depth (`pathDisplay.depth`). 4. **Segments** — visibility toggles for every non-Git built-in segment under `footerSegments`: `cwd`, `sessionName`, `runtime`, `modelInfo`, `context`, `tokens`, `cost`, `sessionDuration`, `username`, `time`, `os`, and `packageVersion`. 5. **Git** — Git branch visibility (`footerSegments.gitBranch`); branch length (`gitBranch.maxLength`); Git status visibility (`footerSegments.gitStatus`); Git counts visibility (`footerSegments.gitCounts`); Git commit visibility (`footerSegments.gitCommit`); commit-only-detached (`gitCommit.onlyDetached`); exact-match tag (`gitCommit.showTag`); Git metrics visibility (`footerSegments.gitMetrics`); hide zero metrics (`gitMetrics.onlyNonzero`); ignore submodules (`gitMetrics.ignoreSubmodules`). 6. **Extensions** — default placement (`extensionStatuses.defaultPlacement`) first, followed by placement (`extensionStatuses.placements[key]`) and color (`extensionStatuses.colorModes[key]`) controls for currently active status keys. Free-form values such as custom formats, raw colors/styles, numeric values outside the shown presets, and inactive extension keys remain JSON-only. Useful slash-command shortcuts: ```text /zentui editor enable /zentui editor disable /zentui statusline enable /zentui statusline disable /zentui editor toggle /zentui statusline toggle /zentui copy-friendly enable /zentui copy-friendly disable /zentui copy-friendly toggle /zentui viewport-indicators enable /zentui viewport-indicators disable /zentui viewport-indicators toggle /zentui fixed-editor enable /zentui fixed-editor disable /zentui fixed-editor toggle /zentui format "$cwd on branch $git_branch$git_status using $runtime $fill $context" /zentui format clear ``` Default config values — copy this and change any value you want: ```json { "projectRefreshIntervalMs": 30000, "footerFormat": "", "responsiveFooter": true, "compactFooterFormat": "$cwd$wrap(in $session_name)$wrap(on $git_branch) $git_status$wrap$context$wrap_sep$tokens", "compactFooterMaxLines": 2, "editorMetadataFormat": "$model $provider( $thinking)", "separator": "pipe", "contextStyle": "text", "editorModelLabel": "id", "editorBorderColorMode": "static", "contextThresholds": { "warning": 70, "error": 90 }, "pathDisplay": { "mode": "basename", "depth": 0 }, "gitBranch": { "maxLength": "full" }, "icons": { "mode": "auto", "cwd": "", "git": "", "ahead": "↑", "behind": "↓", "diverged": "⇕", "conflicted": "=", "untracked": "?", "stashed": "$", "modified": "!", "staged": "+", "renamed": "»", "deleted": "✘", "typechanged": "T", "cacheHit": "󰆼", "editorPrompt": "", "rail": "│", "username": "", "time": "", "os": "" }, "colors": { "cwd": "bold cyan", "sessionName": "bold green", "gitBranch": "bold purple", "gitStatus": "bold red", "contextNormal": "bright-black", "contextWarning": "bold yellow", "contextError": "bold red", "tokens": "bright-black", "cost": "bold green", "extensionStatus": "bright-black", "separator": "bright-black", "runtimePrefix": "", "sessionDuration": "yellow", "packageVersion": "208", "gitCommit": "bold green", "gitMetricsAdded": "bold green", "gitMetricsDeleted": "bold red", "username": "bold yellow", "time": "bold yellow", "os": "bold white", "editorAccent": "accent", "editorPrompt": "accent", "editorBorder": "borderMuted", "editorModel": "accent", "editorProvider": "text", "editorThinking": "muted", "editorThinkingMinimal": "thinkingMinimal", "editorThinkingLow": "thinkingLow", "editorThinkingMedium": "thinkingMedium", "editorThinkingHigh": "thinkingHigh", "editorThinkingXhigh": "thinkingXhigh" }, "colorSources": { "starship": "theme", "editor": "theme", "userMessages": "theme" }, "features": { "editor": true, "statusLine": true, "copyFriendly": false, "viewportIndicators": true }, "footerSegments": { "cwd": true, "sessionName": true, "gitBranch": true, "gitStatus": true, "gitCounts": false, "runtime": true, "modelInfo": false, "context": true, "tokens": true, "cost": true, "sessionDuration": false, "username": false, "time": false, "os": false, "packageVersion": false, "gitCommit": false, "gitMetrics": false }, "gitCommit": { "hashLength": 7, "onlyDetached": true, "showTag": true }, "gitMetrics": { "onlyNonzero": true, "ignoreSubmodules": false }, "extensionStatuses": { "defaultPlacement": "right", "placements": {}, "colorModes": {} }, "fixedEditor": { "enabled": false, "mouseScroll": true, "copyNotice": true } } ``` - Style values can be Starship/terminal strings (`bold purple`, `fg:202`, `#89b` / `#89b4fa`, `bg:blue fg:bright-green`) or Pi theme tokens (`accent`, `borderMuted`, `thinkingHigh`). Short `#rgb` hex values expand to `#rrggbb`. - `projectRefreshIntervalMs`: project status polling interval; `0` disables polling. Values `1..4999` clamp up to `5000` (minimum 5s); invalid/non-finite values fall back to `30000`. - `contextStyle`: `text` (default), `gauge`, or `text+gauge` for the context segment. Finite context percentages use one decimal place. Context usage refreshes during assistant streaming; token and cost totals remain canonical and finalize at turn boundaries. - `editorModelLabel`: controls the model shown in the editor frame, built-in model-info footer segment, and footer `$model` variable. `id` (default) shows the model id; `name` shows the model's display name (including custom `name` values set in `models.json`), falling back to the id when no name is set. - `editorBorderColorMode`: `static` (default) uses `colors.editorBorder`; `adaptive` follows Pi's current shell-mode and thinking-level editor border color. Cycle it from the `/zentui` **Editor** tab. - `editorMetadataFormat`: JSON-only template for the left side of the editor metadata row. Missing, non-string, or empty values restore the default `$model $provider( $thinking)` layout; non-empty strings, including whitespace-only strings, are preserved. See [Editor Metadata Format](#editor-metadata-format) below. - `separator`: controls the default footer layout and extension-status connectors: `pipe` (default, ` | `), `dot` (` · `), `chevron` (` › `), or `none` (one space). Cycle it from the `/zentui` **Appearance** tab. This selects the separator glyph; `colors.separator` controls its color. Custom `footerFormat` literals and `$sep` keep their existing behavior. - `contextThresholds`: `{ warning, error }` percentages (default `70` / `90`) that select contextNormal / contextWarning / contextError colors. - `pathDisplay`: controls how the cwd/`$cwd` path is shown. `mode` is `basename` (default, last segment only) or `full` (path with home contracted to `~`). In `full` mode, `depth` keeps only the last N trailing directories (`0` = entire path after `~`, max `5`); when parents are dropped the path is prefixed with `…/` (Starship-style). The `/zentui` **Footer** tab cycles path mode and path depth (`0`–`5`; depth is ignored for basename). Example: `~/Projects/foo/bar` with `depth: 2` → `…/foo/bar`. - `gitBranch.maxLength`: visible width of the built-in branch name and `$git_branch` / `$branch`. The default `full` preserves the complete name; any positive integer uses that width including the trailing `…`. `/zentui` **Git** cycles `full`, `10`, `20`, `30`, `40`, and `50`; custom positive integers can be set in JSON. - `icons`: every shown icon key is configurable; omit any key to use the Zentui default. `icons.mode` is `auto` | `nerd` | `ascii` (default `auto`, same glyphs as nerd). ASCII mode swaps in plain fallbacks for statusline icons and runtime symbols — useful without a Nerd Font. Custom per-icon strings always win over mode defaults. Custom `icons.os` always wins; when left at the mode default, Zentui maps the OS icon by platform. `rail` sets the vertical glyph drawn as the left rail of the active editor frame and previous user messages when `copyFriendly` is disabled (default `│`; any single Unicode vertical or block glyph). `editorPrompt` controls an optional copy-friendly editor prompt glyph; the default is `""` so copy-friendly mode stays rail-free. - `colorSources`: `theme` maps styles through Pi theme tokens; `terminal` emits terminal colors. `/zentui` switches these sources; manual JSON controls specific style values. - `features`: `editor` enables Zentui's custom editor, selector borders, and previous-message chrome. `statusLine` enables Zentui's custom footer/status line. `copyFriendly` hides editor and previous-message rail glyphs so native terminal selection copies less chrome. `viewportIndicators` preserves Pi's native `↑ N more` / `↓ N more` wrapped-row counts in Zentui's editor borders (default `true`). All four can be changed from `/zentui` or direct slash-command arguments. - `footerSegments`: show or hide individual built-in footer segments (`cwd`, `sessionName`, `gitBranch`, `gitStatus`, `gitCounts`, `gitCommit`, `gitMetrics`, `runtime`, `modelInfo`, `packageVersion`, `sessionDuration`, `username`, `time`, `os`, `context`, `tokens`, `cost`). `modelInfo` is off by default and shows the selected model plus the provider unless the model label already contains it. Toggle non-Git segments from **Segments** and Git segments from **Git** in `/zentui`. - `footerFormat`: optional Starship-style template string that fully controls the footer layout. When set, it overrides `footerSegments`. See [Footer Format Template](#footer-format-template) below. The `/zentui` **Footer** tab configures responsive behavior, compact rows, context style, and path display mode/depth; **Appearance** configures separator and icon mode; **Git** configures branch length; set or clear custom formats with `/zentui format`. - `responsiveFooter`: enabled by default. Zentui keeps the current aligned one-row footer while every settings-resolved left/middle/right zone fits without layout truncation. Otherwise it tries two complete left-aligned rows, preferring `left` / `middle right` and then `left middle` / `right`. Only when neither split fits does it use `compactFooterFormat`. Set `false` to restore the legacy one-row fitting behavior. Selection uses measured terminal-cell width, not fixed device breakpoints. - `compactFooterFormat`: JSON-only template used by the compact stage. The default keeps cwd, session name, git branch/status, context, and abbreviated token/cache metrics. A top-level `$wrap` is an automatic wrap opportunity: one space on the same row or no space at a row break. `$wrap_sep` is the same kind of boundary but renders the styled ` | ` divider only when its adjacent chunks share a row. Nested uses of either boundary remain empty variables. `$fill` is ignored. A standalone `$extensions` chunk inserts active non-`off` extension statuses in left/middle/right placement order; embedded uses render empty. Custom `footerFormat` values use this built-in compact fallback unless this key is also customized. - `compactFooterMaxLines`: `1`, `2`, `3`, or `"unlimited"` (default `2`). Finite limits crop remaining chunks with exactly one trailing `…`. Compact cwd always uses basename mode; cwd/session/branch chunks target half the available row width before final ANSI-aware clamping. `/zentui` exposes the responsive toggle and row limit, while compact format editing remains JSON-only. Pi supplies footer width but no supported viewport-height budget, so `"unlimited"` is explicit. - `gitCommit`: Starship [`git_commit`](https://starship.rs/config/#git-commit)-style options for the `gitCommit` footer segment. `hashLength` (default `7`, clamped to `4`–`40`) controls the short-hash display length. `onlyDetached` (default `true`) shows the hash mainly on detached HEAD. `showTag` (default `true`) appends an exact-match tag (`git describe --tags --exact-match HEAD`). The tag probe piggybacks on the existing git refresh — it only runs when both the segment and `showTag` are on, and misses/failures degrade silently. - `gitMetrics`: Starship [`git_metrics`](https://starship.rs/config/#git-metrics)-style options for the `gitMetrics` footer segment. Uses `git diff HEAD --numstat` (staged + unstaged combined — the Starship “total dirty” view) to show aggregate `+added −deleted` line counts. `onlyNonzero` (default `true`) omits each zero component independently and hides the segment entirely at `0/0`. `ignoreSubmodules` (default `false`) adds `--ignore-submodules=all`. The numstat diff piggybacks on the existing git refresh and uses a hard 2s timeout; a metrics-only failure degrades silently without discarding fresh branch/status data. On very large monorepos the diff may lag or be omitted on timeout. - `extensionStatuses`: controls third-party statuses published by other Pi extensions through `ctx.ui.setStatus()`. `defaultPlacement` and each `placements` value can be `off`, `left`, `middle`, or `right`. The **Extensions** tab in `/zentui` lists only statuses that are currently active. `defaultPlacement` applies only when a status key has no entry in `placements`; keyed overrides always win. - The shown `editor*` values match the default `theme` source. Omit those keys to keep Zentui's source-aware defaults when switching between `theme` and `terminal`. - `editorAccent` styles the active editor rail and previous user-message rail when `features.copyFriendly` is disabled. - `editorPrompt` styles the copy-friendly editor prompt glyph. Omit it to use `editorAccent`, then the default accent fallback. - `editorBorder` styles previous user-message top/bottom borders and the active editor in static border color mode; the border glyph stays `─`. - `editorModel`, `editorProvider`, and `editorThinking*` style the editor metadata. `editorThinking` applies to every non-`off` thinking level unless a level-specific key is set. Tip: when using copy-friendly mode, setting Pi's `editorPaddingX` to `1` in `~/.pi/agent/settings.json` keeps a small left gutter without copying a rail glyph. ## Editor Metadata Format Set `editorMetadataFormat` in `~/.pi/agent/zentui.json` to customize the left side of the editor metadata row: ```json { "editorMetadataFormat": "$model_name ($model_id)( · $provider)( · $thinking)( · $session_name)" } ``` The syntax follows the relevant `footerFormat` conventions: `$variable` and `${variable}` references, literal text and spaces, and conditional groups `( ... )` that disappear when all variables inside are empty. Unknown variables and `$fill` render empty; `$fill` never creates an editor layout zone because the right side remains reserved for structural Vim status. | Token | Renders | | --------------- | --------------------------------------------------------------------------------------------- | | `$model` | label selected by `editorModelLabel` (`id`, or name with ID fallback) | | `$model_id` | active Pi model ID | | `$model_name` | active Pi model display name; empty when no name is set | | `$provider` | provider label using Zentui's existing formatting | | `$thinking` | current thinking level; empty when thinking is `off` | | `$session_name` | current Pi session name; empty when unnamed | Model variables use `editorModel`, provider uses `editorProvider`, and thinking uses the matching `editorThinking*` style. Literal text and `$session_name` use the neutral editor border theme style. The template controls spacing. ANSI/VT sequences, control characters, and line-breaking whitespace are sanitized before rendering without collapsing ordinary spaces. Missing, non-string, or empty values use the default `$model $provider( $thinking)`. A non-empty format that resolves to no visible metadata keeps the normal blank spacer and metadata rows so the editor frame height remains stable. This option is configured only through JSON in its first version; `/zentui format` continues to control the footer only. ## Footer Format Template For full control, set a Starship-style `footerFormat` template string. It supports `$variable` and `${variable}` tokens, a special `$fill` token that splits the line into left and right zones, and conditional groups `( ... )` that drop entirely when every nested variable is empty. When set, it overrides the built-in `footerSegments` layout; when empty or omitted, the segment layout above is used. A second `$fill` creates a **centered middle zone** — content between the two fills is true-centered (`floor((gap - middle) / 2)`), just like third-party statuses placed `middle`. ```json { "footerFormat": "$os $username $cwd($sep$session_name)( on $git_branch)( $git_status)( via $runtime)$fill($context)($sep$tokens)($sep$cost)($sep$time)" } ``` Center the branch between directory and cost: ```json { "footerFormat": "$cwd $fill $git_branch $fill $cost" } ``` ### Variables | Token | Aliases | Renders | | ------------------- | ------------ | ------------------------------------------------------------------- | | `$cwd` | `$directory` | current directory | | `$session_name` | | current Pi session name | | `$git_branch` | `$branch` | git branch with icon | | `$git_status` | `$status` | `[!?↑]` status block | | `$git_state` | `$state` | `REBASING` / `MERGING` / … (optional `n/m`) | | `$git_commit` | `$commit` | short commit hash (+ exact-match tag when present) | | `$git_tag` | `$tag` | exact-match tag at HEAD | | `$git_metrics` | | aggregate line changes `+added −deleted` | | `$git_added` | | added line count (`+N`) | | `$git_deleted` | | deleted line count (`−N`) | | `$runtime` | | runtime icon + version | | `$model` | | selected model label (`editorModelLabel`) | | `$provider` | | formatted provider label | | `$package` | | project package version, `is ` (manifest-derived) | | `$package_version` | | raw project package version (no icon) | | `$session_duration` | `$duration` | session running time | | `$username` | | `user@host` | | `$os` | | operating-system icon | | `$time` | | current time `HH:MM` | | `$context` | | context usage (text and/or gauge; finite percentages use one decimal) | | `$tokens` | | input/output counts and existing cache-hit percentage | | `$cache_read` | | cache-read total (`R1.2k`); empty at zero or when unavailable | | `$cache_write` | | cache-write total (`W300`); empty at zero or when unavailable | | `$cost` | | session cost | | `$subscription` | | `(sub)` in subscription mode; otherwise empty | | `$auto_compaction` | | `(auto)` when automatic compaction is enabled; otherwise empty | | `$sep` | `$separator` | themed `\|` using `colors.separator` | | `$fill` | — | special: splits zones | ### `$fill` behavior | `$fill` count | Layout | | ------------- | ------------------------------------------------------------------------ | | 0 | everything left-aligned | | 1 | tokens before → left, tokens after → right | | 2 | before first → left, between → **centered middle**, after second → right | | 3+ | first two count; extras ignored | - Literal text (`on branch`, `using`, `\|`, spaces) is rendered verbatim — you control all spacing. - Each variable renders its core value only (no `on`/`via` prefixes); add those words as literal text. - Conditional groups: wrap optional pieces in parentheses, e.g. `$cwd( on $git_branch)($git_status)$fill($context)`. If every `$var` inside a group is empty, the whole group (including its literals) is dropped. - `$session_name` is available whenever `footerFormat` is set, independently of `footerSegments.sessionName`; use a conditional group such as `($sep$session_name)` so unnamed sessions leave no separator. - The built-in wide footer appends cache totals to the token segment, `(sub)` to cost, and `(auto)` to context when available. Custom formats keep `$tokens`, `$cost`, and `$context` backward-compatible and include telemetry only through the atomic variables above. - `DEFAULT_COMPACT_FOOTER_FORMAT` omits model/provider and atomic telemetry. Add their variables explicitly to `compactFooterFormat` to opt in at narrow widths. - Auto-compaction settings refresh on the next normal footer synchronization event. Unsupported Pi capabilities or settings-read errors safely omit optional markers. - Unknown `$variables` render empty. - Set or clear at runtime: `/zentui format "