TUI & modes

UBLX runs as a terminal UI with a three-pane layout and main tabs across the top. Each main tab reuses the same panes but fills them with different data.

Three panes

Pane	Role
Left	Categories, lens names, duplicate groups, or settings sections
Middle	File list, lens paths, duplicate members, or settings rows
Right	Detail for the selection — Viewer / Templates / Metadata / Writing, delta overview, or inline editors

Main tabs run left to right when available. Cycle them with ~.

Main tabs

Tab	When shown	Left · Middle · Right
Snapshot	Always	Categories · files · right-pane tabs
Lenses	DB has lenses	Lens names · paths in lens · right-pane tabs
Delta	Prior snapshot exists	Change buckets · changed paths · delta overview
Duplicates	Groups exist	Group names · member paths · right-pane tabs
Settings	Always	Global / Local · option rows · description / preview

Lenses and Duplicates tabs appear only when the database has lenses or duplicate groups respectively.

Right pane (Snapshot, Lenses & Duplicates)

On Snapshot, Lenses, and Duplicates, selecting a file row in the middle pane fills the right side with ZahirScan-backed tabs when JSON exists:

Tab	Doc
Viewer	Viewer — previews (markdown, code, images, .tet, …)
Templates	Templates — patterns + examples (TUI inline / web accordion, v0.2.4+)
Metadata	Metadata — key/value and typed column tables
Writing	Writing — word/character stats when available

Focus: v / t / m / w. Shift+Tab cycles. Shift+F fullscreen Viewer; Shift+S in-pane search.

Navigation & actions

• Layout & keys — pane focus, catalog search, scrolling, enhance workflow
• Command mode & context menus — Space, Ctrl+Space, Ctrl+{leader} (default Ctrl+A)
• Press ? in the TUI for the live help overlay (sections follow the active tab)

Related

• Install — first snapshot
• Configuration — keys that change TUI behavior
• Path-only vs full enhance — what fills Metadata / Templates / Writing