Document LocalBox TUI usage

Author: David-c0degeek

CHANGELOG.md

@@ -2,6 +2,13 @@
 
 Past-tense record of shipped changes.
 
+## 2026-05-24 — Terminal.Gui TUI and catalog polish
+
+- **`llmtui` documented as the explicit Terminal.Gui preview path.** README now covers publish/install, profile resolution, core navigation keys, and the BenchPilot handoff key.
+- **Spectre model catalog layout fixed.** The dashboard now uses explicit column widths and a compact quant list so the context column stays readable instead of wrapping to one or two characters.
+- **MTP catalog contexts expanded.** `q3535ba3bmtp` and `genesisv2` now expose an explicit `256k` context key while keeping default context at `128k`.
+- **Quant naming clarified.** README notes that labels like `mtp`, `mtp-apex`, and `mtp-q8kp` are model-local quant keys that map to concrete GGUF filenames.
+
 ## 2026-05-24 — Dropped Ollama backend (breaking)
 
 ### Breaking changes

README.md

@@ -330,6 +330,7 @@ After install, open a fresh PowerShell:
 
 ```powershell
 llm                              # interactive wizard — pick model, mode, action
+llmtui                           # Terminal.Gui TUI, explicit preview path
 info                             # verify: VRAM, default model, configured quants
 ```
 
@@ -360,6 +361,7 @@ llmdefault                        Launch the configured default recipe/model
 llmdefaultunshackled              Same, via Unshackled
 llmdefaultcodex                   Same, via Codex
 llm                               Guided wizard (Spectre when available)
+llmtui                            Terminal.Gui TUI preview
 llmc                              Native selectable wizard, explicit alias
 llms                              Spectre wizard, explicit alias
 info                              Dashboard
@@ -379,6 +381,11 @@ llm-update                        Update LocalBox + installed companion checkout
 | `-AutoBest` | Replay the latest saved tuner profile for this (model, ctx, mode). |
 | `-Quant <name>` | Switch the model's selected GGUF quant (no launch). |
 
+Quant keys are model-local labels, not a universal naming scheme. For example,
+`mtp-apex` means the Genesis V2 MTP-enabled APEX GGUF file, while another model
+may use a simpler `mtp` label when there is only one MTP variant. Use
+`info <key>` to see the exact filename behind each quant key.
+
 ### 256 k context on a 24 GB card
 
 The combination of **Qwen3-Coder-30B-A3B Heretic** (4 KV heads, 48 layers) at
@@ -646,6 +653,40 @@ $env:LOCAL_LLM_NO_SPECTRE = '1'   # disable Spectre everywhere / make llm use na
 
 ---
 
+## Terminal.Gui TUI
+
+`llmtui` launches the C# Terminal.Gui frontend. It is currently an explicit
+preview path; `llm` still opens the existing PowerShell wizard flow.
+
+Build and install it from the repo:
+
+```powershell
+pwsh .\tui\publish-tui.ps1 -Install
+reloadllm
+llmtui
+```
+
+When installed, the launcher runs `~/.local-llm/bin/LocalBox.Tui.exe` and passes
+the active `LocalLLMProfile.ps1` path with `--profile`. From a repo checkout, it
+can also run the TUI project directly with `dotnet run`, so the command works on
+fresh developer machines before publishing.
+
+Useful controls:
+
+| Key | Action |
+|-----|--------|
+| `Up` / `Down` | Move in the active list. |
+| `Enter` / `Right` | Advance through model -> context -> quant -> action -> mode -> AutoBest -> confirm. |
+| `Left` | Go back one wizard step. |
+| `Space` | Cycle the current step. |
+| `Tab` | Move focus to details so long text can scroll. |
+| `Ctrl+B` | Open BenchPilot.Tui when BenchPilot is installed and has a TUI build. |
+| `F5` | Refresh backend data. |
+| `F9` | Show dry-run launch command. |
+| `F10` | Quit. |
+
+---
+
 ## Casing convention
 
 The repo mixes three styles intentionally: