用途:gh-grep 通过 grep.app 在超过一百万个公开 GitHub 仓库中搜索真实代码示例,适合查找陌生 API 或库的实现模式、正确语法与参数、配置示例、生产级代码范例,以及理解不同库和框架如何协同工作。
主要能力:支持按字面代码模式搜索,可开启大小写敏感、全词匹配、正则表达式;可按仓库(如 facebook/react)、文件路径(如 src/components/)、语言(逗号分隔,如 TypeScript,TSX)过滤。输出格式支持 text、markdown、json、raw,并可设置调用超时(默认 30000 毫秒)。
使用方式:需 Bun 运行时,脚本内嵌 mcporter 包。基础命令为 bun /home/hazeruno/.config/opencode/skills/gh-grep/scripts/grep.ts searchGitHub --query "<code-pattern>" [options]。例如搜索认证模式:bun /home/hazeruno/.config/opencode/skills/gh-grep/scripts/grep.ts searchGitHub --query "getServerSession" --language "TypeScript,TSX";正则搜索 useEffect 清理:bun /home/hazeruno/.config/opencode/skills/gh-grep/scripts/grep.ts searchGitHub --query "(?s)useEffect(() => {.*removeEventListener" --use-regexp true;限定仓库搜索:bun /home/hazeruno/.config/opencode/skills/gh-grep/scripts/grep.ts searchGitHub --query "createContext" --repo "facebook/react"。
适用场景:查找实现模式、语法参数、配置示例、生产代码范例及库间协作方式。
限制:该工具搜索的是字面代码模式而非关键词,因此“react tutorial”“best practices”“how to use”等关键词或概念式查询效果不佳。详细参数与正则用法见 references/api_reference.md。其他收费、平台支持等信息暂未提供。