46 lines
1.6 KiB
Markdown
46 lines
1.6 KiB
Markdown
---
|
|
name: ripgrep
|
|
description: Efficient text search using ripgrep (rg) with one-shot patterns that minimize iterations by getting files, line numbers, and context in a single call
|
|
---
|
|
|
|
# ripgrep: Powerful, one-shot text search
|
|
|
|
## Default Strategy
|
|
|
|
**For content search: use Bash(rg) with `-e 'pattern' -n -C 2` for one-shot results.**
|
|
|
|
This gives files, line numbers, and context in a single call - minimizes iterations and context usage.
|
|
|
|
Always prefer getting line numbers and surrounding context over multiple search attempts.
|
|
|
|
## Tool Selection
|
|
|
|
**Grep tool** (built on ripgrep) - Use for structured searches:
|
|
- Basic pattern matching with structured output
|
|
- File type filtering with `type` parameter
|
|
- When special flags like `-F`, `-v`, `-w`, or pipe composition are not needed
|
|
- Handles 95% of search needs
|
|
|
|
**Bash(rg)** - Use for one-shot searches needing special flags or composition:
|
|
- Fixed string search (`-F`)
|
|
- Invert match (`-v`)
|
|
- Word boundaries (`-w`)
|
|
- Context lines with patterns (`-n -C 2`)
|
|
- Pipe composition (`| head`, `| wc -l`, `| sort`)
|
|
- Default choice for efficient one-shot results
|
|
|
|
**Glob tool** - Use for file name/path matching only (not content search)
|
|
|
|
## When to Load Detailed Reference
|
|
|
|
Load [ripgrep guide](./reference/ripgrep-guide.md) when needing:
|
|
- One-shot search pattern templates
|
|
- Effective flag combinations for complex searches
|
|
- Pipe composition patterns
|
|
- File type filters reference (`-t` flags)
|
|
- Pattern syntax examples
|
|
- Translation between Grep tool and rg commands
|
|
- Performance optimization for large result sets
|
|
|
|
The guide focuses on practical patterns for getting targeted results in minimal calls.
|