grep-app-cli

CLI for grep.app: search code across 1M+ public GitHub repos with syntax highlighting. Powered by mcp.grep.app.

Quick Start

cargo install grep-app-cli
grep-app-cli 'useState('

Installation

# macOS / Linux
curl --proto '=https' --tlsv1.2 -fsSL https://github.com/sudosubin/grep-app-cli/releases/latest/download/grep-app-cli-installer.sh | sh

# Windows (PowerShell)
powershell -c "irm https://github.com/sudosubin/grep-app-cli/releases/latest/download/grep-app-cli-installer.ps1 | iex"

The installer (generated by cargo-dist) is itself a versioned release asset, not a mutable branch file. It downloads the matching binary from GitHub Releases, verifies its checksum, and installs it to .local/bin under your home directory on every platform. Every release asset, including the installer scripts, carries a GitHub Artifact Attestation; verify one before running it with:

curl --proto '=https' --tlsv1.2 -fsSL -o grep-app-cli-installer.sh https://github.com/sudosubin/grep-app-cli/releases/latest/download/grep-app-cli-installer.sh
gh attestation verify grep-app-cli-installer.sh --repo sudosubin/grep-app-cli
sh grep-app-cli-installer.sh

Set GREP_APP_CLI_INSTALL_DIR to change the install location.

Or install with Homebrew:

brew install sudosubin/tap/grep-app-cli

Or install with Cargo:

cargo install grep-app-cli

Usage

grep-app-cli [OPTIONS] <QUERY>

grep-app-cli 'useState('
grep-app-cli --language TypeScript --language TSX 'getServerSession'
grep-app-cli --use-regexp --match-case '(?s)useEffect\(.*cleanup'
grep-app-cli --repo facebook/react 'createContext'
grep-app-cli --json 'async function'

Options

Flag	Description
--match-case	Case sensitive search
--match-whole-words	Match whole words only
--use-regexp	Interpret query as a regular expression
--repo <REPO>	Filter by repository
--path <PATH>	Filter by file path
--language <LANG>	Filter by language (repeatable)
--json	Output raw JSON

Shell Completions

Generate static completions with completion <shell>.

grep-app-cli completion bash
grep-app-cli completion elvish
grep-app-cli completion fish
grep-app-cli completion powershell
grep-app-cli completion zsh

Use with AI Agents

You can add and use the grep-app-cli skill.

npx skills add sudosubin/grep-app-cli

Development

cargo fmt --all -- --check
cargo clippy --all-targets --all-features -- -D warnings
cargo test --all-features
cargo build --all-features

License

MIT, see LICENSE.