Option

Description

--allow-dir <path>

Restrict search scope to the specified directory (can be specified multiple times)

--max-result-chars <number>

Maximum characters in results. Truncates at line boundaries when exceeded (default: 50,000)

--max-output-bytes <number>

Maximum bytes of ripgrep output. Terminates the process and truncates results when exceeded (default: 20 MB)

Tool

Description

search

Pattern search with regex, literal strings, multiline matching, OR matching, context lines, and various filters. Prepends a summary of match count and file count to results

search-and-replace

Search-and-replace preview (read-only). Supports multiline matching and capture groups ($1, ${name})

search-count

Count matches per file (by line count or total matches). Supports sorting results

search-files

List files that match or do not match a pattern

list-files

List all files within the search scope

list-file-types

List file types supported by ripgrep

Parameter

Description

pattern

Search pattern (regex by default)

path

Directory or file to search

fixedStrings

Treat the pattern as a literal string

caseSensitive

true = case-sensitive, false = case-insensitive, omitted = smart-case

fileType

Filter by file type (e.g., "ts", ["ts", "js"]). String or array

fileTypeNot

Exclude file types (e.g., "json", ["json", "md"]). String or array

glob

Filter by glob pattern (e.g., "*.test.ts", ["src/**", "!vendor/**"]). String or array

includeHidden

Include hidden files

followSymlinks

Follow symbolic links

maxDepth

Maximum directory traversal depth

noIgnore

Ignore .gitignore rules and search files that are normally excluded

multiline

Enable multiline matching (function signatures, import blocks, etc.)

additionalPatterns

Additional patterns for OR matching (array)

sortBy

Sort results. search / search-files / list-files: "path" "modified" "created". search-count: "path" "count" "count-asc"

maxCharacters

Maximum characters in results. Truncates at line boundaries and appends a summary when exceeded

Parameter

list-file-types

list-files

search

search-and-replace

search-count

search-files

pattern

-

-

o

o

o

o

path

-

o

o

o

o

o

fixedStrings

-

-

o

o

o

o

caseSensitive

-

-

o

o

o

o

wordMatch

-

-

o

o

o

o

multiline

-

-

o

o

-

-

fileType

-

o

o

o

o

o

fileTypeNot

-

o

o

o

o

o

glob

-

o

o

o

o

o

maxResults

-

-

o

o

-

-

contextLines

-

-

o

-

-

-

beforeContext

-

-

o

-

-

-

afterContext

-

-

o

-

-

-

invertMatch

-

-

o

-

-

o

includeHidden

-

o

o

o

o

o

followSymlinks

-

o

o

o

o

o

maxDepth

-

o

o

o

o

o

additionalPatterns

-

-

o

-

-

-

jsonOutput

-

-

o

-

-

-

maxColumns

-

-

o

-

-

-

noIgnore

-

o

o

o

o

o

sortBy

-

o

o

-

o

o

maxCharacters

o

o

o

o

o

o

replacement

-

-

-

o

-

-

onlyMatching

-

-

-

o

-

-

countMode

-

-

-

-

o

-

includeZero

-

-

-

-

o

-