no-find-grep

no-find-grep

A Claude Code plugin that blocks bare find/grep in Bash calls and detects common rg flag misuse.

Shell file-read and file-edit enforcement has moved to the sibling plugin: no-shell-file-ops — blocks sed, cat, xxd, od, sd, python -c file operations and provides Edit tool stale-string hints.

What it does

Registers a PreToolUse hook that intercepts every Bash command before execution. It detects and blocks:

Pattern	Why	Example
Bare find	Use fd (or fdfind on Debian/Ubuntu) instead	find . -name '*.txt'
Bare grep	Use rg instead	grep -rn 'pattern' .
rg with -r<letter> (scoped to rg's own flags)	-r means --replace in rg, not --recursive. The letter becomes replacement text. rg is recursive by default. Only flags on the rg command itself are checked — other commands' -r flags in a pipeline are ignored.	rg -rn 'pattern' . → replaces matches with "n"
rg with standalone -L	-L means --follow in rg, not --files-without-match in grep	rg -L 'pattern' .
rg with |	rg uses `	for alternation,|` matches a literal pipe

When a match is found, the hook prints a diagnostic message to stderr and exits with code 2, preventing the command from running.

At session end (or /clear), the plugin reports how many commands were blocked.

Why CLAUDE.md wasn't enough

My global CLAUDE.md already says:

Always use fd and rg over find and grep.

But Claude Code doesn't always read or follow instructions consistently — it falls back to find/grep out of habit, and often uses grep flags with rg. A hook enforces the rule at the tool level, every time, with no exceptions. There's no "I didn't read the instructions" loophole.

Install

Install via the marketplace:

TonyWu20/my-claude-marketplace

Or manually, register the plugin in your Claude Code settings:

{
  "plugins": {
    "no-find-grep": {
      "path": "/path/to/no-find-grep"
    }
  }
}

Files

File	Purpose
hooks/hooks.json	Hook registration — intercepts Bash tool calls
hooks/block-find-grep.sh	Shell script that blocks find/grep misuse, rg flag misuse
hooks/session-end.sh	Shell script that reports blocked-command count on session exit and /clear

Compatible with Linux and macOS. Locking uses mkdir-based mutex (no flock dependency).