Grep

SkillSearch

Lets your agent search file contents for regex patterns and get matching lines with file paths and line numbers.

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Account requirements not reviewed. Check the skill instructions before use; ahel provides instructions and does not run this skill.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Grep skill

About this skill

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.

What this skill tells your AI

The instructions your AI receives, as published by openakita/openakita in skills/system/grep/SKILL.md and read by ahel’s review.

跨平台内容搜索工具。

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: 编辑搜索到的匹配

Signals

GitHub stars: 2k
Forks: 280
Last commit: Sep 2026

Advanced

Item type: skill
Key: grep
Source: github.com/openakita/openakita

github.com/openakita/openakita