Welcome to the command center of the Oh My Pi StatusLine.

The terminal real estate is sacred. The OMP StatusLine architecture is built on a philosophy of strict signal-to-noise ratio and zero UI bloat. By religiously applying DRY, KISS, and Separation of Concerns (SoC), the HUD guarantees that you only see exactly what you need to achieve absolute focus.

Whether you choose a finely-tuned preset or transcend mortal limits via a completely custom layout, you command the terminal DOM.


πŸ› οΈ Core Configuration Flags

The OMP HUD is driven by a set of core settings defined in your configuration. These flags govern the macro-layout, visual delimiters, and base behaviors of the StatusLine.

  • πŸ‘‘ statusLine.preset
    The core layout engine and structural vibe.
    Allowed values: default | minimal | compact | full | nerd | ascii | custom

  • πŸ”ͺ statusLine.separator
    The visual delimiter connecting your data segments.
    Allowed values: powerline | powerline-thin | slash | pipe | block | none | ascii

  • πŸ«₯ statusLine.transparent
    Toggles background rendering for a floating or solid aesthetic.
    Allowed values: true | false

  • 🎨 statusLine.sessionAccent
    Applies dynamic tinting to HUD borders based on the active session context.
    Allowed values: true | false

  • πŸͺ statusLine.showHookStatus
    Toggles the visibility of background execution and hook messages.
    Allowed values: true | false


🧭 HUD Documentation Navigation

Ready to transcend mortal limits? Dive into the deep-dive sub-pages to master every pixel of your terminal estate:

  • 🎨 The Sacred Presets
    Explore the 6 pre-packaged UI layouts. From the zero-distraction minimal vibe to the maximalist data-density of nerd, find the layout that matches your workflow.

  • πŸ“ Custom Orchestration
    Unlock limit-break mode via preset: custom. Learn to command the β€œHoly Trinity” of configuration (leftSegments, rightSegments, and segmentOptions) to manually enforce your interface layout and achieve absolute architectural sovereignty.

  • πŸ–ŒοΈ Theming & Git Quirks
    Control the visual plane. Learn how to map your colors precisely using strict theming tokens, and avoid cascading UI failures with the purified Git state mappings (e.g., statusLineGitClean, statusLineStaged).

Contents