Openakita 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.

install
source · Clone the upstream repo
git clone https://github.com/openakita/openakita
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openakita/openakita "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/system/grep" ~/.claude/skills/openakita-openakita-grep && rm -rf "$T"
manifest: skills/system/grep/SKILL.md
source content

Grep

跨平台内容搜索工具。

Parameters

参数类型必填说明
patternstring正则表达式搜索模式
pathstring搜索目录(默认当前目录)
includestring文件名 glob 过滤(如 "*.py")
context_linesinteger匹配行前后的上下文行数(默认 0)
max_resultsinteger最大返回匹配数(默认 50)
case_insensitiveboolean是否忽略大小写(默认 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
    : 编辑搜索到的匹配