Skip to content

Interactive Mode

Reflex includes a terminal UI (TUI) for interactive code search. Launch it by running rfx query with no arguments:

  • Live search — results update as you type
  • Instant feedback — trigram search returns results in milliseconds
  • File preview — see matching context inline
  • Editor integration — press Enter to open results in your editor
KeyAction
TypeFilter results live
/ Navigate results
EnterOpen selected result in editor
TabToggle between search and filter modes
EscExit interactive mode
Ctrl+CQuit

When you press Enter on a result, Reflex opens the file at the matching line in your $EDITOR. Set your preferred editor:

Terminal window
export EDITOR=nvim
# or
export EDITOR="code --goto"

The TUI supports the same filters as CLI mode. You can toggle symbol-only mode and switch language filters while searching interactively.

Interactive mode is best for:

  • Exploratory search — when you’re not sure exactly what you’re looking for
  • Code review — quickly scanning through occurrences of a pattern
  • Refactoring — reviewing all uses of a function before renaming it

For scripted workflows, use CLI mode with --json output instead. See AI Integration for agent-oriented usage.