Code Search — Fast Codebase Exploration

Efficient file and content search. Always prefer rg over raw grep.

File Search

find <dir> -type f -name "*.ts" | head -50           # by extension
find <dir> -type f -name "*.ts" -mtime -7 | head -30  # recently modified
find <dir> -path "*/services/*.ts" -type f             # by path pattern

Content Search (ripgrep)

rg -l "pattern" <dir>                                  # file list only
rg -n -C 2 "pattern" <dir>                             # with context
rg -n "pattern" --type ts <dir>                        # filter by type
rg -n "TODO" -g "*.ts" -g "!node_modules" <dir>       # glob filter
rg -c "pattern" <dir>                                  # count per file
rg -n -U "interface\s*\{[^}]*\}" <dir> --type ts      # multiline

Project Structure Discovery

1. find <dir> -maxdepth 2 -type d | sort | head -50
2. find <dir> -maxdepth 2 \( -name "package.json" -o -name "tsconfig.json" -o -name "Makefile" -o -name "*.toml" \) | sort
3. rg -l "main\(|export default|app\." <dir> --type ts --type js | head -20
4. find <dir> -type f | sed 's/.*\.//' | sort | uniq -c | sort -rn | head -15

Common Patterns

Tips

• Exclude node_modules, .git, dist, build: use -g "!node_modules"
• Pipe through head -N to avoid flooding context
• Use rg -F "literal" for exact strings with special chars
• Use rg -l first (files only), then rg -n -C 2 for detail
• Fallback: grep -rn --include="*.ts" if rg unavailable