feat(terminal): add clickable file path links

File paths in terminal output are now highlighted and clickable.
Supports absolute, relative, bare, and @Scoped paths with :line:col
suffixes. Trailing punctuation is stripped. An onFileLink callback
prop allows parent components to handle specific file types.

Author: maskar

electron/ipc/channels.ts

@@ -98,6 +98,9 @@ export enum IPC {
   // System
   GetSystemFonts = 'get_system_fonts',
 
+  // File links
+  OpenPath = 'open_path',
+
   // Notifications
   ShowNotification = 'show_notification',
   NotificationClicked = 'notification_clicked',

electron/ipc/register.ts

@@ -452,6 +452,12 @@ export function registerAllHandlers(win: BrowserWindow): void {
     cancelAskAboutCode(args.requestId);
   });
 
+  // --- File links ---
+  ipcMain.handle(IPC.OpenPath, (_e, args) => {
+    validatePath(args.filePath, 'filePath');
+    return shell.openPath(args.filePath);
+  });
+
   // --- System ---
   ipcMain.handle(IPC.GetSystemFonts, () => getSystemMonospaceFonts());
 

electron/preload.cjs

@@ -90,6 +90,8 @@ const ALLOWED_CHANNELS = new Set([
   'cancel_ask_about_code',
   // System
   'get_system_fonts',
+  // File links
+  'open_path',
   // Notifications
   'show_notification',
   'notification_clicked',

src/components/TerminalView.tsx

@@ -54,6 +54,7 @@ interface TerminalViewProps {
   }) => void;
   onData?: (data: Uint8Array) => void;
   onPromptDetected?: (text: string) => void;
+  onFileLink?: (filePath: string) => void;
   onReady?: (focusFn: () => void) => void;
   onBufferReady?: (getBuffer: () => string) => void;
   fontSize?: number;
@@ -103,6 +104,58 @@ export function TerminalView(props: TerminalViewProps) {
     );
 
     term.open(containerRef);
+
+    // File path link provider — makes file paths clickable in terminal output
+    // Must be registered after term.open() so the DOM is available.
+    term.registerLinkProvider({
+      provideLinks(y, callback) {
+        if (!term) {
+          callback(undefined);
+          return;
+        }
+        const line = term.buffer.active.getLine(y - 1)?.translateToString(true) ?? '';
+        // Match file paths: absolute, ./ or ../ relative, and bare relative with /
+        // Supports @scoped packages, line:col suffixes like foo.ts:42:10
+        const regex =
+          /(?:~?\/[\w@./-]+|\.{1,2}\/[\w@./-]+|[\w@][\w@./-]*\/[\w@./-]+)(?::\d+(?::\d+)?)?/g;
+        const links: { startIndex: number; length: number; text: string }[] = [];
+        let match: RegExpExecArray | null;
+        while ((match = regex.exec(line)) !== null) {
+          // Strip trailing punctuation that's not part of the path
+          const text = match[0].replace(/[.,;:!?)]+$/, '');
+          if (!text) continue;
+          // Must contain a dot somewhere (file extension) to avoid matching plain directories
+          if (!text.includes('.')) continue;
+          links.push({
+            startIndex: match.index,
+            length: text.length,
+            text,
+          });
+        }
+        callback(
+          links.map((link) => ({
+            range: {
+              start: { x: link.startIndex + 1, y },
+              end: { x: link.startIndex + link.length + 1, y },
+            },
+            text: link.text,
+            activate(event: MouseEvent, _text: string) {
+              // Strip line:col suffix for opening
+              const filePath = link.text.replace(/:\d+(:\d+)?$/, '');
+              // Resolve relative paths against the task's working directory
+              const resolved = filePath.startsWith('/') ? filePath : `${props.cwd}/${filePath}`;
+              // Cmd+click always opens externally; otherwise use callback if provided
+              if (!event.metaKey && props.onFileLink) {
+                props.onFileLink(resolved);
+              } else {
+                invoke(IPC.OpenPath, { filePath: resolved }).catch(console.error);
+              }
+            },
+          })),
+        );
+      },
+    });
+
     props.onReady?.(() => term?.focus());
     props.onBufferReady?.(() => {
       if (!term) return '';