pi-studio 0.9.8 → 0.9.10

package/CHANGELOG.md

@@ -4,6 +4,17 @@ All notable changes to `pi-studio` are documented here.
 
 ## [Unreleased]
 
+## [0.9.10] — 2026-05-19
+
+### Added
+- Added keyboard shortcuts for Studio pane navigation: F6 switches panes, F7/Shift+F7 cycles the active pane view, F8 focuses editor text, Shift+F8 focuses right-pane content, F9 toggles Zen mode, and F10 keeps pane focus/unfocus.
+- Added a compact **Shortcuts (?)** footer button with a keyboard-shortcuts overlay; `?` opens it when focus is not in a text-entry field.
+
+## [0.9.9] — 2026-05-19
+
+### Fixed
+- In SSH-launched Studio sessions, copy actions now use the local browser clipboard instead of writing to the remote host clipboard.
+
 ## [0.9.8] — 2026-05-19
 
 ### Fixed

package/client/studio-client.js

@@ -119,6 +119,10 @@
       const editorFontSizeSelect = document.getElementById("editorFontSizeSelect");
       const annotationModeSelect = document.getElementById("annotationModeSelect");
       const compactBtn = document.getElementById("compactBtn");
+      const shortcutsBtn = document.getElementById("shortcutsBtn");
+      const shortcutsOverlayEl = document.getElementById("shortcutsOverlay");
+      const shortcutsDialogEl = document.getElementById("shortcutsDialog");
+      const shortcutsCloseBtn = document.getElementById("shortcutsCloseBtn");
       const leftFocusBtn = document.getElementById("leftFocusBtn");
       const rightFocusBtn = document.getElementById("rightFocusBtn");
       const reviewNotesBtn = document.getElementById("reviewNotesBtn");
@@ -156,6 +160,7 @@
         ? "editor-only"
         : "full";
       const isEditorOnlyMode = studioMode === "editor-only";
+      const isSshStudioSession = Boolean(document.body && document.body.dataset && document.body.dataset.sshSession === "1");
 
       const initialQueryParams = new URLSearchParams(window.location.search || "");
       const explicitDocumentIdentityFromUrl = initialQueryParams.has("docId")
@@ -846,16 +851,18 @@
       async function writeTextToClipboard(text) {
         const content = String(text || "");
 
-        try {
-          await fetchStudioJson("/clipboard", {
-            method: "POST",
-            body: JSON.stringify({ text: content }),
-          });
-          return true;
-        } catch {
-          // Fall back to browser clipboard APIs. The server-side clipboard path
-          // is most reliable for local Studio, but may be unavailable over SSH
-          // or on systems without a clipboard command.
+        if (!isSshStudioSession) {
+          try {
+            await fetchStudioJson("/clipboard", {
+              method: "POST",
+              body: JSON.stringify({ text: content }),
+            });
+            return true;
+          } catch {
+            // Fall back to browser clipboard APIs. The server-side clipboard path
+            // is most reliable for local Studio, but may be unavailable on systems
+            // without a clipboard command.
+          }
         }
 
         // Prefer a copy-event payload first. It runs synchronously inside the
@@ -1902,7 +1909,7 @@
         if (document.body) document.body.classList.toggle("studio-zen-mode", studioZenModeEnabled);
         if (!zenModeBtn) return;
         zenModeBtn.textContent = studioZenModeEnabled ? "Exit Zen" : "Zen";
-        zenModeBtn.title = studioZenModeEnabled ? "Show full Studio controls." : "Hide secondary Studio controls.";
+        zenModeBtn.title = studioZenModeEnabled ? "Show full Studio controls. Shortcut: F9." : "Hide secondary Studio controls. Shortcut: F9.";
         zenModeBtn.setAttribute("aria-pressed", studioZenModeEnabled ? "true" : "false");
       }
 
@@ -3081,6 +3088,110 @@
         }
       }
 
