pi-studio 0.9.14 → 0.9.15

package/CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to `pi-studio` are documented here.
 
 ## [Unreleased]
 
+## [0.9.15] — 2026-05-23
+
+### Added
+- Added a first-cut right-pane **Files** view for browsing the current Studio resource directory, opening folders, opening text/code documents in the editor, previewing local PDFs/images, copying paths, and revealing files in the file manager.
+- Added text-file recognition for extensionless/dotfile project files such as `.gitignore`, `.gitattributes`, `.env`, `Dockerfile`, `Makefile`, `Justfile`, `LICENSE`, and `README`.
+
+### Changed
+- The Files view now treats the Pi session directory/resource directory as its navigation root, while opening initially near the active file when applicable.
+- Renamed **Clear editor** to **Reset editor** and clarified that it resets the tab to a fresh blank draft without changing saved files or responses.
+- Browser-tab workspace restoration now uses per-tab session storage instead of shared local storage.
+
+### Fixed
+- Fixed editor-only companion tabs inheriting a Files right-pane state from another Studio tab after opening a document in a new editor.
+
 ## [0.9.14] — 2026-05-22
 
 ### Added
@@ -19,7 +33,7 @@ All notable changes to `pi-studio` are documented here.
 ## [0.9.13] — 2026-05-22
 
 ### Added
-- Added browser-refresh restoration for the Studio editor workspace, plus an explicit **Clear editor** action for discarding the restored browser draft without touching saved files or response history.
+- Added browser-refresh restoration for the Studio editor workspace, plus an explicit **Reset editor** action for discarding the restored browser draft without touching saved files or response history.
 - Added local preview-link handling for rendered document previews and sandboxed HTML previews: local PDF links open in Studio's embedded PDF focus viewer, local image links open in a local image preview, text/code/document links can open in a new editor tab, and right-clicking local links offers **Open here**, **Reveal in file manager**, and **Copy path** where applicable.
 - Brought editor-only Studio closer to full Studio for document-local controls: pane resizing/focus shortcuts now work, and the annotation-header toggle remains available.
 

package/README.md

@@ -23,10 +23,11 @@ Extension for [pi](https://pi.dev) that opens a local two-pane browser workspace
 - Includes a global **Zen** mode for hiding secondary Studio chrome without changing the current left/right pane layout
 - Runs editor text directly, asks for structured critique (auto/writing/code focus), or opens **Quiz me** for a Studio-native active-recall loop over the current editor text, selection, current file, folder, or repo, with optional focus guidance for shaping question selection
 - Includes a live **Working** view for following current model/tool activity, with `All` / `Thinking` / `Tools` filters, image previews for image-producing tool outputs, plus **Load visible into editor** and **Copy visible** actions; when cycling response history, Working follows saved working details for the selected response when available
+- Includes a right-pane **Files** view for browsing the current Pi session/resource directory, opening folders, loading text/code documents into the editor, previewing PDFs/images, copying paths, and revealing files in the file manager
 - Includes an optional tmux-backed **REPL** view for Shell, Python, IPython, Julia, R, GHCi, and Clojure sessions, with Raw/Literate send modes, `Cmd/Ctrl+Shift+Enter` **Send to REPL**, session start/stop/interrupt controls, a compact refresh-persistent **Studio REPL Record** of user and Pi-sent code, a secondary raw tmux mirror, agent-facing `studio_repl_status` / `studio_repl_send` tools, and Markdown/PDF/HTML export
 - Includes a local persistent scratchpad for quick notes you want to keep out of the main editor until you're ready to copy or insert them
 - Includes a docked **Outline** rail for navigating document structure in the current editor text, with clickable entries that jump in the raw editor and reveal matching preview locations when available
-- Restores the current browser-tab editor workspace after refresh and provides an explicit **Clear editor** action when you want to discard the restored draft without changing responses or saved files
+- Restores the current browser-tab editor workspace after refresh and provides an explicit **Reset editor** action when you want to discard the restored draft and return the tab to a fresh blank draft without changing responses or saved files
 - Turns local preview links, including links inside sandboxed HTML previews, into Studio actions: PDFs open in the embedded viewer, text/code/document links can open in a new editor tab, and right-click menus provide **Open here**, **Reveal in file manager**, and **Copy path** for local resources
 - Includes local comments anchored to selections/lines, shown in a docked **Comments** rail, with transient **Comment** / **Jump** actions from raw-editor selections plus editor-preview selections for Markdown, LaTeX, and code/text/diff previews, alongside optional inline `[an: ...]` toggles when you want comments reflected in the document text
 - Browses response history (`Prev/Next/Last`) and loads either:

package/client/studio-client.js

@@ -1955,6 +1955,19 @@
       const DEFAULT_RESPONSE_FONT_SIZE = studioUiRefreshEnabled ? 13.5 : 15;
       let editorFontSize = DEFAULT_EDITOR_FONT_SIZE;
       let responseFontSize = DEFAULT_RESPONSE_FONT_SIZE;
+      let fileBrowserState = {
+        rootDir: "",
+        currentDir: "",
+        relativeDir: "",
+        parentDir: null,
+        entries: [],
+        omitted: 0,
+        omittedIgnored: 0,
+        loading: false,
+        error: "",
+        loaded: false,
+      };
+      let fileBrowserLoadNonce = 0;
       let studioUiRefreshUi = null;
       let studioZenModeEnabled = readStudioZenModeEnabled();
       if (studioUiRefreshEnabled && document.body) {
@@ -4085,6 +4098,12 @@
         }
         if (referenceMetaEl instanceof HTMLElement) referenceMetaEl.hidden = false;
 
+        if (rightView === "files") {
+          const dir = fileBrowserState && fileBrowserState.currentDir ? fileBrowserState.currentDir : (getCurrentResourceDirValue() || "current Studio directory");
+          referenceBadgeEl.textContent = "Files: " + dir;
+          return;
+        }
+
         if (rightView === "trace") {
           const state = traceState || createEmptyTraceState();
           const context = traceDisplayContext || {};
@@ -6645,6 +6664,7 @@
         critiqueViewEl.addEventListener("scroll", handleTracePaneScroll);
         critiqueViewEl.addEventListener("click", handleTracePaneClick);
         critiqueViewEl.addEventListener("click", handleReplPaneClick);
+        critiqueViewEl.addEventListener("click", handleFilesPaneClick);
         critiqueViewEl.addEventListener("change", handleReplPaneChange);
       }
 
@@ -8107,6 +8127,241 @@
         scheduleResponsePaneRepaintNudge();
       }
 
