feat(terminal): paste clipboard images as temp file paths

When Cmd+V is pressed and the clipboard contains an image instead of
text, save it to a temp PNG file and paste the file path into the
terminal. Useful for CLI tools that accept image paths.

Author: maskar

electron/ipc/channels.ts

@@ -102,6 +102,9 @@ export enum IPC {
   OpenPath = 'open_path',
   ReadFileText = 'read_file_text',
 
+  // Clipboard
+  SaveClipboardImage = 'save_clipboard_image',
+
   // Notifications
   ShowNotification = 'show_notification',
   NotificationClicked = 'notification_clicked',

electron/ipc/register.ts

@@ -1,5 +1,6 @@
-import { ipcMain, dialog, shell, app, BrowserWindow, Notification } from 'electron';
+import { ipcMain, dialog, shell, app, clipboard, BrowserWindow, Notification } from 'electron';
 import fs from 'fs';
+import os from 'os';
 import { fileURLToPath } from 'url';
 import { IPC } from './channels.js';
 import {
@@ -463,6 +464,17 @@ export function registerAllHandlers(win: BrowserWindow): void {
     return fs.readFileSync(args.filePath, 'utf8');
   });
 
+  // --- Clipboard ---
+  ipcMain.handle(IPC.SaveClipboardImage, () => {
+    const img = clipboard.readImage();
+    if (img.isEmpty()) return null;
+    const buf = img.toPNG();
+    const tmpDir = os.tmpdir();
+    const filePath = path.join(tmpDir, `clipboard-${Date.now()}.png`);
+    fs.writeFileSync(filePath, buf);
+    return filePath;
+  });
+
   // --- System ---
   ipcMain.handle(IPC.GetSystemFonts, () => getSystemMonospaceFonts());
 

electron/preload.cjs

@@ -93,6 +93,8 @@ const ALLOWED_CHANNELS = new Set([
   // File links
   'open_path',
   'read_file_text',
+  // Clipboard
+  'save_clipboard_image',
   // Notifications
   'show_notification',
   'notification_clicked',

src/components/TerminalView.tsx

@@ -191,9 +191,17 @@ export function TerminalView(props: TerminalViewProps) {
 
       if (isPaste) {
         e.preventDefault();
-        navigator.clipboard.readText().then((text) => {
-          if (text) enqueueInput(text);
-        });
+        (async () => {
+          // Try text first (readText throws if clipboard has no text)
+          const text = await navigator.clipboard.readText().catch(() => '');
+          if (text) {
+            enqueueInput(text);
+            return;
+          }
+          // Fall back to clipboard image → save to temp file and paste path
+          const filePath = await invoke<string | null>(IPC.SaveClipboardImage);
+          if (filePath) enqueueInput(filePath);
+        })();
         return false;
       }