+      function focusPaneViewControl(pane) {
+        const control = pane === "right" ? rightViewSelect : editorViewSelect;
+        if (!control || control.disabled || control.hidden) return false;
+        try {
+          control.focus({ preventScroll: true });
+        } catch {
+          try { control.focus(); } catch { return false; }
+        }
+        return true;
+      }
+
+      function activatePaneFromShortcut(nextPane) {
+        const pane = nextPane === "right" ? "right" : "left";
+        if (isEditorOnlyMode && pane === "right") {
+          setStatus("Only the editor pane is available in editor-only Studio.", "warning");
+          return;
+        }
+        const snapshot = snapshotStudioScrollablePositions();
+        setActivePane(pane);
+        scheduleStudioScrollablePositionRestore(snapshot);
+        focusPaneViewControl(pane);
+        setStatus("Active pane: " + paneLabel(pane) + ". F7 cycles this pane's view.");
+      }
+
+      function getSelectEnabledValues(selectEl) {
+        if (!selectEl || !selectEl.options) return [];
+        return Array.from(selectEl.options)
+          .filter((option) => option && !option.disabled)
+          .map((option) => option.value)
+          .filter((value) => typeof value === "string" && value);
+      }
+
+      function getCycledSelectValue(selectEl, currentValue, direction) {
+        const values = getSelectEnabledValues(selectEl);
+        if (!values.length) return null;
+        const currentIndex = values.indexOf(currentValue);
+        const startIndex = currentIndex >= 0 ? currentIndex : 0;
+        const step = direction < 0 ? -1 : 1;
+        return values[(startIndex + step + values.length) % values.length];
+      }
+
+      function focusEditorTextFromShortcut() {
+        const snapshot = snapshotStudioScrollablePositions();
+        setActivePane("left");
+        if (editorView !== "markdown") setEditorView("markdown");
+        scheduleStudioScrollablePositionRestore(snapshot);
+        window.setTimeout(() => {
+          if (sourceTextEl && typeof sourceTextEl.focus === "function") {
+            try {
+              sourceTextEl.focus({ preventScroll: true });
+            } catch {
+              try { sourceTextEl.focus(); } catch {}
+            }
+          }
+        }, 0);
+        setStatus("Editor text focused.");
+      }
+
+      function focusRightContentFromShortcut() {
+        if (isEditorOnlyMode) {
+          setStatus("Only the editor pane is available in editor-only Studio.", "warning");
+          return;
+        }
+        const snapshot = snapshotStudioScrollablePositions();
+        setActivePane("right");
+        scheduleStudioScrollablePositionRestore(snapshot);
+        window.setTimeout(() => {
+          if (critiqueViewEl && typeof critiqueViewEl.focus === "function") {
+            if (!critiqueViewEl.hasAttribute("tabindex")) critiqueViewEl.setAttribute("tabindex", "-1");
+            try {
+              critiqueViewEl.focus({ preventScroll: true });
+            } catch {
+              try { critiqueViewEl.focus(); } catch {}
+            }
+          }
+        }, 0);
+        setStatus("Right pane content focused.");
+      }
+
+      function cycleActivePaneView(direction) {
+        if (activePane === "right") {
+          if (isEditorOnlyMode || !rightViewSelect || rightViewSelect.disabled) {
+            setStatus("The right-pane view selector is unavailable.", "warning");
+            return;
+          }
+          const nextView = getCycledSelectValue(rightViewSelect, rightView, direction);
+          if (!nextView) return;
+          setRightView(nextView);
+          focusPaneViewControl("right");
+          setStatus("Right pane view: " + (rightViewSelect.selectedOptions && rightViewSelect.selectedOptions[0] ? rightViewSelect.selectedOptions[0].textContent : nextView) + ".");
+          return;
+        }
+
+        if (!editorViewSelect || editorViewSelect.disabled) {
+          setStatus("The editor view selector is unavailable.", "warning");
+          return;
+        }
+        const nextView = getCycledSelectValue(editorViewSelect, editorView, direction);
+        if (!nextView) return;
+        setEditorView(nextView);
+        focusPaneViewControl("left");
+        setStatus("Editor view: " + (editorViewSelect.selectedOptions && editorViewSelect.selectedOptions[0] ? editorViewSelect.selectedOptions[0].textContent : nextView) + ".");
+      }
+
       function paneLabel(pane) {
         if (pane === "right") {
           return "Response";
@@ -3128,6 +3239,17 @@
         return false;
       }
 
+      function isTextEntryShortcutTarget(target) {
+        if (!(target instanceof Element)) return false;
+        const editable = target.closest("input, textarea, select, [contenteditable]");
+        if (!editable) return false;
+        if (editable.hasAttribute && editable.hasAttribute("contenteditable")) {
+          const value = String(editable.getAttribute("contenteditable") || "").toLowerCase();
+          return value !== "false";
+        }
+        return true;
+      }
+
       function handlePaneShortcut(event) {
         if (!event || event.defaultPrevented) return;
 
@@ -3155,6 +3277,12 @@
           && typeof outlineDialogEl.contains === "function"
           && outlineDialogEl.contains(event.target)
         );
+        const shortcutsOwnsEvent = Boolean(
+          shortcutsDialogEl
+          && event.target
+          && typeof shortcutsDialogEl.contains === "function"
+          && shortcutsDialogEl.contains(event.target)
+        );
         const pdfFocusOwnsEvent = Boolean(
           studioPdfFocusDialogEl
           && event.target
@@ -3198,6 +3326,12 @@
           return;
         }
 
+        if (isShortcutsOpen() && plainEscape) {
+          event.preventDefault();
+          closeShortcuts();
+          return;
+        }
+
         if (isReviewNotesOpen() && plainEscape) {
           event.preventDefault();
           closeReviewNotes();
@@ -3210,7 +3344,46 @@
           return;
         }
 
-        if (scratchpadOwnsEvent || reviewNotesOwnsEvent || outlineOwnsEvent || pdfFocusOwnsEvent || htmlFocusOwnsEvent || quizOwnsEvent) {
+        if (scratchpadOwnsEvent || reviewNotesOwnsEvent || outlineOwnsEvent || shortcutsOwnsEvent || pdfFocusOwnsEvent || htmlFocusOwnsEvent || quizOwnsEvent) {
+          return;
+        }
+
+        if ((key === "?" || (key === "/" && event.shiftKey)) && !event.metaKey && !event.ctrlKey && !event.altKey && !isTextEntryShortcutTarget(event.target)) {
+          event.preventDefault();
+          toggleShortcuts();
+          return;
+        }
+
+        const isPaneSwitchShortcut = key === "F6" && !event.metaKey && !event.ctrlKey && !event.altKey;
+        if (isPaneSwitchShortcut) {
+          event.preventDefault();
+          activatePaneFromShortcut(activePane === "right" ? "left" : "right");
+          return;
+        }
+
+        const isViewCycleShortcut = key === "F7" && !event.metaKey && !event.ctrlKey && !event.altKey;
+        if (isViewCycleShortcut) {
+          event.preventDefault();
+          cycleActivePaneView(event.shiftKey ? -1 : 1);
+          return;
+        }
+
+        const isContentFocusShortcut = key === "F8" && !event.metaKey && !event.ctrlKey && !event.altKey;
+        if (isContentFocusShortcut) {
+          event.preventDefault();
+          if (event.shiftKey) {
+            focusRightContentFromShortcut();
+          } else {
+            focusEditorTextFromShortcut();
+          }
+          return;
+        }
+
+        const isZenModeShortcut = key === "F9" && !event.metaKey && !event.ctrlKey && !event.altKey && !event.shiftKey;
+        if (isZenModeShortcut) {
+          event.preventDefault();
+          setStudioZenMode(!studioZenModeEnabled);
+          setStatus(studioZenModeEnabled ? "Zen mode on." : "Zen mode off.");
           return;
         }
 
@@ -9136,6 +9309,10 @@
         persistStoredToggle(ANNOTATION_MODE_STORAGE_KEY, enabled);
       }
 
+      function isShortcutsOpen() {
+        return Boolean(shortcutsOverlayEl && !shortcutsOverlayEl.hidden);
+      }
+
       function isScratchpadOpen() {
         return Boolean(scratchpadOverlayEl && !scratchpadOverlayEl.hidden);
       }
@@ -9149,7 +9326,7 @@
       }
 
       function syncModalOpenState() {
-        document.body.classList.toggle("scratchpad-open", isScratchpadOpen());
+        document.body.classList.toggle("scratchpad-open", isScratchpadOpen() || isShortcutsOpen());
       }
 
       function describeStudioDocument(state) {
@@ -13345,6 +13522,41 @@
         updateScratchpadUi();
       }
 