+      function getFileBrowserContextKey() {
+        const context = getHtmlPreviewResourceContextOptions();
+        return String(context.sourcePath || "") + "\n" + String(context.resourceDir || "");
+      }
+
+      function getFileBrowserLocalLinkContext() {
+        return { sourcePath: "", resourceDir: fileBrowserState.rootDir || getCurrentResourceDirValue() || "" };
+      }
+
+      function formatFileBrowserSize(size) {
+        const value = Number(size);
+        if (!Number.isFinite(value) || value < 0) return "";
+        if (value < 1024) return Math.round(value) + " B";
+        if (value < 1024 * 1024) return (value / 1024).toFixed(value < 10 * 1024 ? 1 : 0) + " KB";
+        if (value < 1024 * 1024 * 1024) return (value / (1024 * 1024)).toFixed(value < 10 * 1024 * 1024 ? 1 : 0) + " MB";
+        return (value / (1024 * 1024 * 1024)).toFixed(1) + " GB";
+      }
+
+      function formatFileBrowserTime(ms) {
+        const value = Number(ms);
+        if (!Number.isFinite(value) || value <= 0) return "";
+        try {
+          return new Date(value).toLocaleDateString([], { month: "short", day: "numeric", year: "numeric" });
+        } catch {
+          return "";
+        }
+      }
+
+      function getFileBrowserKindLabel(entry) {
+        if (!entry || entry.type === "directory") return "folder";
+        if (entry.kind === "text") return "document";
+        if (entry.kind === "pdf") return "PDF";
+        if (entry.kind === "image") return "image";
+        return entry.extension ? entry.extension.replace(/^\./, "") : "file";
+      }
+
+      function buildFileBrowserPanelHtml() {
+        const state = fileBrowserState || {};
+        const entries = Array.isArray(state.entries) ? state.entries : [];
+        const currentDir = state.currentDir || "";
+        const rootDir = state.rootDir || "";
+        const relativeDir = state.relativeDir || ".";
+        const parentDisabled = state.parentDir ? "" : " disabled";
+        const rows = entries.length
+          ? entries.map((entry) => {
+            const type = entry.type === "directory" ? "directory" : "file";
+            const kind = entry.kind || (type === "directory" ? "directory" : "other");
+            const icon = type === "directory" ? "📁" : (kind === "pdf" ? "📄" : (kind === "image" ? "🖼️" : (kind === "text" ? "📝" : "📦")));
+            const metaParts = [];
+            metaParts.push(getFileBrowserKindLabel(entry));
+            if (type === "file") metaParts.push(formatFileBrowserSize(entry.size));
+            const time = formatFileBrowserTime(entry.mtimeMs);
+            if (time) metaParts.push(time);
+            const textActions = kind === "text"
+              ? "<button type='button' data-files-action='open-new' data-files-path='" + escapeHtml(entry.path) + "'>New tab</button>"
+              : "";
+            const openTitle = type === "directory"
+              ? "Open folder"
+              : (kind === "text" ? "Open in editor" : (kind === "pdf" ? "Open PDF preview" : (kind === "image" ? "Open image preview" : "Copy or reveal this file")));
+            return "<div class='files-row files-row-" + escapeHtml(type) + " files-kind-" + escapeHtml(kind) + "'>"
+              + "<button type='button' class='files-open-btn' data-files-action='" + (type === "directory" ? "open-dir" : "open") + "' data-files-path='" + escapeHtml(entry.path) + "' data-files-kind='" + escapeHtml(kind) + "' title='" + escapeHtml(openTitle) + "'>"
+              + "<span class='files-icon' aria-hidden='true'>" + icon + "</span>"
+              + "<span class='files-name'>" + escapeHtml(entry.name) + "</span>"
+              + "<span class='files-meta'>" + escapeHtml(metaParts.filter(Boolean).join(" · ")) + "</span>"
+              + "</button>"
+              + "<span class='files-actions'>"
+              + textActions
+              + "<button type='button' data-files-action='copy-path' data-files-path='" + escapeHtml(entry.path) + "'>Copy path</button>"
+              + (type === "file" ? "<button type='button' data-files-action='reveal' data-files-path='" + escapeHtml(entry.path) + "'>Reveal</button>" : "")
+              + "</span>"
+              + "</div>";
+          }).join("")
+          : "<div class='files-empty'>" + (state.loading ? "Loading files…" : "This folder is empty.") + "</div>";
+        const notices = [];
+        if (state.error) notices.push("<div class='files-notice files-notice-error'>" + escapeHtml(state.error) + "</div>");
+        if (state.omitted) notices.push("<div class='files-notice'>" + escapeHtml(String(state.omitted)) + " item" + (state.omitted === 1 ? "" : "s") + " omitted.</div>");
+        if (state.omittedIgnored) notices.push("<div class='files-notice'>" + escapeHtml(String(state.omittedIgnored)) + " heavy/cache folder" + (state.omittedIgnored === 1 ? "" : "s") + " hidden.</div>");
+        return "<div class='files-panel'>"
+          + "<div class='files-toolbar'>"
+          + "<div class='files-path-group'><span class='files-label'>Files</span><span class='files-path' title='" + escapeHtml(currentDir) + "'>" + escapeHtml(relativeDir || ".") + "</span></div>"
+          + "<div class='files-toolbar-actions'>"
+          + "<button type='button' data-files-action='parent'" + parentDisabled + ">Parent</button>"
+          + "<button type='button' data-files-action='refresh'>Refresh</button>"
+          + (rootDir ? "<button type='button' data-files-action='copy-root' data-files-path='" + escapeHtml(rootDir) + "'>Copy root</button>" : "")
+          + "</div>"
+          + "</div>"
+          + "<div class='files-subtitle'>Root: <span title='" + escapeHtml(rootDir) + "'>" + escapeHtml(rootDir || "current Studio directory") + "</span></div>"
+          + notices.join("")
+          + "<div class='files-list' role='list'>" + rows + "</div>"
+          + "</div>";
+      }
+
+      function renderFilesView() {
+        if (!critiqueViewEl) return;
+        const contextKey = getFileBrowserContextKey();
+        if (fileBrowserState.contextKey !== contextKey) {
+          fileBrowserState = {
+            rootDir: "",
+            currentDir: "",
+            relativeDir: "",
+            parentDir: null,
+            entries: [],
+            omitted: 0,
+            omittedIgnored: 0,
+            loading: false,
+            error: "",
+            loaded: false,
+            contextKey,
+          };
+        }
+        finishPreviewRender(critiqueViewEl);
+        critiqueViewEl.innerHTML = buildFileBrowserPanelHtml();
+        critiqueViewEl.classList.remove("response-scroll-resetting");
+        if (!fileBrowserState.loaded && !fileBrowserState.loading) {
+          loadFileBrowserDirectory("");
+        }
+        scheduleResponsePaneRepaintNudge();
+      }
+
+      async function loadFileBrowserDirectory(dir, options) {
+        const context = getHtmlPreviewResourceContextOptions();
+        const contextKey = getFileBrowserContextKey();
+        const nonce = ++fileBrowserLoadNonce;
+        fileBrowserState = {
+          ...fileBrowserState,
+          contextKey,
+          loading: true,
+          error: "",
+        };
+        if (rightView === "files") {
+          finishPreviewRender(critiqueViewEl);
+          critiqueViewEl.innerHTML = buildFileBrowserPanelHtml();
+        }
+        try {
+          const query = {};
+          if (dir) query.dir = String(dir);
+          if (context.sourcePath) query.sourcePath = context.sourcePath;
+          if (context.resourceDir) query.resourceDir = context.resourceDir;
+          const payload = await fetchStudioJson("/file-browser", { query });
+          if (nonce !== fileBrowserLoadNonce) return;
+          fileBrowserState = {
+            rootDir: typeof payload.rootDir === "string" ? payload.rootDir : "",
+            currentDir: typeof payload.currentDir === "string" ? payload.currentDir : "",
+            relativeDir: typeof payload.relativeDir === "string" ? payload.relativeDir : ".",
+            parentDir: typeof payload.parentDir === "string" ? payload.parentDir : null,
+            entries: Array.isArray(payload.entries) ? payload.entries : [],
+            omitted: Number(payload.omitted) || 0,
+            omittedIgnored: Number(payload.omittedIgnored) || 0,
+            loading: false,
+            error: "",
+            loaded: true,
+            contextKey,
+          };
+          if (rightView === "files") {
+            finishPreviewRender(critiqueViewEl);
+            critiqueViewEl.innerHTML = buildFileBrowserPanelHtml();
+            scheduleResponsePaneRepaintNudge();
+          }
+          if (options && options.user) setStatus("Loaded file list.", "success");
+        } catch (error) {
+          if (nonce !== fileBrowserLoadNonce) return;
+          fileBrowserState = {
+            ...fileBrowserState,
+            loading: false,
+            error: (error && error.message) ? error.message : String(error || "Could not load files."),
+            loaded: true,
+          };
+          if (rightView === "files") {
+            finishPreviewRender(critiqueViewEl);
+            critiqueViewEl.innerHTML = buildFileBrowserPanelHtml();
+            scheduleResponsePaneRepaintNudge();
+          }
+        }
+      }
+
+      async function openFileBrowserEntry(path, kind) {
+        const context = getFileBrowserLocalLinkContext();
+        if (kind === "text") {
+          await openPreviewDocumentHere(path, context);
+          return;
+        }
+        if (kind === "pdf") {
+          openPreviewPdfLink(path, path, context);
+          return;
+        }
+        if (kind === "image") {
+          await openPreviewImageLink(path, path, context);
+          return;
+        }
+        setStatus("No Studio preview for this file type. Use Copy path or Reveal.", "warning");
+      }
+
+      async function handleFilesPaneClick(event) {
+        if (rightView !== "files") return;
+        const target = event.target;
+        const actionEl = target instanceof Element ? target.closest("[data-files-action]") : null;
+        if (!actionEl) return;
+        event.preventDefault();
+        const action = actionEl.getAttribute("data-files-action") || "";
+        const path = actionEl.getAttribute("data-files-path") || "";
+        const kind = actionEl.getAttribute("data-files-kind") || getPreviewLocalLinkKind(path);
+        try {
+          if (action === "parent") {
+            if (fileBrowserState.parentDir) await loadFileBrowserDirectory(fileBrowserState.parentDir, { user: true });
+            return;
+          }
+          if (action === "refresh") {
+            await loadFileBrowserDirectory(fileBrowserState.currentDir || "", { user: true });
+            return;
+          }
+          if (action === "open-dir") {
+            await loadFileBrowserDirectory(path, { user: true });
+            return;
+          }
+          if (action === "open") {
+            await openFileBrowserEntry(path, kind);
+            return;
+          }
+          if (action === "open-new") {
+            await openPreviewDocumentInNewEditor(path, null, getFileBrowserLocalLinkContext());
+            return;
+          }
+          if (action === "copy-path" || action === "copy-root") {
+            const ok = await writeTextToClipboard(path);
+            setStatus(ok ? "Copied path." : "Clipboard write failed.", ok ? "success" : "warning");
+            return;
+          }
+          if (action === "reveal") {
+            await revealPreviewLocalLink(path, getFileBrowserLocalLinkContext());
+          }
+        } catch (error) {
+          setStatus((error && error.message) ? error.message : String(error || "File action failed."), "warning");
+        }
+      }
+
       function renderActiveResult() {
         if (rightView === "trace") {
           renderTraceView();
@@ -8118,6 +8373,11 @@
           return;
         }
 
+        if (rightView === "files") {
+          renderFilesView();
+          return;
+        }
+
         if (rightView === "editor-preview") {
           const editorText = prepareEditorTextForPreview(sourceTextEl.value || "");
           if (!editorText.trim()) {
@@ -8192,7 +8452,7 @@
           : normalizeForCompare(sourceTextEl.value);
         const responseLoaded = hasResponse && normalizedEditor === latestResponseNormalized;
         const isCritiqueResponse = hasResponse && latestResponseIsStructuredCritique;
-        const showingAuxiliaryRightPane = rightView === "trace" || rightView === "repl";
+        const showingAuxiliaryRightPane = rightView === "trace" || rightView === "repl" || rightView === "files";
 
         if (responseWrapEl) {
           responseWrapEl.hidden = showingAuxiliaryRightPane;
@@ -8233,6 +8493,8 @@
             : (exportingReplJournal ? "Export record" : "Export right preview");
           if (rightView === "trace") {
             exportPdfBtn.title = "Working view does not support preview export.";
+          } else if (rightView === "files") {
+            exportPdfBtn.title = "Files view does not support preview export.";
           } else if (exportingReplJournal && !replJournalExportEntries.length) {
             exportPdfBtn.title = "No Studio REPL record entries to export for this session yet.";
           } else if (rightView === "markdown") {
@@ -8465,9 +8727,24 @@
         return "source:" + normalized.source + ":" + normalized.label;
       }
 
+      function getWorkspacePersistenceStorage() {
+        try {
+          return window.sessionStorage || null;
+        } catch {
+          return null;
+        }
+      }
+
+      function clearLegacyWorkspacePersistenceStorage() {
+        try {
+          if (window.localStorage) window.localStorage.removeItem(STUDIO_WORKSPACE_STORAGE_KEY);
+        } catch {}
+      }
+
       function readPersistedWorkspaceState() {
         try {
-          const raw = window.localStorage ? window.localStorage.getItem(STUDIO_WORKSPACE_STORAGE_KEY) : null;
+          const storage = getWorkspacePersistenceStorage();
+          const raw = storage ? storage.getItem(STUDIO_WORKSPACE_STORAGE_KEY) : null;
           if (!raw) return null;
           const parsed = JSON.parse(raw);
           if (!parsed || typeof parsed !== "object" || parsed.version !== 1) return null;
@@ -8495,7 +8772,7 @@
           sourceState: normalizeWorkspaceSourceState(sourceState),
           resourceDir: getCurrentResourceDirValue(),
           editorView,
-          rightView,
+          rightView: isEditorOnlyMode ? "editor-preview" : rightView,
           editorLanguage,
           followLatest,
           responseHistoryIndex,
@@ -8509,13 +8786,15 @@
       function persistWorkspaceStateNow() {
         if (!workspacePersistenceReady) return;
         try {
-          if (!window.localStorage) return;
+          const storage = getWorkspacePersistenceStorage();
+          if (!storage) return;
+          clearLegacyWorkspacePersistenceStorage();
           const payload = buildWorkspacePersistencePayload();
           if (payload.text.length > STUDIO_WORKSPACE_MAX_TEXT_CHARS) {
-            window.localStorage.removeItem(STUDIO_WORKSPACE_STORAGE_KEY);
+            storage.removeItem(STUDIO_WORKSPACE_STORAGE_KEY);
             return;
           }
-          window.localStorage.setItem(STUDIO_WORKSPACE_STORAGE_KEY, JSON.stringify(payload));
+          storage.setItem(STUDIO_WORKSPACE_STORAGE_KEY, JSON.stringify(payload));
         } catch {
           // Ignore browser storage failures and quota limits.
         }
@@ -8544,8 +8823,10 @@
           workspacePersistTimer = null;
         }
         try {
-          if (window.localStorage) window.localStorage.removeItem(STUDIO_WORKSPACE_STORAGE_KEY);
+          const storage = getWorkspacePersistenceStorage();
+          if (storage) storage.removeItem(STUDIO_WORKSPACE_STORAGE_KEY);
         } catch {}
+        clearLegacyWorkspacePersistenceStorage();
       }
 
       function applyPersistedWorkspaceState(state) {
@@ -8563,11 +8844,15 @@
           setEditorLanguage(state.editorLanguage.trim());
         }
         editorView = state.editorView === "preview" ? "preview" : "markdown";
-        rightView = state.rightView === "preview"
-          ? "preview"
-          : (state.rightView === "editor-preview"
-            ? "editor-preview"
-            : (state.rightView === "repl" ? "repl" : ((state.rightView === "trace" || state.rightView === "thinking") ? "trace" : "markdown")));
+        rightView = isEditorOnlyMode
+          ? "editor-preview"
+          : (state.rightView === "preview"
+            ? "preview"
+            : (state.rightView === "editor-preview"
+              ? "editor-preview"
+              : (state.rightView === "repl"
+                ? "repl"
+                : (state.rightView === "files" ? "files" : ((state.rightView === "trace" || state.rightView === "thinking") ? "trace" : "markdown")))));
         if (typeof state.followLatest === "boolean") {
           followLatest = state.followLatest;
         }
@@ -8592,7 +8877,7 @@
           setStatus("Studio is busy.", "warning");
           return;
         }
-        const confirmed = window.confirm("Clear the current editor draft in this browser tab? Saved files and responses are not changed.");
+        const confirmed = window.confirm("Reset the editor to a fresh blank draft in this browser tab? Saved files and responses are not changed.");
         if (!confirmed) return;
         const preservedResponseState = {
           responseHistory: Array.isArray(responseHistory) ? responseHistory.slice() : [],
@@ -8634,7 +8919,7 @@
         if (followSelect) followSelect.value = followLatest ? "on" : "off";
         refreshResponseUi();
         persistWorkspaceStateNow();
-        setStatus("Editor cleared. Saved files and responses were not changed.", "success");
+        setStatus("Editor reset to a fresh blank draft. Saved files and responses were not changed.", "success");
       }
 
       function setEditorText(nextText, options) {
@@ -8833,7 +9118,9 @@
             ? "editor-preview"
             : (nextView === "repl"
               ? "repl"
-              : ((nextView === "trace" || nextView === "thinking") ? "trace" : "markdown")));
+              : (nextView === "files"
+                ? "files"
+                : ((nextView === "trace" || nextView === "thinking") ? "trace" : "markdown"))));
         rightViewSelect.value = rightView;
         if (rightView === "trace" && previousView !== "trace") {
           traceAutoScroll = true;
@@ -9173,6 +9460,11 @@
         ".diff", ".patch",
       ]);
       const PREVIEW_LOCAL_IMAGE_LINK_EXTENSIONS = new Set([".png", ".jpg", ".jpeg", ".gif", ".webp"]);
+      const PREVIEW_LOCAL_TEXT_LINK_FILENAMES = new Set([
+        ".dockerignore", ".editorconfig", ".env", ".env.example", ".eslintignore", ".gitattributes",
+        ".gitignore", ".gitmodules", ".npmignore", ".prettierignore", "dockerfile", "gemfile",
+        "justfile", "license", "makefile", "rakefile", "readme",
+      ]);
       let previewLinkMenuEl = null;
       let activePreviewLinkContext = null;
 
@@ -9220,10 +9512,17 @@
         return match ? ("." + match[1].toLowerCase()) : "";
       }
 
