Skip to content

tui

fialr tui

Open the interactive terminal UI. Running fialr with no arguments on an interactive terminal opens the TUI as well; in a pipe, script, or CI (non-interactive), fialr prints help instead.


The TUI is a full-screen interactive shell over the same core operations as the CLI — it calls the same functions, so behavior is identical. Screens:

  • Dashboard — the corpus at a glance: files tracked, duplicate groups, review-queue size, enrichment %, embeddings, last job, database size, and license status. The same data as fialr status, refreshed live.
  • Browser — a directory tree; select a folder to see a summary and hand it to the pipeline runner.
  • Review — the review queue (Tier 1 and low-confidence enrichment results) in a table; mark entries reviewed.
  • Search — keyword (FTS5), semantic, or AI-expanded search with a mode toggle. Degrades gracefully when Ollama or a provider is unavailable.
  • Pipeline — a dry-run scan + classify over a chosen target, with live progress and a sensitivity-tier summary. The TUI never runs destructive operations — use the CLI with --execute for those.

Navigation is keyboard-driven; the footer shows the active key bindings.


The TUI honors the global options:

  • --db PATH — use a specific database
  • --config PATH — use a specific fialr.toml
fialr tui
fialr --db path/to/fialr.db tui

  • status — the same dashboard, non-interactively
  • search — search from the command line