grepwrapper

Tiny TypeScript CLI wrapper for https://grep.app/api/search with TypeBox-validated responses.

Install

1) Global install (npm)

npm i -g grepwrapper

Then run:

grepwrapper search --q "QMD"

2) One-shot via bunx

bunx grepwrapper search --q "QMD"

3) Local dev

bun install
bun run build
npm link
grepwrapper search --q "QMD"

Usage

grepwrapper search --q "QMD - Query Markup Document"
grepwrapper search --q "QMD" --words --page 2
grepwrapper search --q "QMD" --regexp
grepwrapper search --q "QMD - Query Markup Documen" --case

Output example:

time=21ms total=2 returned=2
- tobi/qmd:CLAUDE.md (matches=1)
- tobi/qmd:README.md (matches=1)

Standalone binaries (GitHub Actions)

Workflow: .github/workflows/build-binaries.yml

• Builds standalone binaries for Linux, macOS, and Windows using bun build --compile
• Uploads per-platform artifacts on each run

Project structure

• src/types.ts — TypeBox schemas + TS types for API response
• src/api.ts — URL builder + fetch + schema validation
• src/cli.ts — command parser and human output