+      function closeShortcuts(options) {
+        if (!shortcutsOverlayEl || shortcutsOverlayEl.hidden) return;
+        shortcutsOverlayEl.hidden = true;
+        syncModalOpenState();
+        const focusTarget = options && Object.prototype.hasOwnProperty.call(options, "focusTarget")
+          ? options.focusTarget
+          : (shortcutsBtn || sourceTextEl);
+        if (focusTarget && typeof focusTarget.focus === "function") {
+          const schedule = typeof window.requestAnimationFrame === "function"
+            ? window.requestAnimationFrame.bind(window)
+            : (cb) => window.setTimeout(cb, 16);
+          schedule(() => focusTarget.focus());
+        }
+      }
+
+      function openShortcuts() {
+        if (!shortcutsOverlayEl) return;
+        if (isScratchpadOpen()) closeScratchpad({ focusTarget: null });
+        if (isReviewNotesOpen()) closeReviewNotes({ focusTarget: null });
+        if (isOutlineOpen()) closeOutline({ focusTarget: null });
+        shortcutsOverlayEl.hidden = false;
+        syncModalOpenState();
+        const schedule = typeof window.requestAnimationFrame === "function"
+          ? window.requestAnimationFrame.bind(window)
+          : (cb) => window.setTimeout(cb, 16);
+        schedule(() => {
+          if (shortcutsCloseBtn && typeof shortcutsCloseBtn.focus === "function") shortcutsCloseBtn.focus();
+        });
+      }
+
+      function toggleShortcuts() {
+        if (isShortcutsOpen()) closeShortcuts({ focusTarget: shortcutsBtn || sourceTextEl });
+        else openShortcuts();
+      }
+
       function closeScratchpad(options) {
         if (!scratchpadOverlayEl || scratchpadOverlayEl.hidden) return;
         scratchpadOverlayEl.hidden = true;
@@ -15696,6 +15908,26 @@
         });
       }
 
