Does MLVA replace ripgrep or grep?

No. MLVA is complementary. Use ripgrep when you know the exact string, variable name, or regex pattern. Use MLVA when you describe what the code does conceptually in natural language (e.g. 'code that calculates cosine similarity').

How does MLVA semantic search differ from fzf?

fzf uses fuzzy character distance (Levenshtein distance) on file paths or command lines. MLVA computes 384-dimensional dense vector embeddings of file contents, understanding synonyms and algorithmic concepts.

Tool Architecture & Engineering Analysis

MLVA vs Ripgrep, FZF, and Grep

Understanding when to use exact regex matching versus local AI-powered semantic search for terminal code navigation.

Comprehensive Developer Tool Matrix

Search Dimension	MLVA (mlva-cli)	ripgrep (rg)	fzf	grep
Core Paradigm	Semantic & Hybrid BM25 Vectors	Ultra-Fast Exact Regex	Interactive Fuzzy String Matching	POSIX Standard Regular Expressions
Query Language	Plain English & Natural Language	Regex Patterns / Literal Substrings	Typo-Tolerant String Fragments	Basic / Extended POSIX Regex
Synonym & Concept Awareness	Yes (dense 384-d embeddings)	No (literal only)	No (fuzzy distance only)	No (literal only)
Offline AI Execution	100% Offline (Local ONNX CPU)	N/A (Non-AI)	N/A (Non-AI)	N/A (Non-AI)
Terminal Code Viewer	Built-in (`mlva show` with syntax & line ranges)	Terminal snippets only	Preview window (via bat/less)	Line snippets only
Editor Launchers	Direct (`mlva code`, `open`, `reveal`)	Requires piping / xargs	Configurable shell bindings	Requires piping / xargs
Index Requirement	SQLite pre-indexed database	On-the-fly recursive filesystem crawl	On-the-fly pipe stream	On-the-fly filesystem crawl

Deep-Dive Comparison Scenarios

Scenario 1: You remember what the code does, but not the function name

Suppose you wrote a Python script last semester that converts continuous values into binary labels using a median threshold. You don't recall whether you named the function binarize, threshold_cut, or convert_two_classes.

With ripgrep:
You must guess regex patterns: rg "def binarize" (0 results), rg "threshold" (40 unrelated matches in data loaders).

With MLVA:
mlva "convert continuous target into two classes" --lang python
Result: Instantly surfaces q093_convert_continuous_target_two_classes.py with 96% similarity!

Scenario 2: You know the exact symbol name

When searching for an exact identifier like PORT_NUMBER = 8080 or a specific import statement import better_sqlite3:

Use ripgrep for exact string search

rg "PORT_NUMBER = 8080"

Recommendation: Use ripgrep for exact literal lookups across raw filesystem trees. Use MLVA for semantic task queries.

Summary: When to Use Each Tool

Use ripgrep (rg) when: You know the exact function name, variable name, or regex pattern.
Use fzf when: You want an interactive, keyboard-driven fuzzy selector for file paths in your shell history.
Use MLVA (mlva) when: You describe code conceptually in normal language, want to search indexed study notes, or want to inspect complete code with syntax highlighting in your terminal.