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