pi-rg-fd 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Li Tianyu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,65 @@
-# Temporary Holding Version
+# pi-rg-fd
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Pi coding agent extension that always rewrites the default system prompt's `grep` and `find` advice to `rg` and `fd`.
+
+Pi 1.4's bash tool line names `grep` and `find`, and the default guideline still names `find`, so models reach for those commands. This package replaces those two exact lines in place. The usual prompt gets shorter, and text that is not one of those Pi 1.4 lines is left as Pi wrote it. You confirm that `rg` and `fd` run on your machine.
+
+## Install
+
+```bash
+pi install npm:pi-rg-fd
+```
+
+For one session without saving the install: `pi -e npm:pi-rg-fd`.
+
+Requires [Pi](https://github.com/earendil-works/pi) 1.4.x (`@earendil-works/pi-coding-agent`).
+
+## Replaced lines
+
+Verified against the published `@earendil-works/pi-coding-agent@1.4.0` sources (`dist/core/tools/bash.js` and `dist/core/system-prompt.js`). These are the only default prompt lines that name the `grep` or `find` commands. The read, edit, write, and ls tool snippets do not. The optional `grep` and `find` tools are separate Pi tools (they already shell out to `rg` and `fd`); their lines are left alone.
+
+Bash tool snippet, before:
+
+```text
+Execute bash commands (ls, grep, find, etc.)
+```
+
+Default guideline (bash enabled, and the grep/find/ls tools off), before:
+
+```text
+Use bash for file operations like ls, rg, find
+```
+
+Those lines are always rewritten to:
+
+```text
+Execute bash commands (ls, rg, fd, etc.)
+Use bash for file operations like ls, rg, fd
+```
+
+`rg` and `fd` are shorter than `grep` and `find`. If neither line is present (a custom system prompt, or a future Pi release that rewords them), the hook returns without changing the prompt. The `before_agent_start` hook is a string replace cached by the prompt text, so the same input always yields the same output.
+
+Pi's interactive mode downloads `rg` and `fd` when they are missing, into `~/.pi/agent/bin` (or `$PI_CODING_AGENT_DIR/bin` when that variable is set; a leading `~` is expanded). Bash calls see that directory on `PATH`. The managed files are named `rg` and `fd`, plus `.exe` on Windows.
+
+Debian and Ubuntu's apt package `fd-find` installs the binary as `fdfind`. Alias it so the rewritten prompt matches a command on `PATH`:
+
+```bash
+alias fd=fdfind
+```
+
+## Prompt text only
+
+`pi-cli-guard` and `pi-prefer-rg` rewrite or block bash commands when the model runs them. `pi-rg-fd` edits the system prompt Pi already built. Commands the model still emits run unchanged.
+
+## Compatibility
+
+With `@earendil-works/pi-coding-agent` installed, `npm run compat` builds Pi's default system prompt from that package and loads this extension through Pi's extension loader. CI runs the same check on Ubuntu and Windows against the latest Pi release, every day and on manual dispatch.
+
+```bash
+npm install --no-save @earendil-works/pi-coding-agent@latest
+npm run compat
+```
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,29 @@
+import { rewritePrompt } from "./prompt.js";
+
+const CACHE_LIMIT = 8;
+
+export function createExtension() {
+	/** @type {Map<string, string>} */
+	const cache = new Map();
+
+	return function piRgFd(pi) {
+		pi.on("before_agent_start", (event) => {
+			const input = event.systemPrompt;
+			if (typeof input !== "string") return;
+
+			let output = cache.get(input);
+			if (output !== undefined) {
+				cache.delete(input);
+				cache.set(input, output);
+			} else {
+				output = rewritePrompt(input);
+				cache.set(input, output);
+				if (cache.size > CACHE_LIMIT) cache.delete(cache.keys().next().value);
+			}
+
+			if (output !== input) return { systemPrompt: output };
+		});
+	};
+}
+
+export default createExtension();

package/package.json

@@ -1,6 +1,42 @@
 {
   "name": "pi-rg-fd",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Pi extension that rewrites the default grep/find prompt lines to rg and fd.",
+  "type": "module",
+  "main": "index.js",
+  "license": "MIT",
+  "author": "Li Tianyu",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "extension",
+    "ripgrep",
+    "fd"
+  ],
+  "files": [
+    "index.js",
+    "prompt.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TomXPRIME/pi-rg-fd.git"
+  },
+  "homepage": "https://github.com/TomXPRIME/pi-rg-fd",
+  "bugs": {
+    "url": "https://github.com/TomXPRIME/pi-rg-fd/issues"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "scripts": {
+    "test": "node --test",
+    "compat": "node scripts/compat.js"
+  },
+  "pi": {
+    "extensions": [
+      "./index.js"
+    ]
+  }
+}

package/prompt.js

@@ -0,0 +1,36 @@
+/**
+ * Default bash tool line in @earendil-works/pi-coding-agent 1.4.0
+ * (`bashToolSystemPromptContribution.snippet`).
+ */
+export const BASH_SNIPPET = "Execute bash commands (ls, grep, find, etc.)";
+
+/**
+ * Default guideline in Pi 1.4.0 when bash is enabled and the grep, find, and
+ * ls tools are not (`buildRules` in `system-prompt.js`).
+ */
+export const BASH_RULE = "Use bash for file operations like ls, rg, find";
+
+const REWRITTEN_SNIPPET = "Execute bash commands (ls, rg, fd, etc.)";
+const REWRITTEN_RULE = "Use bash for file operations like ls, rg, fd";
+
+/**
+ * @param {string} text
+ * @param {string} from
+ * @param {string} to
+ */
+function replaceExact(text, from, to) {
+	if (from === to || !text.includes(from)) return text;
+	return text.replaceAll(from, to);
+}
+
+/**
+ * Replace Pi's default grep/find lines in place. Unknown text is returned
+ * unchanged (same string when nothing matches).
+ *
+ * @param {string} prompt
+ */
+export function rewritePrompt(prompt) {
+	let next = replaceExact(prompt, BASH_SNIPPET, REWRITTEN_SNIPPET);
+	next = replaceExact(next, BASH_RULE, REWRITTEN_RULE);
+	return next;
+}