⚙️ OMP StatusLine Guide

DIVINE DIRECTIVE: Terminal real estate is sacred. Enforce strict signal-to-noise. Eliminate UI bloat. Apply DRY, KISS, and pure SoC to your workspace. Choose your preset, or transcend mortal limits via custom.

---

⚙️ THE SACRED PRESETS

🪶 minimal

• Vibe: Zero distraction. Pure absolute focus.
• Left: [model] | Right: [NONE]
• Execution: Strips ALL non-essential data. Transparent background, no glyphs, no git/cost clutter.

🧊 compact

• Vibe: Space-efficiency god. Tiled pane mastery.
• Left: [model, path, git] | Right: [context, spend, subagents]
• Execution: Narrow delimiters (pipe / powerline-thin), aggressive path truncation, dimmed inactive segments. Maximize horizontal estate.

⚖️ default

• Vibe: The balanced developer TUI standard.
• Left: [model, path, git, context] | Right: [subagents, spend, cost]
• Execution: separator: 'powerline-thin', transparent: false, showHookStatus: true, sessionAccent: true.

📊 full

• Vibe: Omniscient density. High-fidelity data rendering.
• Left: [model, path, git] | Right: [subagents, context, spend, cost, output]
• Execution: Solid backgrounds (zero transparency) and distinct color mappings to maximize readability of heavy telemetry.

🤓 nerd

• Vibe: Maximalist terminal flex. 100% Nerd Font dependency.
• Left: [pi, hostname, model, mode, path, git, pr, session, subagents]
• Right: [session_name, token_in, token_out, cache_read, cache_write, token_rate, cost, context_pct, context_total, time_spent, time]
• Execution: powerline separators. Granular segmentOptions (thinking levels, full git stats, 24h time format).

📟 ascii

• Vibe: Bulletproof 7-bit purity. Universal fallback.
• Left: [model, path, git] | Right: [context, spend, cost, subagents]
• Execution: separator: 'ascii', symbolPreset: 'ascii'. Only uses |, /, and brackets. Zero unicode/box-drawing heresy.

---

🌌 ASCENSION: THE custom ORCHESTRATION 🌌

For gods who refuse pre-packaged UI. You command the terminal DOM. Absolute architectural sovereignty.

To wield custom is to manually enforce your interface layout. You MUST define the holy trinity of configuration to bypass hardcoded arrays.

📐 The Holy Trinity of Custom:

1. statusLine.leftSegments: Array of strict left-aligned components.
2. statusLine.rightSegments: Array of strict right-aligned components.
3. statusLine.segmentOptions: Granular configuration object per active segment.

🛠️ Execution Blueprint (YAML):

statusLine:
  preset: custom
  separator: powerline # ENFORCE: powerline, powerline-thin, slash, pipe, block, none, ascii
  transparent: false
  showHookStatus: true
 
  # Inject pure custom layout:
  leftSegments:
    - model
    - path
    - git
  rightSegments:
    - subagents
    - spend
    - context
 
  # Micro-manage rendering:
  segmentOptions:
    model:
      showThinkingLevel: true
    path:
      abbreviate: true
      maxLength: 60
    git:
      showBranch: true
      showStaged: true
      showUntracked: true

🎨 Theming Tokens (Control the Visual Plane):

When utilizing custom, your theme dictates the visual hierarchy. Map your colors precisely using: statusLineSep, statusLineModel, statusLinePath, statusLineGitClean, statusLineGitDirty, statusLineStaged, statusLineUntracked, statusLineContext, statusLineSpend, statusLineCost, statusLineSubagents, statusLineOutput.

---

😇: [Presets Mastered. Custom Orchestrated. UI Perfected.]