pi-extensions 0.1.32 → 0.1.34

package/files-widget/CHANGELOG.md

@@ -4,8 +4,28 @@ All notable changes to this extension will be documented in this file.
 
 ## [Unreleased]
 
+## [0.1.18] - 2026-04-19
+
+### Changed
+- Show symlinks with a `↗` marker in the `/readfiles` tree.
+
+### Fixed
+- Let `/readfiles` navigate into directory symlinks in both non-git folders and git repos instead of rendering them as inert files or empty directories.
+- Guard symlink directory scanning against ancestor cycles so links like `foo -> .` or `foo -> ..` don't recurse forever.
+- Treat git-tracked and untracked directory symlinks as lazily scannable directories rather than plain files.
+
+### Thanks
+- Thanks to @xapids for reporting the original macOS symlink navigation issue ([#9](https://github.com/tmustier/pi-extensions/issues/9)).
+
+## [0.1.17] - 2026-04-19
+
 ### Changed
 - Make the inline comment editor multiline with wrapped footer rendering, `Enter` for a new line, and `Ctrl+Enter`/`Ctrl+D` to send.
+- Add an `m` toggle for rendered vs raw Markdown in the viewer, and fall back to raw mode before line-based search or selection.
+- Show a sent/queued confirmation toast after returning an inline comment to the agent.
+
+### Thanks
+- Thanks to avg8888 in the Pi Discord for surfacing the comment editor and Markdown review issues fixed in this release.
 
 ## [0.1.16] - 2026-04-19
 

package/files-widget/README.md

@@ -2,6 +2,8 @@
 
 In-terminal file browser and diff viewer widget for Pi. Navigate files, view diffs, select code, and send comments to the agent without leaving the terminal and without interrupting your agent.
 
+Directory symlinks are shown with a `↗` marker and can be expanded like normal folders.
+
 <video controls autoplay loop muted playsinline>
   <source src="demo.mp4" type="video/mp4" />
 </video>
@@ -113,6 +115,7 @@ If missing, `/review` or `/diff` will show a clear install prompt.
 - `PgUp/PgDn`: page up/down
 - `g/G`: top/bottom
 - `d`: toggle diff (tracked files only)
+- `m`: toggle rendered/raw view for Markdown files
 - `/`: search (type to search)
 - `n` / `N`: next/prev match
 - `v`: select mode (line selection)
@@ -126,6 +129,7 @@ If missing, `/review` or `/diff` will show a clear install prompt.
 ## Notes
 
 - Untracked files show as `[UNTRACKED]` and open in normal view.
+- Searching in rendered Markdown switches to raw mode first, and selecting from rendered Markdown first switches you back to raw so line-based matches and comments stay aligned with the source file.
 - Folder LOCs are shown only when the folder is collapsed (expanded folders would duplicate counts).
 - Line counts load asynchronously; the header shows activity while counts are computed.
 - Large non-git folders load progressively and may show `[partial]` while loading in safe mode.

package/files-widget/TODO.md

@@ -46,7 +46,7 @@
 ### Markdown Rendering
 - [x] Detect `glow` availability
 - [x] Shell out to `glow` for .md files
-- [ ] Toggle between rendered and raw (`m` key?)
+- [x] Toggle between rendered and raw (`m`)
 - [x] Fallback to syntax-highlighted raw
 
 ### Diff View
@@ -74,7 +74,7 @@
 - [x] Format message with file path, line range, code snippet, comment
 - [x] Use `pi.sendUserMessage()` with `deliverAs: "followUp"`
 - [x] Handle case when agent is idle vs streaming
-- [ ] Show confirmation notification
+- [x] Show confirmation notification
 
 ## Phase 4: tuicr Integration (Optional)
 

package/files-widget/browser.ts

@@ -1,6 +1,7 @@
 import type { Theme } from "@mariozechner/pi-coding-agent";
 import { Key, matchesKey, truncateToWidth } from "@mariozechner/pi-tui";
-import { readdir, readFile, stat } from "node:fs/promises";
+import { lstatSync, realpathSync, statSync } from "node:fs";
+import { readdir, readFile, realpath, stat } from "node:fs/promises";
 import { homedir } from "node:os";
 import { basename, join, relative, resolve, sep } from "node:path";
 
@@ -104,6 +105,51 @@ function getNodeDepth(node: FileNode, cwd: string): number {
   return rel.split(sep).length;
 }
 
+function safeRealPathSync(path: string): string {
+  try {
+    return realpathSync(path);
+  } catch {
+    return resolve(path);
+  }
+}
+
+function getPathInfoSync(path: string): { isDirectory: boolean; isSymlink: boolean; realPath?: string } {
+  try {
+    const linkStat = lstatSync(path);
+    const isSymlink = linkStat.isSymbolicLink();
+    const targetStat = isSymlink ? statSync(path) : linkStat;
+    return {
+      isDirectory: targetStat.isDirectory(),
+      isSymlink,
+      realPath: targetStat.isDirectory() ? safeRealPathSync(path) : undefined,
+    };
+  } catch {
+    return { isDirectory: false, isSymlink: false };
+  }
+}
+
+async function getPathInfo(path: string, isSymlink: boolean): Promise<{ isDirectory: boolean; isSymlink: boolean; realPath?: string }> {
+  try {
+    const targetStat = await stat(path);
+    return {
+      isDirectory: targetStat.isDirectory(),
+      isSymlink,
+      realPath: targetStat.isDirectory() ? await realpath(path).catch(() => resolve(path)) : undefined,
+    };
+  } catch {
+    return { isDirectory: false, isSymlink };
+  }
+}
+
+function hasAncestorRealPath(node: FileNode | undefined, realPath: string): boolean {
+  let current = node;
+  while (current) {
+    if (current.realPath === realPath) return true;
+    current = current.parent;
+  }
+  return false;
+}
+
 function shouldSafeMode(cwd: string): boolean {
   const resolved = resolve(cwd);
   const home = resolve(homedir());
@@ -183,14 +229,19 @@ function formatNodeMeta(node: FileNode, theme: Theme): string {
   return parts.length > 0 ? ` ${parts.join(" ")}` : "";
 }
 
+function withSymlinkMarker(label: string, node: FileNode, theme: Theme): string {
+  return node.isSymlink ? `${label}${theme.fg("dim", " ↗")}` : label;
+}
+
 function formatNodeName(node: FileNode, theme: Theme): string {
-  if (isIgnoredStatus(node.gitStatus)) return theme.fg("dim", node.name);
+  if (isIgnoredStatus(node.gitStatus)) return withSymlinkMarker(theme.fg("dim", node.name), node, theme);
   if (node.isDirectory) {
     const label = node.hasChangedChildren ? theme.fg("warning", node.name) : theme.fg("accent", node.name);
-    return node.loading ? `${label}${theme.fg("dim", " ⏳")}` : label;
+    const rendered = withSymlinkMarker(label, node, theme);
+    return node.loading ? `${rendered}${theme.fg("dim", " ⏳")}` : rendered;
   }
-  if (node.gitStatus) return theme.fg("warning", node.name);
-  return node.name;
+  if (node.gitStatus) return withSymlinkMarker(theme.fg("warning", node.name), node, theme);
+  return withSymlinkMarker(node.name, node, theme);
 }
 
 function collapseAllExcept(node: FileNode, keep: Set<FileNode>): void {
@@ -227,6 +278,7 @@ export function createFileBrowser(
       name: ".",
       path: cwd,
       isDirectory: true,
+      realPath: safeRealPathSync(cwd),
       children: undefined,
       expanded: true,
       hasChangedChildren: false,
@@ -350,6 +402,14 @@ export function createFileBrowser(
   }
 
   function shouldAutoScan(depth: number): boolean {
+    // In git repos the main tree comes from git file lists, not from filesystem
+    // crawling. If the user expands a symlinked directory inside that tree, only
+    // scan one level on demand; nested directories stay lazy until explicitly
+    // expanded so links into large trees (iCloud/Drive/$HOME) don't trigger a
+    // broad recursive crawl.
+    if (repo) {
+      return false;
+    }
     if (browser.scanState.mode === "safe") {
       return depth <= 0;
     }
@@ -399,31 +459,74 @@ export function createFileBrowser(
       for (const entry of sorted) {
         if (ignored.has(entry.name) || entry.name.startsWith(".")) continue;
         const fullPath = join(node.path, entry.name);
+        const childDepth = depth + 1;
+
         if (entry.isDirectory()) {
           const dirNode: FileNode = {
             name: entry.name,
             path: fullPath,
             isDirectory: true,
+            realPath: await realpath(fullPath).catch(() => resolve(fullPath)),
+            parent: node,
             children: undefined,
-            expanded: depth + 1 < 1,
+            expanded: childDepth < 1,
             hasChangedChildren: false,
           };
           dirs.push(dirNode);
           browser.nodeByPath.set(fullPath, dirNode);
-          if (shouldAutoScan(depth + 1)) {
-            enqueueScan(dirNode, depth + 1);
+          if (shouldAutoScan(childDepth)) {
+            enqueueScan(dirNode, childDepth);
           }
-        } else {
-          const fileNode: FileNode = {
+          continue;
+        }
+
+        if (entry.isSymbolicLink()) {
+          const pathInfo = await getPathInfo(fullPath, true);
+          if (pathInfo.isDirectory) {
+            const isCycle = pathInfo.realPath ? hasAncestorRealPath(node, pathInfo.realPath) : false;
+            const dirNode: FileNode = {
+              name: entry.name,
+              path: fullPath,
+              isDirectory: true,
+              isSymlink: true,
+              realPath: pathInfo.realPath,
+              parent: node,
+              children: isCycle ? [] : undefined,
+              expanded: childDepth < 1,
+              hasChangedChildren: false,
+            };
+            dirs.push(dirNode);
+            browser.nodeByPath.set(fullPath, dirNode);
+            if (!isCycle && shouldAutoScan(childDepth)) {
+              enqueueScan(dirNode, childDepth);
+            }
+            continue;
+          }
+
+          const symlinkFileNode: FileNode = {
             name: entry.name,
             path: fullPath,
             isDirectory: false,
+            isSymlink: true,
+            parent: node,
             agentModified: agentModifiedFiles.has(fullPath),
           };
-          files.push(fileNode);
-          browser.nodeByPath.set(fullPath, fileNode);
-          queueLineCount(fileNode);
+          files.push(symlinkFileNode);
+          browser.nodeByPath.set(fullPath, symlinkFileNode);
+          queueLineCount(symlinkFileNode);
+          continue;
         }
+
+        const fileNode: FileNode = {
+          name: entry.name,
+          path: fullPath,
+          isDirectory: false,
+          parent: node,
+          agentModified: agentModifiedFiles.has(fullPath),
+        };
+        files.push(fileNode);
+        browser.nodeByPath.set(fullPath, fileNode);
+        queueLineCount(fileNode);
       }
 
       node.children = [...dirs, ...files];
@@ -483,14 +586,13 @@ export function createFileBrowser(
 
   function applyGitUpdates(): void {
     for (const node of browser.nodeByPath.values()) {
-      if (node.isDirectory) continue;
       const relPath = normalizeGitPath(relative(cwd, node.path));
       node.gitStatus = gitStatus.get(relPath);
       node.diffStats = diffStats.get(relPath);
     }
   }
 
-  function ensureFileNode(relPath: string): FileNode | null {
+  function ensureNode(relPath: string): FileNode | null {
     if (!browser.root) return null;
     let normalized = relPath.trim();
     if (!normalized) return null;
@@ -517,6 +619,8 @@ export function createFileBrowser(
           name: part,
           path: dirPath,
           isDirectory: true,
+          realPath: safeRealPathSync(dirPath),
+          parent: current,
           children: [],
           expanded: depth < 1,
           hasChangedChildren: false,
@@ -536,10 +640,36 @@ export function createFileBrowser(
     const existing = browser.nodeByPath.get(filePath);
     if (existing) return existing;
 
+    const pathInfo = getPathInfoSync(filePath);
+    if (pathInfo.isDirectory) {
+      const isCycle = pathInfo.realPath ? hasAncestorRealPath(current, pathInfo.realPath) : false;
+      const dirNode: FileNode = {
+        name: fileName,
+        path: filePath,
+        isDirectory: true,
+        isSymlink: pathInfo.isSymlink,
+        realPath: pathInfo.realPath ?? safeRealPathSync(filePath),
+        parent: current,
+        children: pathInfo.isSymlink && !isCycle ? undefined : [],
+        expanded: false,
+        hasChangedChildren: false,
+        gitStatus: gitStatus.get(normalized),
+        diffStats: diffStats.get(normalized),
+      };
+
+      current.children ??= [];
+      current.children.push(dirNode);
+      sortChildren(current);
+      browser.nodeByPath.set(filePath, dirNode);
+      return dirNode;
+    }
+
     const fileNode: FileNode = {
       name: fileName,
       path: filePath,
       isDirectory: false,
+      isSymlink: pathInfo.isSymlink,
+      parent: current,
       gitStatus: gitStatus.get(normalized),
       agentModified: agentModifiedFiles.has(filePath),
       diffStats: diffStats.get(normalized),
@@ -555,11 +685,13 @@ export function createFileBrowser(
   function addUntrackedNodes(): void {
     for (const [relPath, status] of gitStatus.entries()) {
       if (!isUntrackedStatus(status)) continue;
-      const node = ensureFileNode(relPath);
+      const node = ensureNode(relPath);
       if (node) {
         node.gitStatus = status;
         node.diffStats = diffStats.get(relPath);
-        queueLineCount(node, true);
+        if (!node.isDirectory) {
+          queueLineCount(node, true);
+        }
       }
     }
   }
@@ -673,7 +805,7 @@ export function createFileBrowser(
   function toggleDir(node: FileNode): void {
     if (node.isDirectory) {
       node.expanded = !node.expanded;
-      if (!repo && node.expanded && node.children === undefined) {
+      if (node.expanded && node.children === undefined) {
         enqueueScan(node, getNodeDepth(node, cwd), true);
       }
       refreshLists();

package/files-widget/file-tree.ts

@@ -1,4 +1,4 @@
-import { statSync } from "node:fs";
+import { lstatSync, realpathSync, statSync } from "node:fs";
 import { join } from "node:path";
 
 import { MAX_TREE_DEPTH } from "./constants";
@@ -6,11 +6,26 @@ import type { DiffStats, FileNode, FlatNode } from "./types";
 
 const collator = new Intl.Collator(undefined, { sensitivity: "base" });
 
-function isDirectoryPath(path: string): boolean {
+function safeRealPathSync(path: string): string {
   try {
-    return statSync(path).isDirectory();
+    return realpathSync(path);
   } catch {
-    return false;
+    return path;
+  }
+}
+
+function getPathInfo(path: string): { isDirectory: boolean; isSymlink: boolean; realPath?: string } {
+  try {
+    const linkStat = lstatSync(path);
+    const isSymlink = linkStat.isSymbolicLink();
+    const targetStat = isSymlink ? statSync(path) : linkStat;
+    return {
+      isDirectory: targetStat.isDirectory(),
+      isSymlink,
+      realPath: targetStat.isDirectory() ? safeRealPathSync(path) : undefined,
+    };
+  } catch {
+    return { isDirectory: false, isSymlink: false };
   }
 }
 
@@ -105,6 +120,7 @@ export function buildFileTreeFromPaths(
     name: ".",
     path: cwd,
     isDirectory: true,
+    realPath: safeRealPathSync(cwd),
     children: [],
     expanded: true,
     hasChangedChildren: false,
@@ -145,6 +161,8 @@ export function buildFileTreeFromPaths(
           name: part,
           path: join(cwd, relPath),
           isDirectory: true,
+          realPath: safeRealPathSync(join(cwd, relPath)),
+          parent: current,
           children: [],
           expanded: depth < 1,
           hasChangedChildren: false,
@@ -178,14 +196,18 @@ export function buildFileTreeFromPaths(
       continue;
     }
 
-    const isDirEntry = normalized.endsWith("/") || isDirectoryPath(filePath);
+    const pathInfo = getPathInfo(filePath);
+    const isDirEntry = normalized.endsWith("/") || pathInfo.isDirectory;
     if (isDirEntry) {
       const depth = parts.length;
       const dirNode: FileNode = {
         name: fileName,
         path: filePath,
         isDirectory: true,
-        children: [],
+        isSymlink: pathInfo.isSymlink,
+        realPath: pathInfo.realPath ?? safeRealPathSync(filePath),
+        parent: current,
+        children: pathInfo.isSymlink ? undefined : [],
         expanded: depth < 1,
         hasChangedChildren: false,
         gitStatus: fileGitStatus,
@@ -202,6 +224,8 @@ export function buildFileTreeFromPaths(
       name: fileName,
       path: filePath,
       isDirectory: false,
+      isSymlink: pathInfo.isSymlink,
+      parent: current,
       gitStatus: fileGitStatus,
       agentModified: agentModified.has(filePath),
       diffStats: fileDiffStats,

package/files-widget/file-viewer.ts

@@ -3,7 +3,7 @@ import { execSync } from "node:child_process";
 import { readFileSync, statSync } from "node:fs";
 
 import { isGitRepo } from "./git";
-import { hasCommand, stripLeadingEmptyLines } from "./utils";
+import { hasCommand, isMarkdownPath, stripLeadingEmptyLines } from "./utils";
 
 const DIFF_CONTENT_PREFIXES = new Set(["+", "-", " "]);
 
@@ -152,14 +152,20 @@ function wrapDeltaLines(lines: string[], width: number): string[] {
   return wrapped;
 }
 
+export interface LoadedFileContent {
+  lines: string[];
+  renderedMarkdown: boolean;
+}
+
 export function loadFileContent(
   filePath: string,
   cwd: string,
   diffMode: boolean,
   hasChanges: boolean,
-  width?: number
-): string[] {
-  const isMarkdown = filePath.endsWith(".md");
+  width?: number,
+  renderMarkdown = true
+): LoadedFileContent {
+  const isMarkdown = isMarkdownPath(filePath);
   const termWidth = width || process.stdout.columns || 80;
 
   try {
@@ -195,7 +201,7 @@ export function loadFileContent(
         }
 
         if (!diffOutput.trim()) {
-          return ["No diff available - file may be untracked or unchanged"];
+          return { lines: ["No diff available - file may be untracked or unchanged"], renderedMarkdown: false };
         }
 
         if (hasCommand("delta")) {
@@ -211,23 +217,23 @@ export function loadFileContent(
                 stdio: ["pipe", "pipe", "pipe"],
               }
             );
-            return wrapDeltaLines(stripLeadingEmptyLines(deltaOutput.split("\n")), termWidth);
+            return { lines: wrapDeltaLines(stripLeadingEmptyLines(deltaOutput.split("\n")), termWidth), renderedMarkdown: false };
           } catch {
             // Fall back to raw diff
           }
         }
 
-        return wrapDiffLines(stripLeadingEmptyLines(diffOutput.split("\n")), termWidth);
+        return { lines: wrapDiffLines(stripLeadingEmptyLines(diffOutput.split("\n")), termWidth), renderedMarkdown: false };
       } catch (e: any) {
-        return [`Diff error: ${e.message}`];
+        return { lines: [`Diff error: ${e.message}`], renderedMarkdown: false };
       }
     }
 
-    if (isMarkdown && hasCommand("glow")) {
+    if (isMarkdown && renderMarkdown && hasCommand("glow")) {
       try {
         const output = execSync(`glow -s dark -w ${termWidth} "${filePath}"`, { encoding: "utf-8", timeout: 10000 });
         if (output.trim()) {
-          return stripLeadingEmptyLines(output.split("\n"));
+          return { lines: stripLeadingEmptyLines(output.split("\n")), renderedMarkdown: true };
         }
       } catch {
         // Fall through to bat
@@ -236,16 +242,22 @@ export function loadFileContent(
 
     if (hasCommand("bat")) {
       try {
-        return execSync(
-          `bat --style=numbers --color=always --paging=never --wrap=auto --terminal-width=${termWidth} "${filePath}"`,
-          { encoding: "utf-8", timeout: 10000 }
-        ).split("\n");
+        return {
+          lines: execSync(
+            `bat --style=numbers --color=always --paging=never --wrap=auto --terminal-width=${termWidth} "${filePath}"`,
+            { encoding: "utf-8", timeout: 10000 }
+          ).split("\n"),
+          renderedMarkdown: false,
+        };
       } catch {
         try {
-          return execSync(
-            `bat --style=numbers --color=always --paging=never --terminal-width=${termWidth} "${filePath}"`,
-            { encoding: "utf-8", timeout: 10000 }
-          ).split("\n");
+          return {
+            lines: execSync(
+              `bat --style=numbers --color=always --paging=never --terminal-width=${termWidth} "${filePath}"`,
+              { encoding: "utf-8", timeout: 10000 }
+            ).split("\n"),
+            renderedMarkdown: false,
+          };
         } catch {
           // Fall through to raw file read
         }
@@ -253,8 +265,11 @@ export function loadFileContent(
     }
 
     const raw = readFileSync(filePath, "utf-8");
-    return raw.split("\n").map((line, i) => `${String(i + 1).padStart(4)} │ ${line}`);
+    return {
+      lines: raw.split("\n").map((line, i) => `${String(i + 1).padStart(4)} │ ${line}`),
+      renderedMarkdown: false,
+    };
   } catch (e: any) {
-    return [`Error loading file: ${e.message}`];
+    return { lines: [`Error loading file: ${e.message}`], renderedMarkdown: false };
   }
 }

package/files-widget/index.ts

@@ -41,10 +41,14 @@ export default function editorExtension(pi: ExtensionAPI): void {
         };
 
         const requestComment = (payload: { relPath: string; lineRange: string; ext: string; selectedText: string }, comment: string) => {
-          pi.sendUserMessage(formatCommentMessage(payload, comment), {
-            deliverAs: "followUp",
-            streamingBehavior: "followUp" as any,
-          } as any);
+          const message = formatCommentMessage(payload, comment);
+          if (ctx.isIdle()) {
+            pi.sendUserMessage(message);
+            ctx.ui.notify(`Comment sent to agent for ${payload.relPath} (${payload.lineRange})`, "success");
+          } else {
+            pi.sendUserMessage(message, { deliverAs: "followUp" });
+            ctx.ui.notify(`Comment queued for agent for ${payload.relPath} (${payload.lineRange})`, "info");
+          }
         };
 
         const requestRender = () => tui.requestRender();

package/files-widget/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmustier/pi-files-widget",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "In-terminal file browser and viewer for Pi.",
   "license": "MIT",
   "author": "Thomas Mustier",

package/files-widget/types.ts

@@ -7,6 +7,9 @@ export interface FileNode {
   name: string;
   path: string;
   isDirectory: boolean;
+  isSymlink?: boolean;
+  realPath?: string;
+  parent?: FileNode;
   children?: FileNode[];
   expanded?: boolean;
   gitStatus?: string;

package/files-widget/utils.ts

@@ -17,6 +17,10 @@ export function isIgnoredStatus(status?: string): boolean {
   return status === "!" || status === "!!";
 }
 
+export function isMarkdownPath(path: string): boolean {
+  return path.toLowerCase().endsWith(".md");
+}
+
 export function stripLeadingEmptyLines(lines: string[]): string[] {
   let startIdx = 0;
   while (startIdx < lines.length && !lines[startIdx].trim()) {

package/files-widget/viewer.ts

@@ -11,7 +11,7 @@ import {
 } from "./constants";
 import { loadFileContent } from "./file-viewer";
 import type { FileNode } from "./types";
-import { isUntrackedStatus } from "./utils";
+import { isMarkdownPath, isUntrackedStatus } from "./utils";
 import { createTextInputBuffer } from "./input-utils";
 
 const COMMENT_EDITOR_MAX_VISIBLE_LINES = 4;
@@ -36,6 +36,7 @@ interface ViewerState {
   rawContent: string;
   scroll: number;
   diffMode: boolean;
+  renderMarkdown: boolean;
   mode: ViewerMode;
   selectStart: number;
   selectEnd: number;
@@ -72,6 +73,7 @@ export function createViewer(
     rawContent: "",
     scroll: 0,
     diffMode: false,
+    renderMarkdown: true,
     mode: "normal",
     selectStart: 0,
     selectEnd: 0,
@@ -84,6 +86,31 @@ export function createViewer(
     height: DEFAULT_VIEWER_HEIGHT,
   };
 
+  function isMarkdownFile(): boolean {
+    return !!state.file && isMarkdownPath(state.file.path);
+  }
+
+  function isRenderedMarkdownMode(): boolean {
+    return isMarkdownFile() && !state.diffMode && state.renderMarkdown;
+  }
+
+  function switchMarkdownToRaw(): boolean {
+    if (!isRenderedMarkdownMode()) return false;
+    state.renderMarkdown = false;
+    const width = state.lastRenderWidth || process.stdout.columns || 80;
+    reloadContent(width);
+    return true;
+  }
+
+  function toggleMarkdownMode(): void {
+    if (!isMarkdownFile() || state.diffMode) return;
+    state.renderMarkdown = !state.renderMarkdown;
+    state.lastRenderWidth = 0;
+    resetSearch();
+    setMode("normal");
+    clampScroll();
+  }
+
   function resetSearch(): void {
     state.searchQuery = "";
     state.searchMatches = [];
@@ -150,7 +177,9 @@ export function createViewer(
     if (!state.file) return;
     refreshRawContent();
     const hasChanges = !!state.file.gitStatus;
-    state.content = loadFileContent(state.file.path, cwd, state.diffMode, hasChanges, width);
+    const result = loadFileContent(state.file.path, cwd, state.diffMode, hasChanges, width, state.renderMarkdown);
+    state.content = result.lines;
+    state.renderMarkdown = result.renderedMarkdown;
     state.lastRenderWidth = width;
     clampScroll();
     if (state.searchQuery) {
@@ -239,6 +268,8 @@ export function createViewer(
       header += theme.fg("dim", " [UNTRACKED]");
     } else if (state.diffMode) {
       header += theme.fg("warning", " [DIFF]");
+    } else if (isMarkdownFile()) {
+      header += theme.fg("accent", state.renderMarkdown ? " [RENDERED]" : " [RAW]");
     }
     if (state.mode === "select" || state.mode === "comment") {
       header += theme.fg("accent", ` [SELECT ${state.selectStart + 1}-${state.selectEnd + 1}]`);
@@ -320,9 +351,10 @@ export function createViewer(
       help = theme.fg("dim", "Type to search  Enter: confirm  Esc: cancel");
     } else {
       const isUntracked = state.file && isUntrackedStatus(state.file.gitStatus);
+      const markdownHelp = isMarkdownFile() && !state.diffMode ? "m: raw/render  " : "";
       help = theme.fg(
         "dim",
-        `j/k: scroll  /: search  n/N: next/prev match  []: files  ${state.file?.gitStatus && !isUntracked ? "d: diff  " : ""}q: back  ${pct}%`
+        `j/k: scroll  /: search  n/N: next/prev match  ${markdownHelp}[]: files  ${state.file?.gitStatus && !isUntracked ? "d: diff  " : ""}q: back  ${pct}%`
       );
     }
     lines.push(truncateToWidth(help, width));
@@ -343,6 +375,7 @@ export function createViewer(
       state.file = file;
       state.scroll = 0;
       state.diffMode = !!file.gitStatus && !isUntrackedStatus(file.gitStatus);
+      state.renderMarkdown = isMarkdownPath(file.path);
       setMode("normal");
       state.content = [];
       state.lastRenderWidth = 0;
@@ -358,6 +391,7 @@ export function createViewer(
       state.file = null;
       state.content = [];
       state.rawContent = "";
+      state.renderMarkdown = true;
       state.lastLoadedMtimeMs = null;
       setMode("normal");
     },
@@ -452,6 +486,7 @@ export function createViewer(
         return { type: "none" };
       }
       if (matchesKey(data, "/") && state.mode !== "select") {
+        switchMarkdownToRaw();
         setMode("search");
         return { type: "none" };
       }
@@ -511,7 +546,14 @@ export function createViewer(
         state.scroll = 0;
         return { type: "none" };
       }
+      if (matchesKey(data, "m") && state.mode !== "select" && state.mode !== "comment") {
+        toggleMarkdownMode();
+        return { type: "none" };
+      }
       if (matchesKey(data, "v") && state.mode !== "select") {
+        if (switchMarkdownToRaw()) {
+          return { type: "none" };
+        }
         state.mode = "select";
         state.selectStart = state.scroll;
         state.selectEnd = state.scroll;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-extensions",
-  "version": "0.1.32",
+  "version": "0.1.34",
   "license": "MIT",
   "private": false,
   "keywords": [