An interactive UI for ripgrep.

Enter rgi, then use ripgrep as usual: search results will update dynamically.

Keyboard shortcuts

• Enter: Open the line in your editor / IDE
• Ctrl+\: Toggle rg options inline for editing vs pinned in footer
• Alt+Up/Down: Navigate history of past rgi searches

rg usage notes

Consider using:

• -g for on-the-fly file path filtering
• config file for project-specific file path inclusions/exclusions

See rg --help or an rg manpage.

fzf usage notes

Use the FZF_DEFAULT_OPTS environment variable to set fzf options. Please open an issue if rgi is setting fzf options that you wish to control yourself. See the environment variables section of fzf --man.

Editor configuration

Set RGI_EDITOR to one of the values with built-in support (vscode, cursor, idea, zed, vim, emacs, pycharm, helix, wormhole). Alternatively set it to the absolute path of an executable that accepts two arguments: an absolute file path, and a line number.

Install uv, ripgrep, fzf, bat, delta (e.g. on macos brew install uv ripgrep fzf bat git-delta).

Then:

uv tool install git+https://github.com/dandavison/rgi
export RGI_EDITOR=vscode  # vscode | cursor | idea | zed | vim | emacs | pycharm | helix | wormhole | /path/to/custom-editor

Update to latest version

uv tool uninstall rgi
uv tool install git+https://github.com/dandavison/rgi