TUI

Launch with no query:

mdfu [--root DIR] [--hidden] [--limit N] [--archived] [--no-hyperlinks]

Type to narrow — bare words fuzzy, key:value hard-filters via the live FilterFunc (scan → parse → query → rank on every keystroke). Query terms are emphasized (yellow background) in both the result list and the preview pane; matches compose with the markdown syntax highlighting. Editing the query re-anchors the cursor: if the selected document survives into the new results it stays selected, otherwise the cursor resets to the top. Enter prints the selection (pipeable to editors/fzf flows).

Keybindings (internal/tui/tui.go:Model.Update)

Key	Action
up / ctrl+k	Cursor up (wraps).
down / ctrl+j	Cursor down (wraps).
enter	Confirm: multi-selection if any, else cursor item.
esc / ctrl+c	Abort (no output).
tab	Toggle multi-select on cursor item (the checkbox column appears only once a selection exists).
ctrl+a	Toggle archived visibility (default hidden).
ctrl+p	Toggle preview pane (glamour-highlighted markdown preview of the first 30 body lines + filename header, title, and frontmatter rows; side-by-side when ≥100 cols).
ctrl+f	Toggle the frontmatter block in the preview (the labeled rows between the title and the body). The startup default comes from show_frontmatter in the Configuration file.
ctrl+o	Open the previewed document’s first web link (its Resource, else the first link in the body) in the default browser.
other	Edit query and refilter.

Status bar: matched/total • archived:hidden|shown • fm:shown|hidden • tab:multi • enter:select. The fm: field reports the ctrl+f frontmatter toggle.

Links

In the preview, markdown links render as their label only; the target is carried as an OSC 8 terminal hyperlink so Ctrl/Cmd-click opens it without cluttering the pane. The document’s Resource frontmatter is shown as a clickable Resource: row. ctrl+o opens the same link from the keyboard.

Only http, https and mailto targets are made clickable — relative paths and anchors render as plain label text. Links inside code spans and fenced code blocks are left literal.

On terminals without OSC 8 support, pass --no-hyperlinks: links fall back to the usual label url rendering so the target stays visible and copyable.

Screenshot

Headless Model.View() capture:

> Search... (bare words fuzzy, key:value hard-fil…
> Ship mdfu MVP [Task]  testdata/portent-task.md
  Monthly Active Users [Metric]  testdata/okf-v02-metric.md
  Legacy Retention Claim [Claim]  testdata/okf-v01-legacy.md
  Generic Note  testdata/generic.md
portent-task.md
Ship mdfu MVP
Path: testdata/portent-task.md
Type: Task
Tags: tolaria launch Project Atlas
Status: draft
Finish the parser track so the search track can rank fixtures.
4/5 • archived:hidden • fm:shown • tab:multi • enter:select

The preview stacks, top to bottom: the filename header (base name, own color), the document title (own color, no Title: label), the frontmatter rows as key: value with list values rendered as colored pills (here Tags:), and the rendered markdown body. JSON-object frontmatter values flatten inline under their parent key as k1: v1, k2: v2. The old Preview heading and --- separator are gone; the full Path: row stays in the frontmatter block so the complete path remains visible and copyable.

See also: Query Syntax for what to type, and CLI for non-interactive filter mode.