@sreetej510/pi-prompt-manager 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 omega
+
+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

@@ -0,0 +1,74 @@
+# @sreetej510/pi-prompt-manager
+
+A [pi](https://github.com/earendil-works/pi) coding agent extension to quickly save, manage,
+and paste reusable prompts without retyping them.
+
+## Commands
+
+| Command | Effect |
+|---|---|
+| `/prompt` | Open the prompt manager (select · edit · delete · add) |
+| `/prompt add [name]` | Create a new saved prompt directly (opens a multi-line editor) |
+
+## Keyboard shortcuts (inside `/prompt`)
+
+| Key | Action |
+|---|---|
+| `↑` / `↓` / `j` / `k` | Navigate the list |
+| `Enter` | Paste the selected prompt into the editor |
+| `e` | Edit the selected prompt |
+| `d` | Delete the selected prompt (with confirmation) |
+| `a` | Add a new prompt |
+| `Esc` | Close without action |
+
+## Storage
+
+Saved prompts are stored as JSON at `<pi-agent-dir>/prompt-manager.json`:
+
+```json
+{
+  "prompts": [
+    { "id": "...", "name": "...", "content": "...", "createdAt": 0, "updatedAt": 0 }
+  ]
+}
+```
+
+## Install
+
+```bash
+npm install -g @sreetej510/pi-prompt-manager
+```
+
+Then add it to your pi `settings.json`:
+
+```json
+{
+  "packages": ["npm:@sreetej510/pi-prompt-manager"]
+}
+```
+
+Or, for local development, point at the file directly:
+
+```json
+{
+  "extensions": ["/absolute/path/to/pi-extensions/extensions/pi-prompt-manager/src/index.ts"]
+}
+```
+
+## File layout
+
+| File | Responsibility |
+|---|---|
+| `src/index.ts` | Extension entry point |
+| `src/command.ts` | `/prompt` command handler + add/edit/delete flow |
+| `src/component.ts` | List-manager TUI component |
+| `src/storage.ts` | `prompt-manager.json` load/save helpers |
+| `src/types.ts` | Shared TypeScript types |
+
+## Development
+
+```bash
+npm install
+npm run --workspace @sreetej510/pi-prompt-manager check     # biome + typecheck
+npm run --workspace @sreetej510/pi-prompt-manager format
+```

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@sreetej510/pi-prompt-manager",
+  "version": "0.1.1",
+  "description": "Pi extension to quickly save, manage, and paste reusable prompts without retyping.",
+  "type": "module",
+  "license": "MIT",
+  "private": false,
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "pi",
+    "prompts",
+    "snippets"
+  ],
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "pi": {
+    "extensions": [
+      "./src/index.ts"
+    ]
+  },
+  "scripts": {
+    "check": "biome check . && npm run typecheck",
+    "format": "biome check --write .",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.3",
+    "@earendil-works/pi-coding-agent": "^0.80.3",
+    "@earendil-works/pi-tui": "^0.80.3",
+    "typescript": "^5.7.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Sreetej510/pi-extensions",
+    "directory": "extensions/pi-prompt-manager"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/command.ts

@@ -0,0 +1,137 @@
+import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import { PromptManagerComponent } from "./component.js";
+import { loadPrompts, newId, savePrompts } from "./storage.js";
+import type { ListResult } from "./types.js";
+
+type PromptUi = ExtensionCommandContext["ui"];
+
+async function addPrompt(ui: PromptUi, nameHint?: string): Promise<void> {
+  let name = nameHint?.trim();
+
+  if (!name) {
+    const entered = await ui.input("Prompt name:", "e.g. Code Review Template");
+    if (!entered?.trim()) {
+      ui.notify("Cancelled — no name given.", "info");
+      return;
+    }
+    name = entered.trim();
+  }
+
+  const content = await ui.editor(`New prompt: ${name}`, "");
+  if (!content?.trim()) {
+    ui.notify("Cancelled — empty content not saved.", "info");
+    return;
+  }
+
+  const all = await loadPrompts();
+  const existIdx = all.findIndex((p) => p.name.toLowerCase() === name!.toLowerCase());
+
+  if (existIdx >= 0) {
+    const ok = await ui.confirm("Name already exists", `A prompt named "${name}" already exists. Overwrite it?`);
+    if (!ok) return;
+    all[existIdx] = {
+      ...all[existIdx]!,
+      content: content.trim(),
+      updatedAt: Date.now(),
+    };
+  } else {
+    const now = Date.now();
+    all.push({
+      id: newId(),
+      name,
+      content: content.trim(),
+      createdAt: now,
+      updatedAt: now,
+    });
+  }
+
+  await savePrompts(all);
+  ui.notify(`Prompt "${name}" saved.`, "info");
+}
+
+export function registerPromptCommand(pi: ExtensionAPI): void {
+  pi.registerCommand("prompt", {
+    description: "Manage saved prompts — /prompt | /prompt add [name]",
+
+    getArgumentCompletions: (prefix) => {
+      const opts = [{ value: "add", label: "add — create a new prompt" }];
+      const filtered = opts.filter((o) => o.value.startsWith(prefix));
+      return filtered.length > 0 ? filtered : null;
+    },
+
+    handler: async (args, ctx) => {
+      if (ctx.mode !== "tui") {
+        ctx.ui.notify("/prompt requires interactive mode", "error");
+        return;
+      }
+
+      const ui = ctx.ui;
+      const parts = args.trim().split(/\s+/).filter(Boolean);
+      const sub = parts[0] ?? "";
+
+      if (sub === "add") {
+        const nameArg = parts.slice(1).join(" ") || undefined;
+        await addPrompt(ui, nameArg);
+        return;
+      }
+
+      if (sub !== "") {
+        ui.notify("Usage: /prompt  |  /prompt add [name]", "warning");
+        return;
+      }
+
+      let all = await loadPrompts();
+      let sel = 0;
+
+      for (;;) {
+        const r = await ui.custom<ListResult>(
+          (_tui, theme, _kb, done) => new PromptManagerComponent(all, sel, theme, done),
+        );
+
+        if (!r || r.action === "close") break;
+
+        if (r.action === "paste") {
+          const p = all[r.index];
+          if (p) ui.pasteToEditor(p.content);
+          break;
+        }
+
+        if (r.action === "add") {
+          await addPrompt(ui);
+          all = await loadPrompts();
+          continue;
+        }
+
+        if (r.action === "edit") {
+          sel = r.index;
+          const p = all[r.index];
+          if (!p) continue;
+          const txt = await ui.editor(`Edit: ${p.name}`, p.content);
+          if (txt?.trim()) {
+            all[r.index] = {
+              ...p,
+              content: txt.trim(),
+              updatedAt: Date.now(),
+            };
+            await savePrompts(all);
+            ui.notify(`"${p.name}" updated.`, "info");
+          }
+          continue;
+        }
+
+        if (r.action === "delete") {
+          sel = r.index;
+          const p = all[r.index];
+          if (!p) continue;
+          const ok = await ui.confirm("Delete prompt", `Delete "${p.name}"? This cannot be undone.`);
+          if (ok) {
+            all = all.filter((_, i) => i !== r.index);
+            sel = Math.max(0, sel - 1);
+            await savePrompts(all);
+            ui.notify(`"${p.name}" deleted.`, "info");
+          }
+        }
+      }
+    },
+  });
+}

package/src/component.ts

@@ -0,0 +1,130 @@
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import { matchesKey, truncateToWidth } from "@earendil-works/pi-tui";
+import type { ListResult, SavedPrompt } from "./types.js";
+
+export class PromptManagerComponent {
+  private selectedIndex: number;
+  private cache?: { w: number; lines: string[] };
+
+  constructor(
+    private prompts: SavedPrompt[],
+    initialIndex: number,
+    private theme: Theme,
+    private done: (result: ListResult) => void,
+  ) {
+    this.selectedIndex = prompts.length > 0 ? Math.max(0, Math.min(initialIndex, prompts.length - 1)) : 0;
+  }
+
+  handleInput(data: string): void {
+    const n = this.prompts.length;
+
+    if (matchesKey(data, "up") || data === "k") {
+      if (this.selectedIndex > 0) {
+        this.selectedIndex--;
+        this.invalidate();
+      }
+      return;
+    }
+    if (matchesKey(data, "down") || data === "j") {
+      if (this.selectedIndex < n - 1) {
+        this.selectedIndex++;
+        this.invalidate();
+      }
+      return;
+    }
+
+    if (matchesKey(data, "enter") && n > 0) {
+      this.done({ action: "paste", index: this.selectedIndex });
+      return;
+    }
+    if ((data === "e" || data === "E") && n > 0) {
+      this.done({ action: "edit", index: this.selectedIndex });
+      return;
+    }
+    if ((data === "d" || data === "D") && n > 0) {
+      this.done({ action: "delete", index: this.selectedIndex });
+      return;
+    }
+    if (data === "a" || data === "A") {
+      this.done({ action: "add" });
+      return;
+    }
+    if (matchesKey(data, "escape") || matchesKey(data, "ctrl+c")) {
+      this.done({ action: "close" });
+      return;
+    }
+  }
+
+  render(width: number): string[] {
+    if (this.cache?.w === width) return this.cache.lines;
+
+    const th = this.theme;
+    const lines: string[] = [];
+
+    const TITLE = " Prompt Manager ";
+    const rightDashes = Math.max(0, width - TITLE.length - 3);
+    lines.push(
+      truncateToWidth(
+        th.fg("borderMuted", "─".repeat(3)) + th.fg("accent", TITLE) + th.fg("borderMuted", "─".repeat(rightDashes)),
+        width,
+      ),
+    );
+    lines.push("");
+
+    if (this.prompts.length === 0) {
+      lines.push(truncateToWidth("  " + th.fg("dim", "No prompts saved yet. Press [a] to add one."), width));
+    } else {
+      const MAX_VISIBLE = 10;
+      const half = Math.floor(MAX_VISIBLE / 2);
+      const start = Math.max(0, Math.min(this.selectedIndex - half, this.prompts.length - MAX_VISIBLE));
+      const end = Math.min(this.prompts.length, start + MAX_VISIBLE);
+
+      if (start > 0) {
+        lines.push(truncateToWidth("  " + th.fg("dim", `↑ ${start} more above`), width));
+      }
+
+      for (let i = start; i < end; i++) {
+        const p = this.prompts[i]!;
+        const isSel = i === this.selectedIndex;
+
+        const arrow = isSel ? th.fg("accent", "❯ ") : "  ";
+        const nameStyled = isSel ? th.fg("text", th.bold(p.name)) : th.fg("muted", p.name);
+
+        let row = arrow + nameStyled;
+
+        if (isSel && p.content) {
+          const firstLine = p.content.split("\n")[0]?.trim() ?? "";
+          if (firstLine) {
+            const avail = width - 2 - p.name.length - 4;
+            if (avail > 8) {
+              const preview = firstLine.length > avail ? firstLine.slice(0, avail - 1) + "…" : firstLine;
+              row += "  " + th.fg("dim", preview);
+            }
+          }
+        }
+
+        lines.push(truncateToWidth(row, width));
+      }
+
+      if (end < this.prompts.length) {
+        lines.push(truncateToWidth("  " + th.fg("dim", `↓ ${this.prompts.length - end} more below`), width));
+      }
+    }
+
+    lines.push("");
+
+    const hints =
+      this.prompts.length > 0
+        ? "[↑↓/jk] navigate  [Enter] paste  [e] edit  [d] delete  [a] add  [Esc] close"
+        : "[a] add a new prompt  [Esc] close";
+    lines.push(truncateToWidth("  " + th.fg("dim", hints), width));
+    lines.push("");
+
+    this.cache = { w: width, lines };
+    return lines;
+  }
+
+  invalidate(): void {
+    this.cache = undefined;
+  }
+}

package/src/index.ts

@@ -0,0 +1,25 @@
+/**
+ * Prompt Manager Extension
+ *
+ * Quickly save, manage, and paste reusable prompts without retyping.
+ *
+ * Commands
+ * ────────
+ *   /prompt              Open the prompt manager (select · edit · delete · add)
+ *   /prompt add [name]   Create a new saved prompt directly (opens multi-line editor)
+ *
+ * Storage: <pi-agent-dir>/prompt-manager.json
+ *
+ * File layout:
+ *   index.ts      extension entry point (this file)
+ *   command.ts    /prompt command handler
+ *   component.ts  list-manager TUI component
+ *   storage.ts    prompt-manager.json load/save helpers
+ *   types.ts      shared TypeScript types
+ */
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { registerPromptCommand } from "./command.js";
+
+export default function promptManagerExtension(pi: ExtensionAPI) {
+  registerPromptCommand(pi);
+}

package/src/storage.ts

@@ -0,0 +1,28 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { getAgentDir } from "@earendil-works/pi-coding-agent";
+import type { SavedPrompt } from "./types.js";
+
+function dataFilePath(): string {
+  return join(getAgentDir(), "prompt-manager.json");
+}
+
+export async function loadPrompts(): Promise<SavedPrompt[]> {
+  try {
+    const raw = await readFile(dataFilePath(), "utf8");
+    const parsed = JSON.parse(raw) as { prompts?: unknown };
+    return Array.isArray(parsed.prompts) ? (parsed.prompts as SavedPrompt[]) : [];
+  } catch {
+    return [];
+  }
+}
+
+export async function savePrompts(prompts: SavedPrompt[]): Promise<void> {
+  const path = dataFilePath();
+  await mkdir(dirname(path), { recursive: true });
+  await writeFile(path, JSON.stringify({ prompts }, null, 2), "utf8");
+}
+
+export function newId(): string {
+  return Date.now().toString(36) + Math.random().toString(36).slice(2, 7);
+}

package/src/types.ts

@@ -0,0 +1,14 @@
+export interface SavedPrompt {
+  id: string;
+  name: string;
+  content: string;
+  createdAt: number;
+  updatedAt: number;
+}
+
+export type ListResult =
+  | { action: "close" }
+  | { action: "paste"; index: number }
+  | { action: "edit"; index: number }
+  | { action: "delete"; index: number }
+  | { action: "add" };