> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bensevern.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Interactive TUI

> Gold-themed terminal UI for GoldenMatch: 8 tabs for data profiling, configuration, match review, golden records, active learning, export, AutoConfigController telemetry, and Learning Memory corrections.

GoldenMatch includes a gold-themed terminal UI built with Textual. Launch it with `goldenmatch interactive`, or add `--tui` to a `goldenmatch dedupe` run to review that run interactively. (As of v2.7.x `dedupe` is non-interactive by default — it writes golden records and prints a summary; `--tui` opts into review.)

```bash theme={null}
goldenmatch interactive customers.csv
goldenmatch interactive customers.csv --config config.yaml
```

## 8 Tabs

The TUI has 8 tabs. The first 7 are accessible via keyboard shortcuts `1` through `7`; use `Tab` to cycle through all of them, including Corrections.

### Tab 1: Data

Data profiling view. Shows:

* Record count, column names, data types
* Null percentages, unique value counts
* Sample values for each column
* Auto-detected column types (name, email, phone, zip, address)

### Tab 2: Config

Configuration editor. Shows:

* Auto-detected matchkeys, blocking strategy, and golden rules
* Edit thresholds, scorers, and weights inline
* Save configuration to YAML
* Run/Edit/Save buttons

### Tab 3: Matches

Split-view match results:

* **Left panel**: cluster list with IDs, sizes, and confidence scores
* **Right panel**: golden record + individual member details for selected cluster
* Live threshold slider: arrow keys adjust threshold in 0.05 increments with instant cluster count preview
* Click any cluster to inspect member records and field-level scores

### Tab 4: Golden

Golden record viewer:

* Canonical merged records
* Merge strategy applied to each field
* Source provenance for each value
* Export golden records to CSV

### Tab 5: Boost

Active learning for accuracy improvement:

* Shows borderline pairs (near the threshold)
* Label with keyboard: `y` (match), `n` (no match), `s` (skip)
* After labeling \~10 pairs, trains a LogisticRegression classifier
* Reclassifies all borderline pairs with the trained model
* Shows before/after accuracy comparison

### Tab 6: Export

Output options:

* Export golden records, duplicates, unique records
* Choose format: CSV or Parquet
* Export lineage JSON
* Generate HTML report

### Tab 7: Controller (v1.7-v1.12)

AutoConfigController telemetry from the most recent `Ctrl+A` invocation:

* Health verdict badge (green / yellow / red)
* `StopReason` with one-line hover explanation
* Committed matchkeys with `Path Y · N NE` indicator + expandable NE field rows
* Complexity profile cells (pairs, above-threshold, borderline, blocks, p99, clusters, transitivity)
* Indicator column priors table (identity / corruption scores)
* Refit decisions table (iter / rule / rationale / wall-clock)

Same JSON shape as the web `/api/v1/controller/telemetry` endpoint and the CLI `goldenmatch autoconfig` output.

### Tab 8: Corrections

Learning Memory corrections browser:

* Table of stored corrections (pair, decision, source, trust, dataset)
* Live filter by dataset
* `r` to refresh, `d` to delete the selected correction
* Writes happen through the Golden and Matches correction modals

## Keyboard shortcuts

| Key            | Action                                                                               |
| -------------- | ------------------------------------------------------------------------------------ |
| `1`--`7`       | Jump to tab (Data, Config, Matches, Golden, Boost, Export, Controller)               |
| `F5`           | Run the pipeline                                                                     |
| `Ctrl+A`       | **Auto-configure**: run AutoConfigController; adopt config; switch to Controller tab |
| `?`            | Show all keyboard shortcuts                                                          |
| `Ctrl+E`       | Export results                                                                       |
| `Left`/`Right` | Adjust threshold (Matches tab)                                                       |
| `y`            | Label pair as match (Boost tab)                                                      |
| `n`            | Label pair as non-match (Boost tab)                                                  |
| `s`            | Skip pair (Boost tab)                                                                |
| `q`            | Quit                                                                                 |

## Pipeline progress

On first run, the TUI shows a full-screen progress view:

* Stage tracker with status indicators (done / running / pending)
* Progress bar for the current stage
* Record count and timing

On re-runs (e.g., after threshold adjustment), progress appears in the footer bar.

## Auto-config summary

After auto-configure runs (`Ctrl+A`), a review screen shows:

* Detected columns and their inferred types
* Suggested scorers for each column
* Proposed blocking strategy
* Three options: **Run** (accept and run), **Edit** (modify config), **Save** (write YAML)

## TUI with config file

```bash theme={null}
goldenmatch interactive customers.csv --config config.yaml
```

When a config file is provided, the TUI skips auto-detection and uses the specified matchkeys, blocking, and golden rules.

## Screenshots

The TUI uses a dark theme with gold accents. Key views:

* **Data tab**: column profiling with null rates and type detection
* **Matches tab**: split-view cluster browser with threshold slider
* **Golden tab**: merged records with merge provenance