Greprip

greprip

Transparent drop-in replacements for `grep` and `find` that use the faster Rust alternatives (`rg` and `fd`).

Goal

LLM coding agents like [Pi](https://pi.dev) default to using `grep` and `find` because they're universal POSIX tools. But modern Rust alternatives like `ripgrep` and `fd` are significantly faster.

**greprip** solves this by providing `grg` and `fnd` commands that:

1. Accept grep/find syntax
2. Translate arguments to rg/fd equivalents
3. Execute the faster tool transparently

This gives you the speed benefits of modern tools without requiring the LLM to know about them.

Setup with Pi

1. Install dependencies

# Install rg and fd (macOS)
brew install ripgrep fd

# Install greprip
uv tool install git+https://github.com/kaofelix/greprip

2. Configure Pi

Add to `~/.pi/agent/settings.json`:

{
  "shellCommandPrefix": "grep() { grg \"$@\"; }; find() { fnd \"$@\"; };"
}

3. Restart Pi

Start a new session. Now when the agent runs `grep` or `find`, it transparently uses `rg`/`fd`.

Verify it's working:

type grep   # Should show: grep is a function
grep --version  # Should show: ripgrep X.X.X

Supported Flags

grg (grep → rg)

Category	Flags
Basic	-i, -n, -v, -w, -l, -c, -o, -h, -H
Recursive	-r, -R (dropped - rg default)
Regex	-E (dropped - rg default), -F, -P
Context	-A NUM, -B NUM, -C NUM, -NUM
Patterns	-e PATTERN, -f FILE
Filters	--include=, --exclude=, --exclude-dir=
Output	--color, -q, -s

fnd (find → fd)

Category	Options
Name	-name, -iname
Type	-type f/d/l
Depth	-maxdepth, -mindepth
Output	-print, -print0
Exclude	! -name, -path ... -prune
Execute	-exec {} \;, -exec {} +
Symlinks	-L

Direct Usage

Without Pi integration, you can use the tools directly:

`