@ladbabynpm/picc-grep

Claude Code style Grep (content search) tool for pi — a faithful port backed by ripgrep.

Packages

Package details

extension

Install @ladbabynpm/picc-grep from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@ladbabynpm/picc-grep
Package
@ladbabynpm/picc-grep
Version
0.1.2
Published
Oct 22, 2026
Downloads
277/mo · 12/wk
Author
ladbabynpm
License
MIT
Types
extension
Size
39.6 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

picc-grep

npm downloads

Claude Code style Grep (content search) tool for pi — a faithful port of Claude Code's Grep tool, backed by ripgrep.

Part of picc, a pi agent setup mirroring Claude Code's harness.

pi's built-in grep always uses --json content mode, has no output modes and no multiline support. This extension replicates Claude Code's Grep exactly: three output modes, rich flags, and head_limit/offset pagination.

Usage

Install via pi install npm:@ladbabynpm/picc-grep.

Tool

  • Name: grep (default) or Grep — configurable (see below).
  • Parameters: pattern (required), plus path, glob, type, output_mode (content | files_with_matches (default) | count), -A, -B, -C, context, -n, -i, -o, head_limit, offset, multiline.
  • Behavior: exact Claude Code arg order (--hidden, VCS-dir excludes, --max-columns 500, mode flags, pattern, --type, --glob), per-mode result templates, path relativization against cwd, and head_limit (default 250, 0 = unlimited) + offset pagination.
  • Tool-result text matches Claude Code byte-for-byte. Content mode rewrites the path in place on every ripgrep line — relpath:num:content for a match, relpath-num-content for a context line, -- group separators preserved — so no file-header line is inserted. files_with_matches reports Found N files limit: N, and count reports Found N total occurrences across M files. (including for zero matches). A missing path fails with Path does not exist: <path>. Note: your current working directory is <cwd>., plus a Did you mean <path>? hint when the same relative path exists under cwd.
  • Deliberate deviations from the live Claude Code source:
    • the -o (only-matching) parameter is an extension — it is in the local Grep_schema.json but not in Claude Code's live source. In content mode it maps to rg -o / --only-matching.
    • the path/content boundary is verified against the filesystem, so a :N: inside content or a Windows drive letter cannot be mistaken for the boundary.
    • permission-based read-ignore patterns (getFileReadIgnorePatterns) and orphaned plugin-cache exclusions (getGlobExclusionsForPluginCache) are omitted — they have no pi equivalent (same as picc-glob).
  • Requires rg (ripgrep) on PATH.

Configuration

Setting Where Values Default
toolName config.json "grep" | "Grep" "grep"
PICC_GREP_TOOL_NAME env "grep" | "Grep" —
PICC_GREP_CONFIG_PATH env absolute path to a config.json sibling of index.ts

Precedence for the tool name: PICC_GREP_TOOL_NAME env > config.json > "grep".

config.json is read from ~/.pi/agent/extensions/picc-grep/config.json by default.

{ "toolName": "grep" }

Development

  • npm run lint — biome check
  • npm run lint:fix — biome check --write
  • npm run typecheck — tsc --noEmit

No any; top-level imports only; strict TypeScript (ES2022, bundler resolution). Dependencies beyond node:* are limited to typebox and @earendil-works/pi-coding-agent (both bundled with pi).