+      if (shortcutsBtn) {
+        shortcutsBtn.addEventListener("click", () => {
+          toggleShortcuts();
+        });
+      }
+
+      if (shortcutsCloseBtn) {
+        shortcutsCloseBtn.addEventListener("click", () => {
+          closeShortcuts();
+        });
+      }
+
+      if (shortcutsOverlayEl) {
+        shortcutsOverlayEl.addEventListener("click", (event) => {
+          if (event.target === shortcutsOverlayEl) {
+            closeShortcuts();
+          }
+        });
+      }
+
       if (scratchpadBtn) {
         scratchpadBtn.addEventListener("click", () => {
           openScratchpad();

package/client/studio.css

@@ -3326,15 +3326,26 @@
       grid-area: hint;
       justify-self: end;
       align-self: center;
+      display: inline-flex;
+      align-items: center;
+      gap: 6px;
+      padding: 4px 8px;
+      border-radius: 999px;
+      border: 1px solid transparent;
+      background: transparent;
       color: var(--studio-footer-text, var(--muted));
       font-size: 11px;
+      line-height: 1.2;
       white-space: nowrap;
-      text-align: right;
-      font-style: normal;
-      opacity: 0.86;
-      display: inline-flex;
-      align-items: center;
-      gap: 8px;
+      opacity: 0.9;
+    }
+
+    .shortcut-hint:not(:disabled):hover,
+    .shortcut-hint:focus-visible {
+      background: var(--panel-2);
+      border-color: var(--control-border);
+      color: var(--text);
+      opacity: 1;
     }
 
     .footer-compact-btn {
@@ -3369,7 +3380,8 @@
       overflow: hidden;
     }
 
-    .scratchpad-overlay {
+    .scratchpad-overlay,
+    .shortcuts-overlay {
       position: fixed;
       inset: 0;
       z-index: 50;
@@ -3381,10 +3393,28 @@
       backdrop-filter: blur(2px);
     }
 
-    .scratchpad-overlay[hidden] {
+    .scratchpad-overlay[hidden],
+    .shortcuts-overlay[hidden] {
       display: none !important;
     }
 
+    .scratchpad-dialog,
+    .shortcuts-dialog {
+      width: min(860px, 100%);
+      max-height: min(82vh, 900px);
+      border: 1px solid var(--panel-border);
+      border-radius: 14px;
+      background: var(--panel);
+      box-shadow: 0 18px 50px var(--shadow-color);
+      display: flex;
+      flex-direction: column;
+      overflow: hidden;
+    }
+
+    .shortcuts-dialog {
+      width: min(720px, 100%);
+    }
+
     .scratchpad-dialog {
       width: min(860px, 100%);
       max-height: min(82vh, 900px);
@@ -3397,7 +3427,8 @@
       overflow: hidden;
     }
 
-    .scratchpad-header {
+    .scratchpad-header,
+    .shortcuts-header {
       display: flex;
       align-items: flex-start;
       justify-content: space-between;
@@ -3407,18 +3438,21 @@
       background: var(--scratchpad-header-bg, var(--panel-2));
     }
 
-    .scratchpad-header > div {
+    .scratchpad-header > div,
+    .shortcuts-header > div {
       flex: 1 1 auto;
       min-width: 0;
     }
 
-    .scratchpad-header h2 {
+    .scratchpad-header h2,
+    .shortcuts-header h2 {
       margin: 0;
       font-size: 17px;
       font-weight: 600;
     }
 
-    .scratchpad-description {
+    .scratchpad-description,
+    .shortcuts-description {
       margin: 6px 0 0;
       font-size: 12px;
       line-height: 1.45;
@@ -3426,12 +3460,60 @@
       max-width: none;
     }
 
-    .scratchpad-close-btn {
+    .scratchpad-close-btn,
+    .shortcuts-close-btn {
       padding: 6px 10px;
       line-height: 1;
       flex: 0 0 auto;
     }
 
+    .shortcuts-body {
+      display: grid;
+      gap: 14px;
+      padding: 16px 18px 18px;
+      overflow: auto;
+      background: var(--panel);
+    }
+
+    .shortcuts-group h3 {
+      margin: 0 0 8px;
+      font-size: 12px;
+      font-weight: 700;
+      color: var(--studio-info-text, var(--muted));
+      text-transform: uppercase;
+      letter-spacing: 0.04em;
+    }
+
+    .shortcuts-group dl {
+      display: grid;
+      gap: 6px;
+      margin: 0;
+    }
+
+    .shortcuts-group dl > div {
+      display: grid;
+      grid-template-columns: minmax(130px, max-content) minmax(0, 1fr);
+      gap: 12px;
+      align-items: baseline;
+      padding: 6px 0;
+      border-top: 1px solid var(--border-subtle);
+    }
+
+    .shortcuts-group dt {
+      margin: 0;
+      font-family: var(--font-mono);
+      font-size: 12px;
+      color: var(--text);
+      white-space: nowrap;
+    }
+
+    .shortcuts-group dd {
+      margin: 0;
+      color: var(--studio-info-text, var(--muted));
+      font-size: 12px;
+      line-height: 1.35;
+    }
+
     .scratchpad-textarea {
       width: 100%;
       min-height: 280px;

package/index.ts

@@ -8646,6 +8646,7 @@ function buildStudioHtml(
 	const clientScriptHref = `/studio-client.js?token=${encodeURIComponent(studioToken ?? "")}`;
 	const faviconHref = buildStudioFaviconDataUri(style);
 	const bootConfigJson = JSON.stringify({ mermaidConfig }).replace(/</g, "\\u003c");
+	const initialSshSession = isSshSession() ? "1" : "0";
 	const isEditorOnlyMode = studioMode === "editor-only";
 	const appTitle = isEditorOnlyMode ? "π Studio — Editor" : "π Studio";
 	const appSubtitle = isEditorOnlyMode ? "Editor Workspace" : "Editor & Response Workspace";
@@ -8664,7 +8665,7 @@ ${cssVarsBlock}
   </style>
   <link rel="stylesheet" href="${stylesheetHref}" />
 </head>
-<body data-initial-source="${initialSource}" data-initial-label="${initialLabel}" data-initial-path="${initialPath}" data-initial-draft-id="${initialDraftId}" data-initial-resource-dir="${initialResourceDir}" data-model-label="${initialModel}" data-terminal-label="${initialTerminal}" data-terminal-detail="${initialTerminalDetailAttr}" data-context-tokens="${initialContextTokens}" data-context-window="${initialContextWindow}" data-context-percent="${initialContextPercent}" data-studio-mode="${studioMode}">
+<body data-initial-source="${initialSource}" data-initial-label="${initialLabel}" data-initial-path="${initialPath}" data-initial-draft-id="${initialDraftId}" data-initial-resource-dir="${initialResourceDir}" data-model-label="${initialModel}" data-terminal-label="${initialTerminal}" data-terminal-detail="${initialTerminalDetailAttr}" data-context-tokens="${initialContextTokens}" data-context-window="${initialContextWindow}" data-context-percent="${initialContextPercent}" data-studio-mode="${studioMode}" data-ssh-session="${initialSshSession}">
   <header>
     <h1><span class="app-logo" aria-hidden="true">π</span> Studio <span class="app-subtitle">${appSubtitle}</span></h1>
     <div class="controls">
@@ -8674,7 +8675,7 @@ ${cssVarsBlock}
       <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>
-      <button id="zenModeBtn" class="zen-mode-btn" type="button" title="Hide secondary Studio controls.">Zen</button>
+      <button id="zenModeBtn" class="zen-mode-btn" type="button" title="Hide secondary Studio controls. Shortcut: F9.">Zen</button>
     </div>
   </header>
 
@@ -8682,7 +8683,7 @@ ${cssVarsBlock}
     <section id="leftPane">
       <div id="leftSectionHeader" class="section-header">
         <div class="section-header-main">
-          <select id="editorViewSelect" aria-label="Editor view mode">
+          <select id="editorViewSelect" aria-label="Editor view mode" title="Editor view mode. Shortcut: F7 when the editor pane is active; F6 switches panes.">
             <option value="markdown" selected>Editor (Raw)</option>
             <option value="preview">Editor (Preview)</option>
           </select>
@@ -8857,7 +8858,7 @@ ${cssVarsBlock}
     <section id="rightPane">
       <div id="rightSectionHeader" class="section-header">
         <div class="section-header-main">
-          <select id="rightViewSelect" aria-label="Response view mode">
+          <select id="rightViewSelect" aria-label="Response view mode" title="Right pane view mode. Shortcut: F7 when the right pane is active; F6 switches panes.">
             <option value="markdown">Response (Raw)</option>
             <option value="preview" selected>Response (Preview)</option>
             <option value="editor-preview">Editor (Preview)</option>
@@ -8928,9 +8929,50 @@ ${cssVarsBlock}
   <footer>
     <span id="statusLine"><span id="statusSpinner" aria-hidden="true"> </span><span id="status">Booting studio…</span></span>
     <span id="footerMeta" class="footer-meta"><span id="footerMetaText" class="footer-meta-text"><span id="footerMetaModel" class="footer-meta-part footer-meta-model">${initialModel}</span><span class="footer-meta-sep">·</span><span id="footerMetaTerminal" class="footer-meta-part footer-meta-terminal">${initialTerminal}</span><span class="footer-meta-sep">·</span><span id="footerMetaContext" class="footer-meta-part footer-meta-context">unknown</span></span><button id="compactBtn" class="footer-compact-btn" type="button" title="Trigger pi context compaction now.">Compact</button></span>
-    <span class="shortcut-hint">Focus pane: F10 (or Cmd/Ctrl+Esc) to toggle · Save editor: Cmd/Ctrl+S · Run / queue steering: Cmd/Ctrl+Enter · Stop request: Esc</span>
+    <button id="shortcutsBtn" class="shortcut-hint" type="button" title="Show Studio keyboard shortcuts. Press ? when not editing text.">Shortcuts (?)</button>
   </footer>
 
+  <div id="shortcutsOverlay" class="shortcuts-overlay" hidden>
+    <div id="shortcutsDialog" class="shortcuts-dialog" role="dialog" aria-modal="true" aria-labelledby="shortcutsTitle">
+      <div class="shortcuts-header">
+        <div>
+          <h2 id="shortcutsTitle">Keyboard shortcuts</h2>
+          <p class="shortcuts-description">Studio navigation and high-frequency actions.</p>
+        </div>
+        <button id="shortcutsCloseBtn" class="shortcuts-close-btn" type="button" aria-label="Close keyboard shortcuts">Close</button>
+      </div>
+      <div class="shortcuts-body">
+        <section class="shortcuts-group">
+          <h3>Navigation</h3>
+          <dl>
+            <div><dt>F6</dt><dd>Switch between editor and right pane</dd></div>
+            <div><dt>F7 / Shift+F7</dt><dd>Cycle the active pane's view</dd></div>
+            <div><dt>F8</dt><dd>Focus editor text</dd></div>
+            <div><dt>Shift+F8</dt><dd>Focus right-pane content</dd></div>
+            <div><dt>F9</dt><dd>Toggle Zen mode</dd></div>
+            <div><dt>F10</dt><dd>Focus or unfocus the active pane</dd></div>
+            <div><dt>Esc</dt><dd>Close overlays, exit pane focus, or stop an active request</dd></div>
+            <div><dt>?</dt><dd>Show keyboard shortcuts when not editing text</dd></div>
+          </dl>
+        </section>
+        <section class="shortcuts-group">
+          <h3>Editor</h3>
+          <dl>
+            <div><dt>Cmd/Ctrl+S</dt><dd>Save editor</dd></div>
+            <div><dt>Cmd/Ctrl+Enter</dt><dd>Run editor text, or queue steering during an active run</dd></div>
+            <div><dt>Tab / Shift+Tab</dt><dd>Indent or unindent selected editor text</dd></div>
+          </dl>
+        </section>
+        <section class="shortcuts-group">
+          <h3>REPL</h3>
+          <dl>
+            <div><dt>Cmd/Ctrl+Shift+Enter</dt><dd>Send selection, chunks, or editor text to the active REPL when the right pane is REPL</dd></div>
+          </dl>
+        </section>
+      </div>
+    </div>
+  </div>
+
   <div id="scratchpadOverlay" class="scratchpad-overlay" hidden>
     <div id="scratchpadDialog" class="scratchpad-dialog" role="dialog" aria-modal="true" aria-labelledby="scratchpadTitle">
       <div class="scratchpad-header">
@@ -11302,6 +11344,11 @@ export default function (pi: ExtensionAPI) {
 			return;
 		}
 
+		if (isSshSession()) {
+			respondJson(res, 409, { ok: false, error: "Server clipboard is disabled for SSH Studio sessions; use the browser clipboard." });
+			return;
+		}
+
 		const result = await writeStudioSystemClipboard(text);
 		if (result.ok) {
 			respondJson(res, 200, { ok: true, method: result.method });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-studio",
-  "version": "0.9.8",
+  "version": "0.9.10",
   "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",