+      function getPreviewLocalLinkFilename(href) {
+        const path = stripPreviewLocalLinkUrlSuffix(href).replace(/\\/g, "/");
+        const parts = path.split("/");
+        return (parts.pop() || "").toLowerCase();
+      }
+
       function getPreviewLocalLinkKind(href) {
         const ext = getPreviewLocalLinkExtension(href);
+        const name = getPreviewLocalLinkFilename(href);
         if (ext === ".pdf") return "pdf";
-        if (PREVIEW_LOCAL_TEXT_LINK_EXTENSIONS.has(ext)) return "text";
+        if (PREVIEW_LOCAL_TEXT_LINK_EXTENSIONS.has(ext) || PREVIEW_LOCAL_TEXT_LINK_FILENAMES.has(name)) return "text";
         if (PREVIEW_LOCAL_IMAGE_LINK_EXTENSIONS.has(ext)) return "image";
         return "other";
       }
@@ -9240,9 +9539,11 @@
       function getEffectivePreviewLinkContext(contextOverride) {
         const fallback = getHtmlPreviewResourceContextOptions();
         const context = contextOverride && typeof contextOverride === "object" ? contextOverride : null;
+        const hasSourcePath = Boolean(context && Object.prototype.hasOwnProperty.call(context, "sourcePath"));
+        const hasResourceDir = Boolean(context && Object.prototype.hasOwnProperty.call(context, "resourceDir"));
         return {
-          sourcePath: context && context.sourcePath ? String(context.sourcePath) : (fallback.sourcePath || ""),
-          resourceDir: context && context.resourceDir ? String(context.resourceDir) : (fallback.resourceDir || ""),
+          sourcePath: hasSourcePath ? String(context.sourcePath || "") : (fallback.sourcePath || ""),
+          resourceDir: hasResourceDir ? String(context.resourceDir || "") : (fallback.resourceDir || ""),
         };
       }
 
