pi-prompt-restore 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## 1.0.0 — 2026-06-27
+
+### Added
+- Initial release
+- **Ctrl+C save** — saves the current editor text before the built-in clear action runs
+- **Up arrow restore** — when the editor is empty and a saved prompt exists, restores it immediately; subsequent Up presses go through normal history
+- Each Ctrl+C overwrites the previous save so you always recover the most recently cleared prompt
+- Copy (Ctrl+C with a selection) still works normally
+- TUI-mode guard — does not activate in print, JSON, or RPC modes

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Cullen Botha
+
+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,82 @@
+<div align="center">
+
+# Pi Prompt Restore
+
+_Accidentally hit Ctrl+C instead of Ctrl+V? Get your prompt back with Up arrow._
+
+[How It Works](#how-it-works) • [Installation](#installation) • [Usage](#usage)
+
+</div>
+
+Saves your in-progress prompt whenever Ctrl+C clears the editor, so a mistyped
+paste shortcut doesn't cost you five minutes of careful prompt-crafting. Press
+**Up arrow** to recover it — press Up again for normal history.
+
+## How It Works
+
+```
+User types a prompt in the editor
+        │
+        ▼
+Ctrl+C pressed ──────────────────────────┐
+        │                                │
+        ▼                                ▼
+  index.ts handleInput               Built-in clear
+  (intercepts "ctrl+c")              fires and wipes
+        │                            the editor
+        ▼
+  savedPrompt = this.getText()
+        │
+        ▼
+User presses Up (editor empty) ────► savedPrompt restored
+        │                            savedPrompt cleared
+        ▼
+User presses Up again ─────────────► normal history recall
+```
+
+| Key                      | Without extension                                | With Prompt Saver                                                   |
+| ------------------------ | ------------------------------------------------ | ------------------------------------------------------------------- |
+| **Ctrl+C**               | Clears the editor. Text is gone forever.         | Text is saved silently, then the editor clears as usual.            |
+| **Up** (editor empty)    | Recalls the last submitted message from history. | Restores the saved prompt first. Press Up again for normal history. |
+| **Up** (editor has text) | Moves cursor up.                                 | Moves cursor up (unchanged).                                        |
+
+- Each Ctrl+C overwrites the previous save — you always recover the **most recently** cleared prompt.
+- Copy (Ctrl+C with a selection) still copies to the clipboard; the full text is also saved as a harmless side effect.
+- The saved prompt is **not persisted** across sessions — it lives only until the next Ctrl+C or pi restart.
+
+## Installation
+
+### Via npm
+
+```bash
+pi install npm:pi-prompt-restore
+```
+
+### Manual
+
+Clone or copy into your pi extensions directory:
+
+```bash
+cp -r pi-prompt-restore ~/.pi/agent/extensions/pi-prompt-restore
+```
+
+Then run `/reload` in pi, or restart pi. The extension loads automatically from `~/.pi/agent/extensions/`.
+
+## Usage
+
+No commands, no configuration — just type.
+
+1. Type a prompt.
+2. Accidentally press **Ctrl+C** (editor clears).
+3. Press **Up arrow** — your prompt is restored.
+4. Press **Up arrow** again to browse normal history.
+
+## Compatibility
+
+- Works in interactive (**TUI**) mode only.
+- Compatible with other extensions that don't replace the editor. If another
+  extension also calls `setEditorComponent`, the last one loaded wins.
+
+## License
+
+MIT

package/index.ts

@@ -0,0 +1,53 @@
+/**
+ * Prompt Saver Extension
+ *
+ * Saves the current editor text when Ctrl+C clears the input,
+ * so accidentally discarded prompts can be retrieved with the up arrow.
+ *
+ * - Ctrl+C: saves the current text before clearing the editor
+ * - Up arrow: if editor is empty and a saved prompt exists, restores it
+ * - Subsequent up arrow presses go through normal history as usual
+ */
+
+import { CustomEditor, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { matchesKey, Key } from "@earendil-works/pi-tui";
+
+// Module-level state: the most recently cleared prompt
+let savedPrompt: string | null = null;
+
+class PromptSaverEditor extends CustomEditor {
+	handleInput(data: string): void {
+		// Intercept Ctrl+C: save the current text before it gets cleared
+		if (matchesKey(data, Key.ctrl("c"))) {
+			const text = this.getText();
+			if (text) {
+				savedPrompt = text;
+			}
+			// Let the default handler clear the editor (or copy if there's a selection)
+			super.handleInput(data);
+			return;
+		}
+
+		// Intercept Up arrow: restore saved prompt if editor is empty
+		if (matchesKey(data, Key.up)) {
+			if (!this.getText() && savedPrompt) {
+				this.setText(savedPrompt);
+				savedPrompt = null;
+				return; // Don't pass to super — we handled it
+			}
+			// Editor has text or no saved prompt: normal up behavior (cursor up / history)
+		}
+
+		// Pass everything else to the default editor behavior
+		super.handleInput(data);
+	}
+}
+
+export default function (pi: ExtensionAPI) {
+	pi.on("session_start", (_event, ctx) => {
+		// Only install in TUI mode (not print/json/rpc)
+		if (ctx.mode !== "tui") return;
+
+		ctx.ui.setEditorComponent((tui, theme, kb) => new PromptSaverEditor(tui, theme, kb));
+	});
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "pi-prompt-restore",
+  "version": "0.1.0",
+  "description": "Pi extension that saves discarded prompts when Ctrl+C clears the editor - recover with the Up arrow",
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "prompt",
+    "input",
+    "editor",
+    "recovery",
+    "undo",
+    "history",
+    "pi",
+    "coding-agent",
+    "tui"
+  ],
+  "license": "MIT",
+  "author": "Cullen Botha <mail@cullen.dev>",
+  "type": "module",
+  "files": [
+    "index.ts",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cullendotdev/pi-prompt-restore.git"
+  },
+  "homepage": "https://github.com/cullendotdev/pi-prompt-restore#readme",
+  "bugs": {
+    "url": "https://github.com/cullendotdev/pi-prompt-restore/issues"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}