How do I install the Grep App skill?

Run npx skillmds@latest add jal-co/grep-app in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Grep App safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Grep App?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Grep App free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Grep App?

jal-co (@jal-co) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Grep App by jal-co — Agent Skill

Name: Grep App
Author: jal-co

Grep App

Search for real-world code examples across a million GitHub repositories. Use when you need to find actual code patterns, library usage examples, or implementation patterns. Triggers include "search GitHub for", "find code examples of", "how do developers use", "show real-world usage of", or any need to see production code patterns.

jal-co 8b7a7d9 2 files · 1.2 MB Updated Sep 17, 2026

File contents

grep_app

CLI generated from the grep_app MCP server via MCPorter.

Search over a million public GitHub repositories to find real-world code examples and usage patterns.

Setup

No authentication required. The tool connects to the public grep.app service.

Usage

The CLI is located at ~/.pi/agent/skills/grep_app/grep_app.js and requires bun to run.

Basic Search

Search for literal code patterns (like grep):

bun ~/.pi/agent/skills/grep_app/grep_app.js searchGitHub --query "useState("

Search with Language Filter

Find TypeScript examples:

bun ~/.pi/agent/skills/grep_app/grep_app.js searchGitHub \
  --query "getServerSession" \
  --language "TypeScript,TSX"

Case-Sensitive Search

bun ~/.pi/agent/skills/grep_app/grep_app.js searchGitHub \
  --query "CORS(" \
  --match-case true \
  --language "Python"

Regular Expression Search

Search across multiple lines using regex:

bun ~/.pi/agent/skills/grep_app/grep_app.js searchGitHub \
  --query "(?s)useEffect\(\(\) => {.*removeEventListener" \
  --use-regexp true

Filter by Repository

Search within specific repos:

bun ~/.pi/agent/skills/grep_app/grep_app.js searchGitHub \
  --query "ErrorBoundary" \
  --repo "vercel/"

Filter by File Path

Search in specific file paths:

bun ~/.pi/agent/skills/grep_app/grep_app.js searchGitHub \
  --query "export default" \
  --path "route.ts"

JSON Output

Get structured output for parsing:

bun ~/.pi/agent/skills/grep_app/grep_app.js searchGitHub \
  --query "async function" \
  --output json

Tools

searchGitHub

Find real-world code examples from over a million public GitHub repositories.

Parameters:

--query <string> (required) - The literal code pattern to search for (e.g., 'useState(', 'import React from', 'async function')
--match-case <boolean> (optional) - Whether the search should be case sensitive
--match-whole-words <boolean> (optional) - Whether to match whole words only
--use-regexp <boolean> (optional) - Whether to interpret the query as a regular expression
--repo <string> (optional) - Filter by repository (e.g., 'facebook/react', 'vercel/')
--path <string> (optional) - Filter by file path (e.g., 'src/components/Button.tsx', '/route.ts')
--language <string> (optional) - Filter by programming language (comma-separated: 'TypeScript,TSX', 'JavaScript', 'Python', etc.)

Important Usage Notes:

✅ Good queries (literal code patterns):

'useState('
'import React from'
'async function'
'(?s)try {.*await' (regex)

❌ Bad queries (keywords/questions):

'react tutorial'
'best practices'
'how to use'

When to use:

Implementing unfamiliar APIs or libraries
Finding real usage patterns and syntax
Looking for production-ready examples
Understanding how libraries work together

Regex patterns:

Use --use-regexp true for flexible patterns
Prefix with (?s) to match across multiple lines
Example: '(?s)useState\(.*loading' finds useState hooks with loading variables

Output formats:

--output text (default) - Human-readable
--output markdown - Formatted markdown
--output json - Structured JSON
--output raw - Raw MCP response

---name: grep-appdescription: Search for real-world code examples across a million GitHub repositories. Use when you need to find actual code patterns, library usage examples, or implementation patterns. Triggers include "search GitHub for", "find code examples of", "how do developers use", "show real-world usage of", or any need to see production code patterns.---# grep_appCLI generated from the grep_app MCP server via [MCPorter](https://github.com/steipete/mcporter).Search over a million public GitHub repositories to find real-world code examples and usage patterns.## SetupNo authentication required. The tool connects to the public grep.app service.## UsageThe CLI is located at `~/.pi/agent/skills/grep_app/grep_app.js` and requires `bun` to run.### Basic SearchSearch for literal code patterns (like grep):```bashbun ~/.pi/agent/skills/grep_app/grep_app.js searchGitHub --query "useState("```### Search with Language FilterFind TypeScript examples:```bashbun ~/.pi/agent/skills/grep_app/grep_app.js searchGitHub \ --query "getServerSession" \ --language "TypeScript,TSX"```### Case-Sensitive Search```bashbun ~/.pi/agent/skills/grep_app/grep_app.js searchGitHub \ --query "CORS(" \ --match-case true \ --language "Python"```### Regular Expression SearchSearch across multiple lines using regex:```bashbun ~/.pi/agent/skills/grep_app/grep_app.js searchGitHub \ --query "(?s)useEffect\(\(\) => {.*removeEventListener" \ --use-regexp true```### Filter by RepositorySearch within specific repos:```bashbun ~/.pi/agent/skills/grep_app/grep_app.js searchGitHub \ --query "ErrorBoundary" \ --repo "vercel/"```### Filter by File PathSearch in specific file paths:```bashbun ~/.pi/agent/skills/grep_app/grep_app.js searchGitHub \ --query "export default" \ --path "route.ts"```### JSON OutputGet structured output for parsing:```bashbun ~/.pi/agent/skills/grep_app/grep_app.js searchGitHub \ --query "async function" \ --output json```## Tools### searchGitHubFind real-world code examples from over a million public GitHub repositories.**Parameters:**- `--query <string>` (required) - The literal code pattern to search for (e.g., 'useState(', 'import React from', 'async function')- `--match-case <boolean>` (optional) - Whether the search should be case sensitive- `--match-whole-words <boolean>` (optional) - Whether to match whole words only- `--use-regexp <boolean>` (optional) - Whether to interpret the query as a regular expression- `--repo <string>` (optional) - Filter by repository (e.g., 'facebook/react', 'vercel/')- `--path <string>` (optional) - Filter by file path (e.g., 'src/components/Button.tsx', '/route.ts')- `--language <string>` (optional) - Filter by programming language (comma-separated: 'TypeScript,TSX', 'JavaScript', 'Python', etc.)**Important Usage Notes:**✅ **Good queries** (literal code patterns):- `'useState('`- `'import React from'`- `'async function'`- `'(?s)try {.*await'` (regex)❌ **Bad queries** (keywords/questions):- `'react tutorial'`- `'best practices'`- `'how to use'`**When to use:**- Implementing unfamiliar APIs or libraries- Finding real usage patterns and syntax- Looking for production-ready examples- Understanding how libraries work together**Regex patterns:**- Use `--use-regexp true` for flexible patterns- Prefix with `(?s)` to match across multiple lines- Example: `'(?s)useState\(.*loading'` finds useState hooks with loading variables**Output formats:**- `--output text` (default) - Human-readable- `--output markdown` - Formatted markdown- `--output json` - Structured JSON- `--output raw` - Raw MCP response

Frequently asked questions