Grep

Search file contents using regex pattern across directories. Cross-platform pure Python implementation (no external tools needed). Returns matching lines with file paths and line numbers.

openakita Updated

File contents

Grep

跨平台内容搜索工具。

Parameters

参数 类型 必填 说明
pattern string 正则表达式搜索模式
path string 搜索目录(默认当前目录)
include string 文件名 glob 过滤(如 "*.py")
context_lines integer 匹配行前后的上下文行数(默认 0)
max_results integer 最大返回匹配数(默认 50)
case_insensitive boolean 是否忽略大小写(默认 false)

Examples

搜索函数定义:

{
  "pattern": "def test_",
  "include": "*.py"
}

搜索 TODO 标记(忽略大小写):

{
  "pattern": "TODO|FIXME",
  "case_insensitive": true,
  "max_results": 20
}

搜索并显示上下文:

{
  "pattern": "class.*Error",
  "path": "src/",
  "context_lines": 3
}

Notes

  • 自动跳过 .git、node_modules、pycache、.venv 等目录
  • 自动跳过二进制文件
  • 纯 Python 实现,无需安装 ripgrep/grep
  • 返回格式: file:line_number:content

Related Skills

  • glob: 按文件名模式查找文件
  • read-file: 读取搜索到的文件
  • edit-file: 编辑搜索到的匹配

openakita/openakita commit bbb69310c1

Frequently asked questions

npx skillmds@latest add openakita/grep