@@ -17891,7 +18192,7 @@
       renderSourcePreview();
       workspacePersistenceReady = true;
       if (workspaceRestoredFromBrowser) {
-        setStatus("Restored editor workspace from this browser tab. Use Clear editor to discard it.", "success");
+        setStatus("Restored editor workspace from this browser tab. Use Reset editor to discard it.", "success");
       }
       connect();
       } catch (error) {

package/client/studio.css

@@ -2666,6 +2666,148 @@
       flex: 0 0 auto;
     }
 
+    .files-panel {
+      display: flex;
+      flex-direction: column;
+      gap: 10px;
+      color: var(--text);
+      font-family: var(--font-ui);
+      font-size: var(--studio-response-font-size);
+    }
+
+    .files-toolbar {
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      gap: 10px;
+      flex-wrap: wrap;
+      padding: 10px;
+      border: 1px solid var(--border-subtle);
+      border-radius: 10px;
+      background: var(--panel-2);
+    }
+
+    .files-path-group {
+      min-width: 0;
+      display: flex;
+      align-items: baseline;
+      gap: 8px;
+    }
+
+    .files-label {
+      flex: 0 0 auto;
+      font-size: 11px;
+      font-weight: 700;
+      letter-spacing: 0.04em;
+      text-transform: uppercase;
+      color: var(--studio-info-text, var(--muted));
+    }
+
+    .files-path,
+    .files-subtitle span {
+      min-width: 0;
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+      font-family: var(--font-mono);
+    }
+
+    .files-toolbar-actions,
+    .files-actions {
+      display: inline-flex;
+      align-items: center;
+      gap: 6px;
+      flex-wrap: wrap;
+    }
+
+    .files-toolbar-actions button,
+    .files-actions button {
+      padding: 4px 7px;
+      font-size: 11px;
+    }
+
+    .files-subtitle,
+    .files-notice,
+    .files-empty {
+      color: var(--studio-info-text, var(--muted));
+      font-size: 12px;
+    }
+
+    .files-notice-error {
+      color: var(--danger);
+    }
+
+    .files-list {
+      display: grid;
+      gap: 4px;
+    }
+
+    .files-row {
+      display: grid;
+      grid-template-columns: minmax(0, 1fr) auto;
+      align-items: center;
+      gap: 8px;
+      padding: 5px 7px;
+      border: 1px solid var(--border-subtle);
+      border-radius: 9px;
+      background: var(--panel);
+    }
+
+    .files-row:hover {
+      border-color: var(--control-border);
+      background: var(--panel-2);
+    }
+
+    .files-open-btn {
+      display: grid;
+      grid-template-columns: auto minmax(0, 1fr) auto;
+      align-items: center;
+      gap: 8px;
+      min-width: 0;
+      padding: 3px 0;
+      border: 0;
+      background: transparent;
+      color: var(--text);
+      text-align: left;
+      cursor: pointer;
+    }
+
+    .files-open-btn:hover,
+    .files-open-btn:focus-visible {
+      outline: none;
+      color: var(--accent);
+    }
+
+    .files-icon {
+      width: 1.3em;
+      text-align: center;
+    }
+
+    .files-name {
+      min-width: 0;
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+      font-weight: 550;
+    }
+
+    .files-meta {
+      color: var(--studio-info-text, var(--muted));
+      font-size: 11px;
+      white-space: nowrap;
+    }
+
+    @container (max-width: 620px) {
+      .files-row,
+      .files-open-btn {
+        grid-template-columns: minmax(0, 1fr);
+      }
+      .files-actions,
+      .files-meta {
+        justify-self: start;
+      }
+    }
+
     .trace-panel {
       display: flex;
       flex-direction: column;

package/index.ts

@@ -2442,6 +2442,16 @@ const STUDIO_LOCAL_LINK_TEXT_EXTENSIONS = new Set([
 	".diff", ".patch",
 ]);
 const STUDIO_LOCAL_LINK_IMAGE_EXTENSIONS = new Set([".png", ".jpg", ".jpeg", ".gif", ".webp"]);
+const STUDIO_LOCAL_LINK_TEXT_FILENAMES = new Set([
+	".dockerignore", ".editorconfig", ".env", ".env.example", ".eslintignore", ".gitattributes",
+	".gitignore", ".gitmodules", ".npmignore", ".prettierignore", "dockerfile", "gemfile",
+	"justfile", "license", "makefile", "rakefile", "readme",
+]);
+const STUDIO_FILE_BROWSER_MAX_ENTRIES = 500;
+const STUDIO_FILE_BROWSER_IGNORED_DIRS = new Set([
+	".git", "node_modules", ".next", ".cache", "dist", "build", "coverage", "target",
+	"__pycache__", ".venv", "venv", ".mypy_cache", ".pytest_cache", ".ruff_cache",
+]);
 
 type StudioLocalPreviewResourceKind = "pdf" | "text" | "image" | "other";
 
@@ -2454,6 +2464,17 @@ interface StudioLocalPreviewResource {
 	resourceDir: string;
 }
 
+interface StudioFileBrowserEntry {
+	name: string;
+	path: string;
+	type: "directory" | "file";
+	extension: string;
+	kind: StudioLocalPreviewResourceKind | "directory";
+	size: number;
+	mtimeMs: number;
+	hidden: boolean;
+}
+
 function resolveStudioPdfResourcePath(pdfPath: string | undefined, sourcePath: string | undefined, resourceDir: string | undefined, fallbackCwd: string): string {
 	const rawPath = typeof pdfPath === "string" ? pdfPath.trim() : "";
 	if (!rawPath) throw new Error("Missing PDF path.");
@@ -2522,10 +2543,11 @@ function parseStudioLocalPreviewResourcePage(resourcePath: string): number | nul
 	return null;
 }
 
-function getStudioLocalPreviewResourceKind(extension: string): StudioLocalPreviewResourceKind {
+function getStudioLocalPreviewResourceKind(extension: string, filePathOrName?: string): StudioLocalPreviewResourceKind {
 	const ext = extension.toLowerCase();
+	const name = basename(String(filePathOrName || "")).toLowerCase();
 	if (ext === ".pdf") return "pdf";
-	if (STUDIO_LOCAL_LINK_TEXT_EXTENSIONS.has(ext)) return "text";
+	if (STUDIO_LOCAL_LINK_TEXT_EXTENSIONS.has(ext) || STUDIO_LOCAL_LINK_TEXT_FILENAMES.has(name)) return "text";
 	if (STUDIO_LOCAL_LINK_IMAGE_EXTENSIONS.has(ext)) return "image";
 	return "other";
 }
@@ -2563,12 +2585,94 @@ function resolveStudioLocalPreviewResourcePath(
 		filePath: candidateReal,
 		label: rel && rel !== "" ? rel : basename(candidateReal),
 		extension,
-		kind: getStudioLocalPreviewResourceKind(extension),
+		kind: getStudioLocalPreviewResourceKind(extension, candidateReal),
 		page: parseStudioLocalPreviewResourcePage(rawPath),
 		resourceDir: boundaryReal,
 	};
 }
 
+function resolveStudioFileBrowserDirectory(
+	dirPath: string | undefined,
+	sourcePath: string | undefined,
+	resourceDir: string | undefined,
+	fallbackCwd: string,
+): { rootDir: string; currentDir: string; relativeDir: string; parentDir: string | null } {
+	const context = resolveStudioPreviewResourceContext(sourcePath, resourceDir, fallbackCwd);
+	const rootReal = realpathSync(context.boundaryDir);
+	const rawDir = typeof dirPath === "string" ? dirPath.trim() : "";
+	const baseDir = context.baseDir;
+	const requested = rawDir
+		? (isAbsolute(recoverLikelyDroppedLeadingSlashPath(expandHome(rawDir)))
+			? recoverLikelyDroppedLeadingSlashPath(expandHome(rawDir))
+			: resolve(baseDir, recoverLikelyDroppedLeadingSlashPath(expandHome(rawDir))))
+		: baseDir;
+	const currentReal = realpathSync(requested);
+	const currentStat = statSync(currentReal);
+	if (!currentStat.isDirectory()) throw new Error("File browser path does not refer to a directory.");
+	if (!isPathInsideOrEqualDirectory(currentReal, rootReal)) {
+		throw new Error("File browser path must stay within the current Studio resource directory.");
+	}
+	const parent = dirname(currentReal);
+	const parentDir = parent !== currentReal && isPathInsideOrEqualDirectory(parent, rootReal) ? parent : null;
+	const relativeDir = relative(rootReal, currentReal) || ".";
+	return { rootDir: rootReal, currentDir: currentReal, relativeDir, parentDir };
+}
+
+function listStudioFileBrowserDirectory(
+	dirPath: string | undefined,
+	sourcePath: string | undefined,
+	resourceDir: string | undefined,
+	fallbackCwd: string,
+): { rootDir: string; currentDir: string; relativeDir: string; parentDir: string | null; entries: StudioFileBrowserEntry[]; omitted: number; omittedIgnored: number } {
+	const context = resolveStudioFileBrowserDirectory(dirPath, sourcePath, resourceDir, fallbackCwd);
+	const entries: StudioFileBrowserEntry[] = [];
+	let omitted = 0;
+	let omittedIgnored = 0;
+	const dirents = readdirSync(context.currentDir, { withFileTypes: true });
+	for (const dirent of dirents) {
+		const name = dirent.name;
+		if (STUDIO_FILE_BROWSER_IGNORED_DIRS.has(name)) {
+			omittedIgnored += 1;
+			continue;
+		}
+		const candidate = join(context.currentDir, name);
+		try {
+			const real = realpathSync(candidate);
+			if (!isPathInsideOrEqualDirectory(real, context.rootDir)) {
+				omitted += 1;
+				continue;
+			}
+			const stat = statSync(real);
+			if (!stat.isDirectory() && !stat.isFile()) {
+				omitted += 1;
+				continue;
+			}
+			const type = stat.isDirectory() ? "directory" : "file";
+			const extension = type === "file" ? extname(real).toLowerCase() : "";
+			entries.push({
+				name,
+				path: real,
+				type,
+				extension,
+				kind: type === "directory" ? "directory" : getStudioLocalPreviewResourceKind(extension, real),
+				size: stat.size,
+				mtimeMs: stat.mtimeMs,
+				hidden: name.startsWith("."),
+			});
+		} catch {
+			omitted += 1;
+		}
+	}
+	entries.sort((a, b) => {
+		if (a.type !== b.type) return a.type === "directory" ? -1 : 1;
+		if (a.hidden !== b.hidden) return a.hidden ? 1 : -1;
+		return a.name.localeCompare(b.name, undefined, { sensitivity: "base", numeric: true });
+	});
+	const limitedEntries = entries.slice(0, STUDIO_FILE_BROWSER_MAX_ENTRIES);
+	omitted += Math.max(0, entries.length - limitedEntries.length);
+	return { ...context, entries: limitedEntries, omitted, omittedIgnored };
+}
+
 function resolveStudioHtmlPreviewResourcePath(
 	resourcePath: string | undefined,
 	sourcePath: string | undefined,
@@ -8958,7 +9062,7 @@ function resolveRequestedStudioDocumentFromUrl(
 				label: requestedLabel || file.label,
 				source: "file",
 				path: file.resolvedPath,
-				resourceDir: requestedResourceDir || dirname(file.resolvedPath),
+				resourceDir: requestedResourceDir || fallback?.resourceDir || studioCwd,
 			};
 		}
 	}
