Grep

Search file contents with regex using ripgrep. Use when finding code patterns, locating function definitions, searching for imports, or finding references.

knoopx Updated 84 repo stars
Search

File contents

Grep Tool

Search file contents with regex. Uses ripgrep.

REQUIRED: pattern (regex pattern) OPTIONAL: path (directory/file), glob (file glob filter like "*.py"), ignoreCase (bool), literal (bool — treat pattern as literal text), context (lines of context before/after), limit (max matches, default 100)

RULES:

  • Supports full regex syntax (unless literal: true)
  • Use glob to filter by file type (e.g. ".py", ".js")
  • Use limit to cap results; default 100
  • Returns matching lines with file path and line number
  • Good for finding function definitions, imports, references

EXAMPLE:

{"name": "Grep", "input": {"pattern": "def main", "glob": "*.py"}}

EXAMPLE with path:

{"name": "Grep", "input": {"pattern": "TODO|FIXME", "path": "/path/to/project/"}}

Workflow

  1. Simple search: Pass a regex pattern to search all files
  2. Filter by type: Use glob to limit to specific file extensions (e.g., "*.py")
  3. Scope search: Use path to limit to a directory or specific file
  4. Add context: Use context to see lines before/after matches
  5. Cap results: Use limit to control output size (default 100)

knoopx/pi commit 5d0d93b267

Frequently asked questions

npx get-skill add knoopx/grep