@ryan_nookpi/pi-extension-clipboard 0.2.1 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # @ryan_nookpi/pi-extension-clipboard
 
-This extension lets pi copy generated text directly to your system clipboard.
+This extension lets pi copy generated text directly to your system clipboard and paste your clipboard contents back into the conversation.
 
 It is especially handy for reply drafts, commit messages, PR descriptions, SQL queries, and other text you want to paste right away.
 
@@ -15,11 +15,18 @@ pi install npm:@ryan_nookpi/pi-extension-clipboard
 - "Write a reply draft and put it in my clipboard"
 - copying long outputs without selecting them manually
 - using clipboard copy from terminal or SSH-based workflows
+- "Paste my clipboard and summarize / translate / refactor it"
+- pulling logs, URLs, or snippets you just copied into the chat
 
 ## Example prompts
 
 - "Draft a Slack reply and copy it to my clipboard."
 - "Put this SQL query in my clipboard."
 - "Write a PR description and copy it for me."
+- "Paste my clipboard and summarize what's in it."
+- "Read my clipboard and translate it to English."
 
-After installation, pi can use the `copy_to_clipboard` tool to copy results instantly.
+## Tools
+
+- `copy_to_clipboard` — copies text to the user's clipboard via OSC52 escape sequences (works over SSH and in most modern terminals).
+- `paste_from_clipboard` — reads the current text contents of the user's clipboard using `pbpaste` (macOS), `xclip -selection clipboard -o` or `wl-paste` (Linux), or PowerShell `Get-Clipboard` (Windows).

package/index.ts

@@ -1,14 +1,16 @@
 /**
  * Clipboard Extension
  *
- * Provides a tool that allows the LLM to copy text to the user's clipboard
- * using OSC52 escape sequences. This works across SSH sessions and most
- * modern terminal emulators.
+ * Provides tools that allow the LLM to copy text to the user's clipboard
+ * using OSC52 escape sequences and to paste text from the user's clipboard
+ * via OS-native commands (pbpaste / xclip / wl-paste / Get-Clipboard).
  *
  * Usage:
  *   Ask the LLM: "write me a draft reply and put it into clipboard!"
+ *   Ask the LLM: "paste my clipboard and summarize it."
  */
 
+import { spawnSync } from "node:child_process";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "@sinclair/typebox";
 
@@ -36,6 +38,63 @@ function copyToClipboard(text: string): void {
 	process.stdout.write(osc52);
 }
 
+interface PasteCommand {
+	command: string;
+	args: string[];
+}
+
+/**
+ * Resolve the OS-specific commands used to read the system clipboard.
+ * Linux returns multiple commands so the tool can fall back when one is missing.
+ */
+function getPasteCommands(platform: NodeJS.Platform): PasteCommand[] {
+	switch (platform) {
+		case "darwin":
+			return [{ command: "pbpaste", args: [] }];
+		case "linux":
+			return [
+				{ command: "xclip", args: ["-selection", "clipboard", "-o"] },
+				{ command: "wl-paste", args: [] },
+			];
+		case "win32":
+			return [
+				{
+					command: "powershell.exe",
+					args: ["-NoProfile", "-NonInteractive", "-Command", "Get-Clipboard"],
+				},
+			];
+		default:
+			return [];
+	}
+}
+
+/**
+ * Read the user's system clipboard text using the first available OS command.
+ * Throws when the platform is unsupported or every candidate command fails.
+ */
+function readFromClipboard(): string {
+	const commands = getPasteCommands(process.platform);
+	if (commands.length === 0) {
+		throw new Error(`Clipboard read is not supported on ${process.platform}.`);
+	}
+
+	const errors: string[] = [];
+	for (const cmd of commands) {
+		const result = spawnSync(cmd.command, cmd.args, { encoding: "utf-8" });
+		if (result.error) {
+			errors.push(`${cmd.command}: ${result.error.message}`);
+			continue;
+		}
+		if (result.status !== 0) {
+			const stderr = (result.stderr ?? "").toString().trim();
+			errors.push(`${cmd.command} exited with ${result.status}${stderr ? `: ${stderr}` : ""}`);
+			continue;
+		}
+		return (result.stdout ?? "").toString();
+	}
+	throw new Error(`Failed to read clipboard. ${errors.join("; ")}`);
+}
+
 export default function clipboardExtension(pi: ExtensionAPI): void {
 	pi.registerTool({
 		name: "copy_to_clipboard",
@@ -91,4 +150,54 @@ export default function clipboardExtension(pi: ExtensionAPI): void {
 			}
 		},
 	});
+
+	pi.registerTool({
+		name: "paste_from_clipboard",
+		label: "Paste from Clipboard",
+		description:
+			"Read the current text contents of the user's system clipboard. Use this when the user " +
+			"asks you to read, paste, summarize, translate, or otherwise act on whatever they just " +
+			"copied. Uses pbpaste on macOS, xclip or wl-paste on Linux, and PowerShell Get-Clipboard " +
+			"on Windows.",
+		parameters: Type.Object({}),
+		async execute(_toolCallId, _params, _signal, _onUpdate, ctx) {
+			try {
+				const text = readFromClipboard();
+
+				if (!text || text.trim().length === 0) {
+					return {
+						content: [{ type: "text", text: "Clipboard is empty." }],
+						details: { success: false, error: "empty_clipboard" },
+					};
+				}
+
+				const charCount = text.length;
+				const preview = text.length > 100 ? `${text.slice(0, 100)}...` : text;
+
+				if (ctx.hasUI) {
+					ctx.ui.notify(`Pasted ${charCount} characters from clipboard`, "info");
+				}
+
+				return {
+					content: [
+						{
+							type: "text",
+							text: `Pasted ${charCount} characters from clipboard.\n\n${text}`,
+						},
+					],
+					details: {
+						success: true,
+						characterCount: charCount,
+						preview,
+					},
+				};
+			} catch (error) {
+				const errorMessage = error instanceof Error ? error.message : "Unknown error";
+				return {
+					content: [{ type: "text", text: `Failed to paste from clipboard: ${errorMessage}` }],
+					details: { success: false, error: errorMessage },
+				};
+			}
+		},
+	});
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ryan_nookpi/pi-extension-clipboard",
-  "version": "0.2.1",
-  "description": "Clipboard copy tool extension for pi using OSC52 escape sequences.",
+  "version": "0.3.0",
+  "description": "Clipboard copy and paste tools for pi (OSC52 copy + pbpaste/xclip/wl-paste/Get-Clipboard paste).",
   "license": "MIT",
   "repository": {
     "type": "git",