@agnishc/edb-append-system-prompt 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## [Unreleased]
+
+### Added
+- Initial release: `/sys-prompt` command with compose and list overlay modes
+- Confirm dialog before adding snippets
+- Status bar indicator showing active snippet count
+- Session persistence via session storage entries

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agnish Chakraborty
+
+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,32 @@
+# @agnishc/edb-append-system-prompt
+
+A Pi CLI extension that lets you build up a list of system-prompt snippets that are appended to every agent turn in the current session.
+
+## Features
+
+- **Always appends** — snippets accumulate as a list, never replace the base prompt
+- **Confirm before adding** — shows the exact text in a confirm dialog before saving
+- **Status bar indicator** — `⊕ N snippets` shown when active snippets exist
+- **Delete individual snippets** — select and delete from the list view
+- **Persists across `/reload`** — stored in session history, survives extension reloads
+
+## Install
+
+```bash
+pi install npm:@agnishc/edb-append-system-prompt
+```
+
+## Usage
+
+```
+/sys-prompt
+```
+
+Opens an overlay with two modes:
+
+- **Compose mode** — write a snippet, press Enter to add (with confirm dialog)
+- **List mode** — browse existing snippets, press `d` to delete selected
+
+## License
+
+[MIT](LICENSE) © Agnish Chakraborty

package/package.json

@@ -0,0 +1,26 @@
+{
+	"name": "@agnishc/edb-append-system-prompt",
+	"version": "0.1.0",
+	"description": "Pi extension: manage per-session system prompt snippets with add/delete UI",
+	"keywords": ["pi-package", "pi-extension", "edb"],
+	"type": "module",
+	"license": "MIT",
+	"author": "Agnish Chakraborty",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/agnishcc/pi-extention-monorepo.git",
+		"directory": "packages/edb-append-system-prompt"
+	},
+	"homepage": "https://github.com/agnishcc/pi-extention-monorepo/tree/main/packages/edb-append-system-prompt#readme",
+	"bugs": { "url": "https://github.com/agnishcc/pi-extention-monorepo/issues" },
+	"publishConfig": { "access": "public" },
+	"scripts": { "test": "vitest run" },
+	"files": ["src", "README.md", "LICENSE", "CHANGELOG.md"],
+	"pi": {
+		"extensions": ["./src/index.ts"]
+	},
+	"peerDependencies": {
+		"@mariozechner/pi-coding-agent": "*",
+		"@mariozechner/pi-tui": "*"
+	}
+}

package/src/component.ts

