busca

Fast terminal search TUI powered by ripgrep.

Preview

What It Does

• rg term panel: case-insensitive search across both file content and file names.
• fuzzy panel: narrows matches by file, line, and content.
• preview panel: navigate with hjkl/arrows, visual select with v.

Requirements

• Node.js (v18+ recommended)
• npm
• rg (ripgrep) (required)
• bat (optional, for syntax-highlighted preview)

Homebrew (macOS/Linux) example:

brew install ripgrep bat

Install

Global install (SSH):

npm install -g git+ssh://git@github.com/rokyed/busca.git

Global install (HTTPS):

npm install -g github:rokyed/busca

Install manually:

git clone git@github.com:rokyed/busca.git
cd busca
npm install
npm link

Usage

busca
busca /path/to/project
busca -h
busca /path/to/project --max-results 100000 --max-bat-bytes 4194304