@@ -9314,7 +9418,7 @@ ${cssVarsBlock}
       <button id="saveAsBtn" type="button" title="Save editor content to a new file path. Cmd/Ctrl+S falls back here when no direct save path is available.">Save editor as…</button>
       <button id="saveOverBtn" type="button" title="Overwrite current file with editor content. Shortcut: Cmd/Ctrl+S.">Save editor</button>
       <button id="refreshFromDiskBtn" type="button" title="Reload the current file-backed document from disk.">Refresh from disk</button>
-      <button id="clearWorkspaceBtn" type="button" title="Clear the current editor draft in this browser tab. Saved files and responses are not changed.">Clear editor</button>
+      <button id="clearWorkspaceBtn" type="button" title="Clear editor text and reset this tab to a fresh blank draft. Saved files and responses are not changed.">Reset editor</button>
       <label class="file-label" title="Load a local file into editor text.">Load file content<input id="fileInput" type="file" accept=".md,.markdown,.mdx,.qmd,.js,.mjs,.cjs,.jsx,.ts,.mts,.cts,.tsx,.py,.pyw,.sh,.bash,.zsh,.json,.jsonc,.json5,.rs,.c,.h,.cpp,.cxx,.cc,.hpp,.hxx,.jl,.f90,.f95,.f03,.f,.for,.r,.R,.m,.tex,.latex,.diff,.patch,.java,.go,.rb,.swift,.html,.htm,.css,.xml,.yaml,.yml,.toml,.lua,.txt,.rst,.adoc" /></label>
       <button id="loadGitDiffBtn" type="button" title="Load the current git diff from the Studio context into the editor.">Load git diff</button>
       <button id="getEditorBtn" type="button" title="Load the current terminal editor draft into Studio.">Load from pi editor</button>
