ripgrep (rg) Tutorial: Fast Codebase Search with Regex Patterns and File Filters

ripgrep vs grep — Why Speed Matters

ripgrep (rg) is significantly faster than grep and respects .gitignore by default. Learn the regex patterns, file type filters, and flags that make it indispensable for codebase search.

ripgrep (rg) is the fastest text search tool available — it respects .gitignore by default and uses SIMD for blistering speed on large codebases.

By the end of this 7 min guide, you'll have a working ripgrep setup and practical ripgrep workflows you can use immediately.

• Understand what ripgrep does and why it matters for Terminal
• Install and configure ripgrep for your environment
• Build ripgrep-specific workflows with real examples
• Troubleshoot common ripgrep issues with concrete fixes

Installation & Basic Usage

Install ripgrep:

brew install ripgrep

• Terminal environment with appropriate permissions
• No prior ripgrep experience needed
• A terminal with true color support
• Git for version-controlling your config

Regex Pattern Syntax

ripgrep's power comes from file type filters and regex. Use --type to search specific languages and -g to include/exclude patterns.

Here's a foundational configuration to start with:

# Common ripgrep usage
rg "pattern" --type py
rg "TODO" -g "!node_modules"
rg "function" -l  # list files only
rg "pattern" --json  # structured output

• Begin with this config and make small, incremental changes
• Document each setting with inline comments
• Test changes one at a time to isolate issues
• Keep your config in a Git repo for easy rollback and sharing

File Type Filters & Globs

With ripgrep configured, these ripgrep-specific workflows will save you time every day:

• rg "pattern" basic search
• rg -l "pattern" list matching files only
• rg --type py "import" search Python files
• rg -g "!*.test.js" "pattern" exclude test files
• rg --count "pattern" count matches per file

Search, Replace & Output Formats

Once you're comfortable with ripgrep basics, these advanced techniques will transform your ripgrep workflow:

• Use --replace for find-and-replace preview
• --json output for integration with fzf or scripts
• Custom file types with --type-add
• Search compressed files with -z

Search Performance on Huge Repos

Here are the most common ripgrep issues and how to fix them:

• No results? Check regex syntax — ripgrep uses Rust regex
• Hidden files not searched? Add --hidden
• .gitignore respected? Use --no-ignore to override
• Binary files skipped? Use -a to search all

Search Mastery

Congratulations — you now have a solid ripgrep foundation. Here's where to go next:

• Explore the official ripgrep documentation for features not covered here
• Join the ripgrep community (GitHub Discussions, Discord, or Reddit)
• Check the related tutorials below for deeper ripgrep dives
• Build your own ripgrep configuration and share it with the community