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 — structure / outline snippets |
| 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+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