@nicknisi/pi-stash 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nick Nisi
+
+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,52 @@
+# @nicknisi/pi-stash
+
+Replicates Claude Code's `ctrl+s` message stash. Press `ctrl+s` to stash whatever you've typed in the input editor, go do something else (run a command, answer another prompt), then press `ctrl+s` again with an empty editor to pop the most recent stash back. Stashes live on a stack, so multiple drafts can be parked and restored LIFO.
+
+## What it adds
+
+- **Keybinding:** `ctrl+s` — stash/restore toggle (see behavior table below)
+- **Widget:** a single-line widget above the editor, visible whenever the stash stack is non-empty, showing a 60-char preview of the most recent stash, the count of additional stashes (`(+N more)`), and a `ctrl+s to restore` hint
+- **Events hooked:** `before_agent_start` — after a message is submitted and the agent starts, the most recent stash is auto-restored into the now-empty editor (mirrors Claude Code)
+- No slash commands, no tools, no custom entry types.
+
+### Keybinding behavior
+
+| Editor state on `ctrl+s`                  | Action                                     |
+| ----------------------------------------- | ------------------------------------------ |
+| Contains text                             | Push text onto the stack, clear the editor |
+| Empty (or whitespace) and stack non-empty | Pop the most recent stash into the editor  |
+| Empty and stack empty                     | No-op                                      |
+
+## Usage
+
+```text
+(type a long prompt, then need to ask something else first)
+ctrl+s            "⧉ stashed: Refactor the auth module to..." · editor cleared
+(ask the other question; on submit, the stashed draft is restored automatically)
+ctrl+s            (with empty editor) pops the stash back manually
+```
+
+The stash is in-memory only (per session, per process). It is not persisted across restarts.
+
+## Configuration
+
+None. No config files, no options, no environment variables.
+
+## Dependencies
+
+- **Peer:** `@earendil-works/pi-coding-agent` (`*`). Uses only the public extension API: `pi.registerShortcut`, `pi.on("before_agent_start")`, `ctx.ui.getEditorText` / `setEditorText` / `setWidget` / `theme`, and `ctx.hasUI`.
+- No runtime npm dependencies, no workspace deps.
+
+## Caveats
+
+- UI-gated: every handler checks `ctx.hasUI`; the extension is a no-op in headless/non-TUI mode.
+- Depends on the editor text APIs (`ctx.ui.getEditorText` / `setEditorText`) and the widget system (`ctx.ui.setWidget`) — these are stable pi extension APIs, but a pi version that changes editor or widget semantics could affect it.
+- The `before_agent_start` auto-restore pops a stash whenever a message is sent with an empty editor. If you intentionally sent a quick command and wanted the stash to stay parked, it will still be restored into the editor (you can `ctrl+s` it back). This matches Claude Code's behavior.
+- Stash stack is module-local state; it does not survive session reload or extension reload.
+- No platform-specific behavior (works on any OS/terminal pi runs in). The widget preview uses the Unicode glyphs `⧉` and `…`.
+
+## Install
+
+```bash
+pi install /Users/nicknisi/Developer/pi-extensions/packages/stash
+```

package/index.ts

@@ -0,0 +1,62 @@
+/**
+ * Message Stash Extension
+ *
+ * Replicates Claude Code's ctrl+s message stash: press ctrl+s to stash
+ * whatever you've typed in the input box, do something else, then press
+ * ctrl+s again (with an empty input) to restore it.
+ *
+ * - ctrl+s with text in the editor → pushes it onto a stack and clears
+ * - ctrl+s with an empty editor    → pops the most recent stash back
+ * - sending another message        → auto-restores the most recent stash
+ *
+ * A widget above the editor shows how many messages are stashed with a
+ * one-line preview of the most recent one.
+ */
+
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+
+const WIDGET_KEY = "message-stash";
+
+export default function stash(pi: ExtensionAPI) {
+  const stack: string[] = [];
+
+  const updateWidget = (ctx: ExtensionContext) => {
+    if (!ctx.hasUI) return;
+    if (stack.length === 0) {
+      ctx.ui.setWidget(WIDGET_KEY, undefined);
+      return;
+    }
+    const theme = ctx.ui.theme;
+    const latest = stack[stack.length - 1]!;
+    const firstLine = latest.split("\n")[0] ?? "";
+    const preview = firstLine.length > 60 ? `${firstLine.slice(0, 60)}…` : firstLine;
+    const count = stack.length > 1 ? theme.fg("dim", ` (+${stack.length - 1} more)`) : "";
+    ctx.ui.setWidget(WIDGET_KEY, [
+      `${theme.fg("accent", "⧉ stashed:")} ${theme.fg("muted", preview)}${count} ${theme.fg("dim", "· ctrl+s to restore")}`,
+    ]);
+  };
+
+  pi.registerShortcut("ctrl+s", {
+    description: "Stash / restore the typed message",
+    handler: async (ctx) => {
+      if (!ctx.hasUI) return;
+      const text = ctx.ui.getEditorText();
+      if (text.trim().length > 0) {
+        stack.push(text);
+        ctx.ui.setEditorText("");
+      } else if (stack.length > 0) {
+        ctx.ui.setEditorText(stack.pop()!);
+      }
+      updateWidget(ctx);
+    },
+  });
+
+  // After a message is submitted, auto-restore the most recent stash into
+  // the now-empty editor (mirrors Claude Code's behavior).
+  pi.on("before_agent_start", async (_event, ctx) => {
+    if (!ctx.hasUI || stack.length === 0) return;
+    if (ctx.ui.getEditorText().trim().length > 0) return;
+    ctx.ui.setEditorText(stack.pop()!);
+    updateWidget(ctx);
+  });
+}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@nicknisi/pi-stash",
+  "version": "0.1.0",
+  "description": "Stash and restore the current prompt draft",
+  "keywords": [
+    "pi",
+    "pi-coding-agent",
+    "pi-package"
+  ],
+  "files": [
+    "index.ts"
+  ],
+  "type": "module",
+  "exports": {
+    ".": "./index.ts"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  },
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nicknisi/pi-extensions.git",
+    "directory": "packages/stash"
+  },
+  "homepage": "https://github.com/nicknisi/pi-extensions/tree/main/packages/stash#readme"
+}