@@ -0,0 +1,194 @@
+import {
+	Editor,
+	type EditorTheme,
+	Key,
+	matchesKey,
+	type SelectItem,
+	SelectList,
+	truncateToWidth,
+	visibleWidth,
+} from "@mariozechner/pi-tui";
+import { snippets } from "./state";
+import type { OverlayAction } from "./types";
+import { formatAge, wordCount } from "./utils";
+
+// ── Overlay launcher ───────────────────────────────────────────────────────────
+
+export function openOverlay(ctx: any, prefillText?: string): Promise<OverlayAction | undefined> {
+	return (ctx.ui as any).custom(
+		(tui: any, theme: any, _kb: any, done: (result?: OverlayAction) => void) =>
+			createComponent(tui, theme, done, prefillText),
+		{
+			overlay: true,
+			overlayOptions: {
+				anchor: "center" as const,
+				width: "65%" as const,
+				maxHeight: "80%" as const,
+			},
+		},
+	);
+}
+
+// ── Component ──────────────────────────────────────────────────────────────────
+
+type Mode = "list" | "composing";
+
+export function createComponent(tui: any, theme: any, done: (result?: OverlayAction) => void, prefillText?: string) {
+	const dim = (s: string) => theme.fg("dim", s);
+	const accent = (s: string) => theme.fg("accent", s);
+	const muted = (s: string) => theme.fg("muted", s);
+
+	let mode: Mode = snippets.length === 0 ? "composing" : "list";
+
+	// ── Editor (composing mode) ────────────────────────────────────────────
+	const editorTheme: EditorTheme = {
+		borderColor: (s) => theme.fg("accent", s),
+		selectList: {
+			selectedPrefix: (t) => theme.fg("accent", t),
+			selectedText: (t) => theme.fg("accent", t),
+			description: (t) => theme.fg("muted", t),
+			scrollInfo: (t) => theme.fg("dim", t),
+			noMatch: (t) => theme.fg("warning", t),
+		},
+	};
+	const editor = new Editor(tui, editorTheme);
+	editor.focused = true;
+	if (prefillText) editor.setText(prefillText);
+
+	editor.onSubmit = (text) => {
+		const trimmed = text.trim();
+		if (trimmed) {
+			done({ type: "add", text: trimmed });
+		} else if (snippets.length > 0) {
+			mode = "list";
+			tui.requestRender();
+		} else {
+			done();
+		}
+	};
+
+	// ── SelectList (list mode) ─────────────────────────────────────────────
+	const selectTheme = {
+		selectedPrefix: (t: string) => theme.fg("accent", t),
+		selectedText: (t: string) => theme.fg("accent", t),
+		description: (t: string) => theme.fg("dim", t),
+		scrollInfo: (t: string) => theme.fg("dim", t),
+		noMatch: (t: string) => theme.fg("warning", t),
+	};
+
+	function buildItems(): SelectItem[] {
+		const items: SelectItem[] = [{ value: "__add__", label: accent("＋ Add new snippet"), description: "" }];
+		for (const s of snippets) {
+			const preview = s.text.replace(/\n/g, " ");
+			items.push({
+				value: s.id,
+				label: truncateToWidth(preview, 55),
+				description: `${formatAge(s.createdAt)}  ·  ${wordCount(s.text)} words`,
+			});
+		}
+		return items;
+	}
+
+	const list = new SelectList(buildItems(), 12, selectTheme);
+
+	// ── Rendering ──────────────────────────────────────────────────────────
+
+	function renderHeader(width: number): string[] {
+		const title = theme.bold(accent(" ✦ System Prompt Snippets"));
+		const count = snippets.length === 0 ? muted("none active") : accent(`${snippets.length} active`);
+		const gap = Math.max(2, width - visibleWidth(" ✦ System Prompt Snippets") - visibleWidth(count) - 1);
+		return [title + " ".repeat(gap) + count];
+	}
+
+	function renderBody(width: number): string[] {
+		if (mode === "composing") {
+			const lines: string[] = [];
+			lines.push(dim("  Write your system prompt addition:"));
+			lines.push("");
+			for (const line of editor.render(width - 2)) {
+				lines.push(` ${line}`);
+			}
+			return lines;
+		}
+		return list.render(width);
+	}
+
+	function renderFooter(width: number): string[] {
+		const divider = dim("─".repeat(width));
+		if (mode === "composing") {
+			return [divider, dim(`  Enter submit  ·  Esc ${snippets.length > 0 ? "back to list" : "close"}`)];
+		}
+		return [divider, dim("  ↑↓ navigate  ·  Enter select  ·  d delete selected  ·  Esc close")];
+	}
+
+	// ── Input handling ─────────────────────────────────────────────────────
+
+	return {
+		render(width: number): string[] {
+			return [...renderHeader(width), dim("─".repeat(width)), ...renderBody(width), ...renderFooter(width)];
+		},
+
+		handleInput(data: string): void {
+			if (mode === "composing") {
+				if (matchesKey(data, Key.escape) || matchesKey(data, Key.ctrl("c"))) {
+					if (snippets.length > 0) {
+						mode = "list";
+						tui.requestRender();
+					} else {
+						done();
+					}
+					return;
+				}
+				editor.handleInput(data);
+				tui.requestRender();
+				return;
+			}
+
+			// list mode
+			if (matchesKey(data, Key.escape) || matchesKey(data, Key.ctrl("c"))) {
+				done();
+				return;
+			}
+
+			if (data === "d") {
+				const sel = list.getSelectedItem();
+				if (sel && sel.value !== "__add__") {
+					const snippet = snippets.find((s) => s.id === sel.value);
+					if (snippet) done({ type: "delete", id: snippet.id, text: snippet.text });
+				}
+				return;
+			}
+
+			if (matchesKey(data, Key.enter) || matchesKey(data, Key.return)) {
+				const sel = list.getSelectedItem();
+				if (!sel) return;
+				if (sel.value === "__add__") {
+					mode = "composing";
+					editor.setText("");
+					editor.focused = true;
+					tui.requestRender();
+				} else {
+					const snippet = snippets.find((s) => s.id === sel.value);
+					if (snippet) done({ type: "delete", id: snippet.id, text: snippet.text });
+				}
+				return;
+			}
+
+			if (
+				matchesKey(data, Key.up) ||
+				matchesKey(data, Key.down) ||
+				matchesKey(data, Key.pageUp) ||
+				matchesKey(data, Key.pageDown)
+			) {
+				list.handleInput(data);
+				tui.requestRender();
+				return;
+			}
+		},
+
+		invalidate(): void {
+			editor.invalidate?.();
+			list.invalidate();
+		},
+	};
+}

package/src/index.ts

