pi-reflag

A pi coding agent extension that transparently rewrites grep commands to rg (ripgrep) and find commands to fd before they execute — faster searches with zero agent behavior change.

Install

pi install npm:@piotr-oles/pi-reflag

Requires rg and fd on $PATH:

brew install ripgrep fd      # macOS
apt install ripgrep fd-find  # Debian/Ubuntu

How it works

Intercepts bash tool calls in the tool_call event. When a command segment starts with grep or find (including piped commands), it translates the arguments to their rg/fd equivalents and rewrites the command in place before execution. The agent never sees the rewrite — only a user-visible toast notification is shown.

Subshell constructs ($(…), (…)) are left untouched to avoid misinterpreting nested commands.

grep → rg

What gets translated:

| grep flag | rg equivalent | |---|---| | -r, -R, --recursive | dropped (rg is recursive by default) | | -i, --ignore-case | -i | | -n, --line-number | -n | | -v, --invert-match | -v | | -w, --word-regexp | -w | | -l, --files-with-matches | -l | | -c, --count | -c | | -o, --only-matching | -o | | -E, --extended-regexp | dropped (rg uses ERE by default) | | -G, --basic-regexp | dropped, pattern converted from BRE to ERE | | -F, --fixed-strings | -F | | -P, --perl-regexp | -P | | -A, -B, -C | passed through | | --include=<glob> | -g <glob> | | --exclude=<glob> | -g !<glob> | | --exclude-dir=<dir> | -g !<dir>/ | | -s | --no-messages | | -N (numeric context) | -C N |

Disable per-session:

pi --pi-reflag-grep off

find → fd

What gets translated:

| find expression | fd equivalent | |---|---| | (always) | -H added — fd excludes hidden files by default, find doesn't | | -name <glob> | -g <glob> | | -iname <glob> | -i -g <glob> | | -name a -o -name b | -g {a,b} (brace expansion) | | ! -name <glob> / -not -name <glob> | -E <glob> | | -type f/d/l | -t f/d/l | | -maxdepth N | -d N | | -mindepth N | --min-depth N | | -exec cmd {} \; | -x cmd {} | | -exec cmd {} + | -X cmd {} | | -print0 | -0 | | -print | dropped (fd default) | | -L / -follow | -L | | -path <pat> -prune | -E <pat> (exclude directory) | | -path <pat> | -p <pat> (full-path match) | | -regex <pat> | <pat> (fd regex) | | -iregex <pat> | -i <pat> | | -size <spec> | -S <spec> | | -newer <file> | --newer <file> | | -mtime/-atime/-ctime -N | --changed-within Nd | | -mtime/-atime/-ctime +N | --changed-before Nd | | -mmin/-amin/-cmin -N | --changed-within Nmin | | -mmin/-amin/-cmin +N | --changed-before Nmin | | -user <name> | --owner <name> | | -group <name> | --owner :<name> | | -empty | -t e | | -executable | -t x | | -xdev / -mount | --one-file-system | | -quit | -1 |

Disable per-session:

pi --pi-reflag-find off

Thanks

• ripgrep by Andrew Gallant
• fd by David Peter
• greprip-rs by kaofelix — grep→rg and find→fd translation logic ported from this project (MIT)
• reflag by kluzzebass — additional find→fd flag mappings referenced from this project (MIT)

Development

pnpm install
pnpm test
pnpm typecheck
pnpm check

To test changes manually:

pi -e packages/pi-reflag/src/index.ts