@@ -9508,6 +9612,7 @@ ${cssVarsBlock}
             <option value="preview" selected>Response (Preview)</option>
             <option value="editor-preview">Editor (Preview)</option>
             <option value="trace">Working</option>
+            <option value="files">Files</option>
             <option value="repl">REPL</option>
           </select>
         </div>
@@ -12677,6 +12782,34 @@ export default function (pi: ExtensionAPI) {
 			return;
 		}
 
+		if (requestUrl.pathname === "/file-browser") {
+			const token = requestUrl.searchParams.get("token") ?? "";
+			if (token !== serverState.token) {
+				respondJson(res, 403, { ok: false, error: "Invalid or expired studio token. Re-run /studio." });
+				return;
+			}
+
+			const method = (req.method ?? "GET").toUpperCase();
+			if (method !== "GET" && method !== "HEAD") {
+				res.setHeader("Allow", "GET, HEAD");
+				respondJson(res, 405, { ok: false, error: "Method not allowed. Use GET." });
+				return;
+			}
+
+			try {
+				const listing = listStudioFileBrowserDirectory(
+					requestUrl.searchParams.get("dir") ?? undefined,
+					requestUrl.searchParams.get("sourcePath") ?? undefined,
+					requestUrl.searchParams.get("resourceDir") ?? undefined,
+					studioCwd,
+				);
+				respondJson(res, 200, { ok: true, ...listing, entries: method === "HEAD" ? [] : listing.entries });
+			} catch (error) {
+				respondJson(res, 404, { ok: false, error: `File browser unavailable: ${error instanceof Error ? error.message : String(error)}` });
+			}
+			return;
+		}
+
 		if (requestUrl.pathname === "/local-preview-link") {
 			const token = requestUrl.searchParams.get("token") ?? "";
 			if (token !== serverState.token) {
@@ -13377,7 +13510,7 @@ export default function (pi: ExtensionAPI) {
 			label: file.label,
 			source: "file",
 			path: file.resolvedPath,
-			resourceDir: dirname(file.resolvedPath),
+			resourceDir: ctx.cwd,
 		};
 	};
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-studio",
-  "version": "0.9.14",
+  "version": "0.9.15",
   "description": "Two-pane browser workspace for pi with prompt/response editing, annotations, critiques, active quiz, prompt/response history, live previews, and tmux-backed REPL/literate REPL workflows",
   "type": "module",
   "license": "MIT",