How do I install the Ripgrep CLI skill?

Run npx skillmds@latest add grandamenium/ripgrep-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Ripgrep CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ripgrep CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Ripgrep CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Ripgrep CLI?

grandamenium (@grandamenium) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ripgrep CLI by grandamenium — Agent Skill

Name: Ripgrep CLI
Author: grandamenium

File contents

ripgrep (rg)

Blazing fast line-oriented search tool. Recursively searches directories with regex, respecting .gitignore.

Official repo: https://github.com/BurntSushi/ripgrep
Docs: https://github.com/BurntSushi/ripgrep/blob/master/GUIDE.md

Common Commands

Basic Search

rg "pattern"                               # Search current dir recursively
rg "pattern" src/                          # Search specific directory
rg "pattern" file.txt                      # Search specific file
rg -i "pattern"                            # Case insensitive
rg -w "word"                               # Whole word match
rg -F "literal string"                     # Fixed string (no regex)

Regex

rg "fn\s+\w+"                              # Functions in Rust
rg "import .* from"                        # ES module imports
rg "TODO|FIXME|HACK"                       # Multiple patterns
rg "error" --multiline                     # Multi-line patterns

File Type Filtering

rg "pattern" -t py                         # Only Python files
rg "pattern" -t js -t ts                   # JS and TS files
rg "pattern" -T test                       # Exclude test files
rg "pattern" -g "*.json"                   # Glob pattern
rg "pattern" -g "!node_modules"            # Exclude directory
rg --type-list                             # Show all file types

Context

rg "pattern" -C 3                          # 3 lines before and after
rg "pattern" -B 2                          # 2 lines before
rg "pattern" -A 5                          # 5 lines after

Output Control

rg "pattern" -l                            # Files with matches only
rg "pattern" -c                            # Count matches per file
rg "pattern" --json                        # JSON output
rg "pattern" -n                            # Line numbers (default)
rg "pattern" -o                            # Only matching text
rg "pattern" --stats                       # Show statistics

Replacement

rg "old" -r "new"                          # Show replacements (preview)
rg "(\w+)@(\w+)" -r '$2/$1'               # Regex capture groups

Advanced

rg "pattern" --hidden                      # Include hidden files
rg "pattern" --no-ignore                   # Don't respect .gitignore
rg "pattern" -z                            # Search compressed files
rg "pattern" --sort modified               # Sort by modification time
rg "pattern" -m 5                          # Max 5 matches per file

Agent Best Practices

Use --json for machine-parseable output
Use -l (files only) when you need file paths, not content
Use -t for file types instead of glob patterns when possible
Use -F for literal strings to avoid regex escaping issues
Use --stats to understand search scope and match counts
Combine -c (count) with --sort-files for finding files with most matches
rg respects .gitignore by default - use --no-ignore to override

Example Workflows

Find all TODO comments in source code

rg "TODO|FIXME" -t py -t js -t ts --stats

Find files containing a function definition

rg "def process_payment" -l

---name: ripgrep-clidescription: Use ripgrep (rg) for extremely fast recursive regex search across codebases. Respects .gitignore, supports file type filtering, and produces structured output.---# ripgrep (rg)Blazing fast line-oriented search tool. Recursively searches directories with regex, respecting .gitignore.- **Official repo:** https://github.com/BurntSushi/ripgrep- **Docs:** https://github.com/BurntSushi/ripgrep/blob/master/GUIDE.md## Common Commands### Basic Search```bashrg "pattern" # Search current dir recursivelyrg "pattern" src/ # Search specific directoryrg "pattern" file.txt # Search specific filerg -i "pattern" # Case insensitiverg -w "word" # Whole word matchrg -F "literal string" # Fixed string (no regex)```### Regex```bashrg "fn\s+\w+" # Functions in Rustrg "import .* from" # ES module importsrg "TODO|FIXME|HACK" # Multiple patternsrg "error" --multiline # Multi-line patterns```### File Type Filtering```bashrg "pattern" -t py # Only Python filesrg "pattern" -t js -t ts # JS and TS filesrg "pattern" -T test # Exclude test filesrg "pattern" -g "*.json" # Glob patternrg "pattern" -g "!node_modules" # Exclude directoryrg --type-list # Show all file types```### Context```bashrg "pattern" -C 3 # 3 lines before and afterrg "pattern" -B 2 # 2 lines beforerg "pattern" -A 5 # 5 lines after```### Output Control```bashrg "pattern" -l # Files with matches onlyrg "pattern" -c # Count matches per filerg "pattern" --json # JSON outputrg "pattern" -n # Line numbers (default)rg "pattern" -o # Only matching textrg "pattern" --stats # Show statistics```### Replacement```bashrg "old" -r "new" # Show replacements (preview)rg "(\w+)@(\w+)" -r '$2/$1' # Regex capture groups```### Advanced```bashrg "pattern" --hidden # Include hidden filesrg "pattern" --no-ignore # Don't respect .gitignorerg "pattern" -z # Search compressed filesrg "pattern" --sort modified # Sort by modification timerg "pattern" -m 5 # Max 5 matches per file```## Agent Best Practices- Use `--json` for machine-parseable output- Use `-l` (files only) when you need file paths, not content- Use `-t` for file types instead of glob patterns when possible- Use `-F` for literal strings to avoid regex escaping issues- Use `--stats` to understand search scope and match counts- Combine `-c` (count) with `--sort-files` for finding files with most matches- rg respects .gitignore by default - use `--no-ignore` to override## Example Workflows### Find all TODO comments in source code```bashrg "TODO|FIXME" -t py -t js -t ts --stats```### Find files containing a function definition```bashrg "def process_payment" -l```

Frequently asked questions

Ripgrep CLI