@diegopetrucci/pi-extensions 0.1.5 → 0.1.6

package/README.md

@@ -8,6 +8,7 @@ A collection of [pi](https://github.com/badlogic/pi-mono) agent extensions I mad
 |---|---|
 | [`minimal-footer`](./extensions/minimal-footer) | Replaces pi's built-in footer with a minimal two-line layout: branch/repo on the first line, context/model on the second. |
 | [`oracle`](./extensions/oracle) | Adds an Amp-style read-only oracle tool that auto-selects the strongest reasoning model on the current provider/subscription, covers pi’s built-in providers with hardcoded rankings, sets reasoning to xhigh by default, and shows live status while running. |
+| [`permission-gate`](./extensions/permission-gate) | Prompts for confirmation before dangerous bash commands like `rm -rf`, `sudo`, and `chmod 777`. |
 
 ## Install
 
@@ -22,7 +23,7 @@ pi install git:github.com/diegopetrucci/pi-extensions
 Or pin to a tagged version:
 
 ```bash
-pi install git:github.com/diegopetrucci/pi-extensions@v0.1.5
+pi install git:github.com/diegopetrucci/pi-extensions@v0.1.6
 ```
 
 ### npm
@@ -53,6 +54,10 @@ pi install npm:@diegopetrucci/pi-minimal-footer
 pi install npm:@diegopetrucci/pi-oracle
 ```
 
+```bash
+pi install npm:@diegopetrucci/pi-permission-gate
+```
+
 ### Option 2: filter the repo package
 
 If you prefer the collection package, you can filter it in your pi settings.
@@ -83,25 +88,22 @@ Oracle only:
 }
 ```
 
+Permission gate only:
+
+```json
+{
+  "packages": [
+    {
+      "source": "npm:@diegopetrucci/pi-extensions",
+      "extensions": ["extensions/permission-gate/index.ts"]
+    }
+  ]
+}
+```
+
 ## npm publishing
 
 The repo is set up to support both:
 
 - the collection package: `@diegopetrucci/pi-extensions`
-- standalone extension packages like `@diegopetrucci/pi-minimal-footer`
-
-## Repository structure
-
-Each extension lives in its own subdirectory under [`extensions/`](./extensions). This keeps the repo easy to grow while still letting each extension carry its own package metadata and documentation.
-
-## Oracle docs
-
-- [Oracle provider matrix](./docs/oracle-provider-matrix.md)
-- [Release notes for v0.1.5](./docs/release-notes-v0.1.5.md)
-- [GitHub release body for v0.1.5](./docs/github-release-v0.1.5.md)
-- [Publish checklist for v0.1.5](./docs/publish-checklist-v0.1.5.md)
-- [Announcement copy for v0.1.5](./docs/announcement-v0.1.5.md)
-
-## License
-
-[MIT](./LICENSE)
+- standalone extension packages like `@diegopetrucci/pi-minimal-footer`, `@diegopetrucci/pi-oracle`, and `@diegopetrucci/pi-permission-gate`

package/extensions/permission-gate/README.md

@@ -0,0 +1,45 @@
+# permission-gate
+
+A small pi extension that prompts for confirmation before running potentially dangerous bash commands.
+
+This is adapted from the original `permission-gate.ts` example in [`badlogic/pi-mono`](https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/examples/extensions/permission-gate.ts) and kept basically the same.
+
+## What it checks
+
+- `rm -rf`
+- `sudo`
+- `chmod` / `chown` with `777`
+
+If pi is running without an interactive UI, it blocks matching commands by default.
+
+## Install
+
+### Standalone npm package
+
+```bash
+pi install npm:@diegopetrucci/pi-permission-gate
+```
+
+### Collection package
+
+```bash
+pi install npm:@diegopetrucci/pi-extensions
+```
+
+### GitHub package
+
+```bash
+pi install git:github.com/diegopetrucci/pi-extensions
+```
+
+Then reload pi:
+
+```text
+/reload
+```
+
+## Notes
+
+- Hooks the `tool_call` event.
+- Only inspects the `bash` tool.
+- Prompts with a simple `Yes` / `No` selector before allowing dangerous commands.

package/extensions/permission-gate/index.ts

@@ -0,0 +1,34 @@
+/**
+ * Permission Gate Extension
+ *
+ * Prompts for confirmation before running potentially dangerous bash commands.
+ * Patterns checked: rm -rf, sudo, chmod/chown 777
+ */
+
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+
+export default function (pi: ExtensionAPI) {
+	const dangerousPatterns = [/\brm\s+(-rf?|--recursive)/i, /\bsudo\b/i, /\b(chmod|chown)\b.*777/i];
+
+	pi.on("tool_call", async (event, ctx) => {
+		if (event.toolName !== "bash") return undefined;
+
+		const command = event.input.command as string;
+		const isDangerous = dangerousPatterns.some((p) => p.test(command));
+
+		if (isDangerous) {
+			if (!ctx.hasUI) {
+				// In non-interactive mode, block by default
+				return { block: true, reason: "Dangerous command blocked (no UI for confirmation)" };
+			}
+
+			const choice = await ctx.ui.select(`⚠️ Dangerous command:\n\n  ${command}\n\nAllow?`, ["Yes", "No"]);
+
+			if (choice !== "Yes") {
+				return { block: true, reason: "Blocked by user" };
+			}
+		}
+
+		return undefined;
+	});
+}

package/extensions/permission-gate/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@diegopetrucci/pi-permission-gate",
+  "version": "0.1.0",
+  "description": "A pi extension that prompts before dangerous bash commands.",
+  "keywords": ["pi-package", "pi", "security", "bash"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/diegopetrucci/pi-extensions.git",
+    "directory": "extensions/permission-gate"
+  },
+  "files": [
+    "index.ts",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "pi": {
+    "extensions": [
+      "index.ts"
+    ]
+  },
+  "peerDependencies": {
+    "@mariozechner/pi-coding-agent": "*"
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@diegopetrucci/pi-extensions",
-  "version": "0.1.5",
-  "description": "A collection of pi extensions, including a minimal custom footer and an Amp-style oracle.",
+  "version": "0.1.6",
+  "description": "A collection of pi extensions, including a minimal custom footer, an Amp-style oracle, and a permission gate for dangerous bash commands.",
   "keywords": ["pi-package", "pi", "terminal", "agent"],
   "license": "MIT",
   "repository": {
@@ -27,7 +27,8 @@
   "pi": {
     "extensions": [
       "./extensions/minimal-footer/index.ts",
-      "./extensions/oracle/index.ts"
+      "./extensions/oracle/index.ts",
+      "./extensions/permission-gate/index.ts"
     ],
     "image": "https://raw.githubusercontent.com/diegopetrucci/pi-extensions/main/assets/oracle-preview.svg"
   }