Grep

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

knoopx 5d0d93b 1.3 KB Updated

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/tree/main/agent/skills/tools/grep commit 5d0d93b267

Frequently asked questions

npx skillmds@latest add knoopx/grep