@@ -0,0 +1,88 @@
+/**
+ * pi-append-system-prompt
+ *
+ * Manages a list of system-prompt snippets that are appended to every agent
+ * turn in the current session.
+ *
+ * Features:
+ *   - Always appends (never replaces) — snippets accumulate as a list
+ *   - Confirm dialog before any snippet is added, showing the exact text
+ *   - Status bar indicator when snippets are active
+ *   - Delete individual snippets
+ *   - Persists across /reload via session storage — scoped to this session only
+ *
+ * Command: /sys-prompt
+ */
+
+import type { ExtensionAPI, ExtensionCommandContext } from "@mariozechner/pi-coding-agent";
+import { openOverlay } from "./component";
+import {
+	addSnippet,
+	loadFromSession,
+	persistSnippets,
+	removeSnippet,
+	setSnippets,
+	snippets,
+	updateStatusBar,
+} from "./state";
+
+// ── Extension ──────────────────────────────────────────────────────────────────
+
+export default function sysPromptExtension(pi: ExtensionAPI): void {
+	// Restore state on session start / reload
+	pi.on("session_start", async (_e, ctx) => {
+		setSnippets(loadFromSession(ctx));
+		updateStatusBar(ctx);
+	});
+
+	// Append all snippets to the system prompt before each turn
+	pi.on("before_agent_start", async (event) => {
+		if (snippets.length === 0) return;
+		const addition = snippets.map((s) => s.text).join("\n\n");
+		return { systemPrompt: `${event.systemPrompt}\n\n${addition}` };
+	});
+
+	pi.registerCommand("sys-prompt", {
+		description: "Manage system prompt snippets — add, view, and delete",
+		handler: async (_args, ctx: ExtensionCommandContext) => {
+			if (!ctx.hasUI) return;
+			await ctx.waitForIdle();
+
+			let pendingText: string | undefined;
+			let shouldReopen = false;
+
+			do {
+				shouldReopen = false;
+				const action = await openOverlay(ctx, pendingText);
+				pendingText = undefined;
+
+				if (!action) break;
+
+				if (action.type === "add") {
+					const preview = action.text.length > 500 ? `${action.text.slice(0, 497)}…` : action.text;
+					const confirmed = await ctx.ui.confirm("Add this to your system prompt?", preview);
+					if (confirmed) {
+						addSnippet(action.text);
+						persistSnippets(pi);
+						updateStatusBar(ctx);
+					} else {
+						// Preserve typed text so user doesn't lose their work
+						pendingText = action.text;
+					}
+					shouldReopen = true;
+				}
+
+				if (action.type === "delete") {
+					const preview = action.text.length > 300 ? `${action.text.slice(0, 297)}…` : action.text;
+					const confirmed = await ctx.ui.confirm("Remove this snippet from your system prompt?", preview);
+					if (confirmed) {
+						removeSnippet(action.id);
+						persistSnippets(pi);
+						updateStatusBar(ctx);
+					}
+					shouldReopen = true;
+				}
+			} while (shouldReopen);
+		},
+	});
+}

package/src/state.ts

@@ -0,0 +1,52 @@
+import { randomUUID } from "node:crypto";
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { Snippet } from "./types";
+
+// ── Module state ───────────────────────────────────────────────────────────────
+
+export let snippets: Snippet[] = [];
+
+export const STATUS_KEY = "sys-prompt";
+export const ENTRY_TYPE = "sys-prompt-snippets";
+
+// ── State helpers ──────────────────────────────────────────────────────────────
+
+export function addSnippet(text: string): void {
+	snippets.push({ id: randomUUID(), text: text.trim(), createdAt: Date.now() });
+}
+
+export function removeSnippet(id: string): void {
+	snippets = snippets.filter((s) => s.id !== id);
+}
+
+export function setSnippets(next: Snippet[]): void {
+	snippets = next;
+}
+
+// ── Session persistence ────────────────────────────────────────────────────────
+
+export function loadFromSession(ctx: any): Snippet[] {
+	const entries: any[] = ctx.sessionManager.getEntries();
+	for (let i = entries.length - 1; i >= 0; i--) {
+		const e = entries[i];
+		if (e.type === "custom" && e.customType === ENTRY_TYPE) {
+			return (e.data?.snippets as Snippet[]) ?? [];
+		}
+	}
+	return [];
+}
+
+export function persistSnippets(pi: ExtensionAPI): void {
+	pi.appendEntry(ENTRY_TYPE, { snippets });
+}
+
+// ── Status bar ─────────────────────────────────────────────────────────────────
+
+export function updateStatusBar(ctx: any): void {
+	if (snippets.length === 0) {
+		ctx.ui.setStatus(STATUS_KEY, undefined);
+		return;
+	}
+	const label = snippets.length === 1 ? "1 snippet" : `${snippets.length} snippets`;
+	ctx.ui.setStatus(STATUS_KEY, ctx.ui.theme.fg("accent", `⊕ ${label}`));
+}

package/src/types.ts

@@ -0,0 +1,9 @@
+// ── Types ──────────────────────────────────────────────────────────────────────
+
+export interface Snippet {
+	id: string;
+	text: string;
+	createdAt: number;
+}
+
+export type OverlayAction = { type: "add"; text: string } | { type: "delete"; id: string; text: string };

package/src/utils.ts

@@ -0,0 +1,13 @@
+// ── Utils ──────────────────────────────────────────────────────────────────────
+
+export function formatAge(ts: number): string {
+	const s = Math.floor((Date.now() - ts) / 1000);
+	if (s < 60) return `${s}s ago`;
+	if (s < 3600) return `${Math.floor(s / 60)}m ago`;
+	if (s < 86400) return `${Math.floor(s / 3600)}h ago`;
+	return `${Math.floor(s / 86400)}d ago`;
+}
+
+export function wordCount(text: string): number {
+	return text.trim().split(/\s+/).filter(Boolean).length;
+}