rfgrep

A command-line utility for recursively searching and listing files with advanced filtering capabilities. Built in Rust.

Features

• Advanced Search

  • Regex, plain text, and whole-word matching
  • Recursive directory traversal
  • Binary file detection
  • Extension filtering
  • Size limits

• File Listing

  • Detailed/simple output formats
  • Extension statistics
  • Size filtering
  • Hidden file handling

• Utilities

  • Clipboard copy support
  • Dry-run mode
  • Logging to file
  • Progress indicators

Installation

From Source

git clone https://github.com/kh3rld/rfgrep.git
cd rfgrep
cargo install --path .

Via Cargo

cargo install rfgrep

Usage

Basic Search

rfgrep search "pattern"

Search with Options

rfgrep search "pattern" \
    --mode regex \
    --extensions rs,toml \
    --max-size 5 \
    --skip-binary \
    --copy

File Listing

# Simple list
rfgrep list

# Detailed view
rfgrep list --long --recursive

# With filters
rfgrep list --extensions rs,toml --max-size 10 --show-hidden

Command Reference

Global Options

Search Command

List Command

Examples

1. Find all Rust files containing "HashMap":

rfgrep search "HashMap" --extensions rs

2. List all Markdown files under 1MB:

rfgrep list --extensions md --max-size 1

3. Search with regex and copy to clipboard:

rfgrep search "fn\s+\w+\s*\(" --mode regex --copy

Performance Tips

• Use --skip-binary to avoid unnecessary file checks
• Limit scope with --extensions and --max-size
• For large directories, --dry-run first to preview

Contributing

Contributions are welcome! Please open an issue or PR for any:

• Bug reports
• Feature requests
• Performance improvements