pi-studio 0.9.27 → 0.9.29

package/CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to `pi-studio` are documented here.
 
 ## [Unreleased]
 
+## [0.9.29] — 2026-06-09
+
+### Added
+- Added `/studio --no-browser` and `/studio --port <port>` launch flags for explicit remote/forwarded Studio sessions when SSH auto-detection is not enough.
+
+## [0.9.28] — 2026-06-08
+
+### Added
+- Added a footer **Pi model & thinking** menu for switching the active Pi model and thinking level from Studio while keeping Studio Suggest model choice separate.
+
+### Changed
+- Clarified the browser-import tooltip to explain that **Save editor as…** can make an imported copy file-backed.
+- Regularized Source & context menu notes so explanatory text uses a quieter, consistent menu-note style.
+
 ## [0.9.27] — 2026-06-08
 
 ### Added

package/README.md

@@ -56,6 +56,8 @@ Extension for [pi](https://pi.dev) that opens a local two-pane browser workspace
 | `/studio <path>` | Open with file preloaded |
 | `/studio --last` | Force last response |
 | `/studio --blank` | Force blank editor |
+| `/studio --no-browser` | Start/print the Studio URL without opening a browser, useful for forwarded or phone/browser sessions |
+| `/studio --port <port>` | Bind Studio to a fixed localhost port instead of a random free port |
 | `/studio --status` | Show studio server status |
 | `/studio --stop` | Stop studio server |
 | `/studio --help` | Show help |
@@ -113,7 +115,7 @@ caption: Optional caption
 ## Notes
 
 - Local-only server (`127.0.0.1`) with tokenized Studio URLs.
-- For remote SSH sessions, keep Studio bound to localhost and use SSH local port forwarding; `/studio` and `/studio --status` print the full tokenized localhost URL. The SSH hint repeats the full URL so it is visible even if your terminal only shows the latest notification. Open that URL through the tunnel, preserving the `?token=...` parameter.
+- For remote SSH sessions, keep Studio bound to localhost and use SSH local port forwarding; `/studio` and `/studio --status` print the full tokenized localhost URL. The SSH hint repeats the full URL so it is visible even if your terminal only shows the latest notification. Open that URL through the tunnel, preserving the `?token=...` parameter. If SSH is not auto-detected, use `/studio --no-browser`; for stable forwarding, use `/studio --port <port>` or combine them, e.g. `/studio --no-browser --port 3417`.
 - Full Studio is a singleton per Pi session: use `/studio` to open it, `/studio-replace` to explicitly replace it, and `/studio-editor-only` for extra editing/preview tabs that do not take over the full Studio session view.
 - Studio is designed as a complement to terminal pi, not a replacement.
 - Installing pi-studio makes the optional `pi-studio-dark` and `pi-studio-light` themes available in pi's theme selector; it does not change your active theme.

package/client/studio-client.js

@@ -7,6 +7,7 @@
       const footerMetaModelEl = document.getElementById("footerMetaModel");
       const footerMetaTerminalEl = document.getElementById("footerMetaTerminal");
       const footerMetaContextEl = document.getElementById("footerMetaContext");
+      const footerModelMenuEl = document.getElementById("footerModelMenu");
       let faviconLinkEl = document.querySelector('link[rel="icon"], link[rel="shortcut icon"]');
       if (!faviconLinkEl) {
         faviconLinkEl = document.createElement("link");
@@ -522,6 +523,10 @@
       let previewExportInProgress = false;
       let compactInProgress = false;
       let modelLabel = (document.body && document.body.dataset && document.body.dataset.modelLabel) || "none";
+      let piModelOptions = [];
+      let piCurrentModel = null;
+      let piThinkingLevel = "";
+      let footerModelMenuOpen = false;
       let terminalSessionLabel = (document.body && document.body.dataset && document.body.dataset.terminalLabel) || "unknown";
       let terminalSessionDetail = (document.body && document.body.dataset && document.body.dataset.terminalDetail) || terminalSessionLabel;
       let contextTokens = null;
@@ -2510,13 +2515,13 @@
             completionModelSelect.hidden = false;
             suggestionItems.push(completionModelSelect);
           }
-          const completionThinkingNoteEl = makeStudioUiRefreshElement("div", "source-badge completion-thinking-note", "Suggest uses thinking off and does not change the main Pi model.");
+          const completionThinkingNoteEl = makeStudioUiRefreshElement("div", "studio-refresh-menu-note completion-thinking-note", "Suggest: thinking off; model choice only affects suggestions.");
           completionThinkingNoteEl.setAttribute("aria-label", "Suggestion model note");
           suggestionItems.push(completionThinkingNoteEl);
           appendStudioUiRefreshMenuSection(contextMenu.menu, "Suggestions", suggestionItems);
           const statusItems = [];
           if (!isEditorOnlyMode) {
-            sourceSessionSummaryEl = makeStudioUiRefreshElement("div", "source-badge source-session-summary", "Session tree: branch history follows the current Pi branch. Editor text is independent.");
+            sourceSessionSummaryEl = makeStudioUiRefreshElement("div", "studio-refresh-menu-note source-session-summary", "Session tree: branch history follows the current Pi branch; editor text stays independent.");
             sourceSessionSummaryEl.setAttribute("aria-label", "Pi session tree and editor sync behaviour");
             sourceSessionSummaryEl.title = "Use /tree in the Pi terminal to navigate branches. Studio updates branch history to match the active branch and leaves editor text unchanged.";
             statusItems.push(sourceSessionSummaryEl);
@@ -3179,6 +3184,118 @@
         }
       }
 
+      function encodePiModelValue(provider, id) {
+        return JSON.stringify([String(provider || ""), String(id || "")]);
+      }
+
+      function decodePiModelValue(value) {
+        try {
+          const parsed = JSON.parse(String(value || ""));
+          if (!Array.isArray(parsed) || parsed.length < 2) return null;
+          const provider = String(parsed[0] || "").trim();
+          const id = String(parsed[1] || "").trim();
+          return provider && id ? { provider, id } : null;
+        } catch {
+          return null;
+        }
+      }
+
+      function normalizePiModelOptions(options) {
+        return Array.isArray(options)
+          ? options.map((option) => ({
+            provider: String(option && option.provider || "").trim(),
+            id: String(option && option.id || "").trim(),
+            label: String(option && option.label || "").trim(),
+            reasoning: Boolean(option && option.reasoning),
+          })).filter((option) => option.provider && option.id)
+          : [];
+      }
+
+      function updatePiSessionModelState(message) {
+        if (!message || typeof message !== "object") return;
+        if (Array.isArray(message.piModels)) {
+          piModelOptions = normalizePiModelOptions(message.piModels);
+        } else if (Array.isArray(message.suggestionModels) && !piModelOptions.length) {
+          piModelOptions = normalizePiModelOptions(message.suggestionModels);
+        }
+        if (message.currentModel && typeof message.currentModel === "object") {
+          const model = message.currentModel;
+          const provider = String(model.provider || "").trim();
+          const id = String(model.id || "").trim();
+          piCurrentModel = provider && id ? {
+            provider,
+            id,
+            label: String(model.label || "").trim(),
+            reasoning: Boolean(model.reasoning),
+          } : null;
+        }
+        if (typeof message.thinkingLevel === "string") {
+          piThinkingLevel = message.thinkingLevel.trim();
+        }
+        renderFooterModelMenu();
+      }
+
+      function getPiCurrentModelValue() {
+        return piCurrentModel && piCurrentModel.provider && piCurrentModel.id
+          ? encodePiModelValue(piCurrentModel.provider, piCurrentModel.id)
+          : "";
+      }
+
+      function getPiThinkingLevels() {
+        return ["off", "minimal", "low", "medium", "high", "xhigh"];
+      }
+
+      function renderFooterModelMenu() {
+        if (!footerModelMenuEl) return;
+        const currentValue = getPiCurrentModelValue();
+        const optionValues = new Set(piModelOptions.map((option) => encodePiModelValue(option.provider, option.id)));
+        const modelOptionsHtml = piModelOptions.map((option) => {
+          const value = encodePiModelValue(option.provider, option.id);
+          const label = option.label || (option.provider + "/" + option.id);
+          return "<option value='" + escapeHtml(value) + "'" + (value === currentValue ? " selected" : "") + ">" + escapeHtml(label) + "</option>";
+        });
+        if (currentValue && !optionValues.has(currentValue)) {
+          const label = piCurrentModel && piCurrentModel.label ? piCurrentModel.label : modelLabel;
+          modelOptionsHtml.unshift("<option value='" + escapeHtml(currentValue) + "' selected>" + escapeHtml(label || "current model") + "</option>");
+        }
+        const thinking = piThinkingLevel || "off";
+        const thinkingOptionsHtml = getPiThinkingLevels().map((level) => {
+          return "<option value='" + escapeHtml(level) + "'" + (level === thinking ? " selected" : "") + ">Thinking: " + escapeHtml(level) + "</option>";
+        });
+        footerModelMenuEl.innerHTML = ""
+          + "<div class='footer-model-menu-heading'>Pi model & thinking</div>"
+          + "<label class='footer-model-menu-field'><span>Pi model</span><select id='footerPiModelSelect'>" + modelOptionsHtml.join("") + "</select></label>"
+          + "<label class='footer-model-menu-field'><span>Thinking</span><select id='footerPiThinkingSelect'>" + thinkingOptionsHtml.join("") + "</select></label>"
+          + "<div class='footer-model-menu-note'>Affects future Pi turns. Studio Suggest has its own model setting.</div>";
+      }
+
+      function setFooterModelMenuOpen(open) {
+        footerModelMenuOpen = Boolean(open);
+        if (footerModelMenuEl) footerModelMenuEl.hidden = !footerModelMenuOpen;
+        if (footerMetaModelEl) {
+          footerMetaModelEl.classList.toggle("is-open", footerModelMenuOpen);
+          footerMetaModelEl.setAttribute("aria-expanded", footerModelMenuOpen ? "true" : "false");
+        }
+        if (footerModelMenuOpen) renderFooterModelMenu();
+      }
+
+      function requestPiModelSelection(value) {
+        const model = decodePiModelValue(value);
+        if (!model) {
+          setStatus("No Pi model selected.", "warning");
+          return;
+        }
+        const sent = sendMessage({ type: "pi_model_select_request", provider: model.provider, id: model.id });
+        if (sent) setStatus("Switching Pi model…", "warning");
+      }
+
+      function requestPiThinkingLevel(level) {
+        const normalized = String(level || "").trim();
+        if (!normalized) return;
+        const sent = sendMessage({ type: "pi_thinking_level_request", level: normalized });
+        if (sent) setStatus("Setting Pi thinking level…", "warning");
+      }
+
       function updateFooterMeta() {
         const modelText = modelLabel && modelLabel.trim() ? modelLabel.trim() : "none";
         const terminalText = terminalSessionLabel && terminalSessionLabel.trim() ? terminalSessionLabel.trim() : "unknown";
@@ -3192,7 +3309,9 @@
           footerMetaModelEl.textContent = modelText;
           footerMetaTerminalEl.textContent = terminalText;
           footerMetaContextEl.textContent = contextDisplayText;
-          footerMetaModelEl.title = "Model: " + modelText;
+          footerMetaModelEl.title = "Pi model and thinking: " + modelText;
+          footerMetaModelEl.setAttribute("aria-haspopup", "menu");
+          footerMetaModelEl.setAttribute("aria-expanded", footerModelMenuOpen ? "true" : "false");
           footerMetaTerminalEl.title = terminalDetailText;
           footerMetaContextEl.title = contextTitleText;
           if (footerMetaTextEl) footerMetaTextEl.title = titleText;
@@ -18649,6 +18768,7 @@
           if (Array.isArray(message.suggestionModels)) {
             updateCompletionSuggestionModelOptions(message.suggestionModels);
           }
+          updatePiSessionModelState(message);
           if (typeof message.terminalSessionLabel === "string") {
             terminalSessionLabel = message.terminalSessionLabel;
           }
@@ -19224,6 +19344,7 @@
           if (Array.isArray(message.suggestionModels)) {
             updateCompletionSuggestionModelOptions(message.suggestionModels);
           }
+          updatePiSessionModelState(message);
           if (typeof message.terminalSessionLabel === "string") {
             terminalSessionLabel = message.terminalSessionLabel;
           }
@@ -20103,9 +20224,39 @@
         if (event.key === "Escape") {
           closeExportPreviewMenu();
           closePreviewLinkMenu();
+          setFooterModelMenuOpen(false);
         }
       });
 
+      if (footerMetaModelEl) {
+        footerMetaModelEl.addEventListener("click", (event) => {
+          event.preventDefault();
+          event.stopPropagation();
+          setFooterModelMenuOpen(!footerModelMenuOpen);
+        });
+      }
+      if (footerModelMenuEl) {
+        footerModelMenuEl.addEventListener("click", (event) => {
+          event.stopPropagation();
+        });
+        footerModelMenuEl.addEventListener("change", (event) => {
+          const target = event.target;
+          if (!(target instanceof HTMLSelectElement)) return;
+          if (target.id === "footerPiModelSelect") {
+            requestPiModelSelection(target.value);
+            setFooterModelMenuOpen(false);
+          } else if (target.id === "footerPiThinkingSelect") {
+            requestPiThinkingLevel(target.value);
+            setFooterModelMenuOpen(false);
+          }
+        });
+      }
+      document.addEventListener("click", (event) => {
+        const target = event.target;
+        if (target instanceof Element && (target.closest("#footerModelMenu") || target.closest("#footerMetaModel"))) return;
+        setFooterModelMenuOpen(false);
+      });
+
       saveAsBtn.addEventListener("click", () => {
         const content = sourceTextEl.value;
         if (!content.trim()) {

package/client/studio.css

@@ -4241,6 +4241,82 @@
       max-width: 34ch;
     }
 
+    .footer-model-btn {
+      border: 1px solid transparent;
+      border-radius: 7px;
+      background: transparent;
+      color: inherit;
+      font: inherit;
+      text-align: left;
+      padding: 2px 4px;
+      cursor: pointer;
+    }
+
+    .footer-model-btn:hover,
+    .footer-model-btn:focus-visible,
+    .footer-model-btn.is-open {
+      background: var(--panel-2);
+      border-color: var(--control-border);
+      color: var(--text);
+      outline: none;
+    }
+
+    .footer-model-menu {
+      position: fixed;
+      left: 12px;
+      bottom: 38px;
+      width: min(440px, calc(100vw - 24px));
+      padding: 10px;
+      border: 1px solid var(--panel-border);
+      border-radius: 12px;
+      background: var(--panel);
+      color: var(--text);
+      box-shadow: 0 18px 46px var(--shadow-color);
+      z-index: 110;
+    }
+
+    .footer-model-menu[hidden] {
+      display: none !important;
+    }
+
+    .footer-model-menu-heading {
+      margin: 0 2px 8px;
+      color: var(--muted);
+      font-size: 11px;
+      font-weight: 650;
+      text-transform: uppercase;
+      letter-spacing: 0.06em;
+    }
+
+    .footer-model-menu-field {
+      display: grid;
+      gap: 4px;
+      margin: 8px 0;
+      min-width: 0;
+    }
+
+    .footer-model-menu-field span,
+    .footer-model-menu-note {
+      color: var(--muted);
+      font-size: 12px;
+      line-height: 1.35;
+    }
+
+    .footer-model-menu-field select {
+      width: 100%;
+      min-width: 0;
+      background: var(--panel-2);
+      color: var(--text);
+      border: 1px solid var(--control-border);
+      border-radius: 8px;
+      padding: 5px 7px;
+      font: inherit;
+    }
+
+    .footer-model-menu-note {
+      margin-top: 8px;
+    }
+
     .footer-meta-terminal {
       flex: 0 4 auto;
       max-width: 34ch;
@@ -5629,9 +5705,7 @@
       font-weight: 450;
     }
 
-    body.studio-ui-refresh .studio-refresh-menu-item > .source-origin-summary,
-    body.studio-ui-refresh .studio-refresh-menu-item > .source-session-summary,
-    body.studio-ui-refresh .studio-refresh-menu-item > .completion-thinking-note {
+    body.studio-ui-refresh .studio-refresh-menu-item > .source-origin-summary {
       width: 100%;
       min-width: 0;
       border-color: var(--border-subtle);
@@ -5640,6 +5714,18 @@
       white-space: normal;
       overflow-wrap: anywhere;
       line-height: 1.35;
+      font-weight: 500;
+    }
+
+    body.studio-ui-refresh .studio-refresh-menu-note {
+      width: 100%;
+      min-width: 0;
+      padding: 4px 6px;
+      color: var(--muted);
+      font-size: 12px;
+      line-height: 1.35;
+      white-space: normal;
+      overflow-wrap: anywhere;
     }
 
     body.studio-ui-refresh .studio-refresh-menu #critiqueBtn {

package/index.ts

@@ -1,6 +1,6 @@
 import type { ExtensionAPI, ExtensionCommandContext, ExtensionContext, SessionEntry, Theme } from "@earendil-works/pi-coding-agent";
 import { getAgentDir } from "@earendil-works/pi-coding-agent";
-import { completeSimple, type ThinkingLevel } from "@earendil-works/pi-ai";
+import { completeSimple, type ModelThinkingLevel, type ThinkingLevel } from "@earendil-works/pi-ai";
 import { Type } from "@sinclair/typebox";
 import { spawn, spawnSync } from "node:child_process";
 import { createHash, randomUUID } from "node:crypto";
@@ -29,7 +29,7 @@ import {
 } from "./shared/studio-markdown-latex-literals.js";
 import { escapeStudioPdfLatexTextFragment } from "./shared/studio-pdf-escape.js";
 import { resolveStudioPdfResourceFile } from "./shared/studio-pdf-resource.js";
-import { buildStudioSshTunnelHint, isStudioSshSession as isSshSession } from "./shared/studio-ssh-hint.js";
+import { buildStudioForwardingHint, buildStudioSshTunnelHint, isStudioSshSession as isSshSession } from "./shared/studio-ssh-hint.js";
 
 type Lens = "writing" | "code";
 type RequestedLens = Lens | "auto";
@@ -349,6 +349,17 @@ interface CompletionSuggestionCancelRequestMessage {
 	requestId: string;
 }
 
+interface PiModelSelectRequestMessage {
+	type: "pi_model_select_request";
+	provider: string;
+	id: string;
+}
+
+interface PiThinkingLevelRequestMessage {
+	type: "pi_thinking_level_request";
+	level: ModelThinkingLevel;
+}
+
 interface QuizGenerateRequestMessage {
 	type: "quiz_generate_request";
 	requestId: string;
@@ -492,6 +503,8 @@ type IncomingStudioMessage =
 	| SendRunRequestMessage
 	| CompletionSuggestionRequestMessage
 	| CompletionSuggestionCancelRequestMessage
+	| PiModelSelectRequestMessage
+	| PiThinkingLevelRequestMessage
 	| QuizGenerateRequestMessage
 	| QuizAnswerRequestMessage
 	| QuizDiscussRequestMessage
@@ -8324,6 +8337,24 @@ function parseIncomingMessage(data: RawData): IncomingStudioMessage | null {
 		};
 	}
 
+	if (msg.type === "pi_model_select_request" && typeof msg.provider === "string" && typeof msg.id === "string") {
+		return {
+			type: "pi_model_select_request",
+			provider: msg.provider,
+			id: msg.id,
+		};
+	}
+
+	if (msg.type === "pi_thinking_level_request" && typeof msg.level === "string") {
+		const level = msg.level.trim().toLowerCase();
+		if (level === "off" || level === "minimal" || level === "low" || level === "medium" || level === "high" || level === "xhigh") {
+			return {
+				type: "pi_thinking_level_request",
+				level,
+			};
+		}
+	}
+
 	if (msg.type === "completion_suggestion_request" && typeof msg.requestId === "string" && typeof msg.text === "string") {
 		const textLength = msg.text.length;
 		const rawStart = typeof msg.selectionStart === "number" && Number.isFinite(msg.selectionStart) ? msg.selectionStart : textLength;
@@ -9812,22 +9843,53 @@ function buildStudioUrl(
 	return `http://127.0.0.1:${port}/?${params.toString()}`;
 }
 
-function parseStudioLaunchOpenFlags(rawArgs: string): { args: string; openRemoteBrowser: boolean; error?: string } {
+interface StudioLaunchFlags {
+	args: string;
+	openRemoteBrowser: boolean;
+	noBrowser: boolean;
+	port?: number;
+	error?: string;
+}
+
+function parseStudioLaunchOpenFlags(rawArgs: string): StudioLaunchFlags {
 	const parsed = tokenizeStudioCommandArgs(rawArgs);
-	if (parsed.error) return { args: rawArgs, openRemoteBrowser: false, error: parsed.error };
+	if (parsed.error) return { args: rawArgs, openRemoteBrowser: false, noBrowser: false, error: parsed.error };
 	const remaining: string[] = [];
 	let openRemoteBrowser = false;
-	for (const token of parsed.tokens) {
-		if (token === "--open-remote" || token === "--open-remote-browser") {
+	let noBrowser = false;
+	let port: number | undefined;
+	for (let i = 0; i < parsed.tokens.length; i += 1) {
+		const token = parsed.tokens[i]!;
+		if (token === "--open-remote" || token === "--open-remote-browser" || token === "--open-browser") {
 			openRemoteBrowser = true;
 			continue;
 		}
+		if (token === "--no-browser" || token === "--no-open" || token === "--no-open-browser") {
+			noBrowser = true;
+			continue;
+		}
+		if (token === "--port" || token.startsWith("--port=")) {
+			const rawPort = token.startsWith("--port=") ? token.slice("--port=".length) : parsed.tokens[++i];
+			if (!rawPort) {
+				return { args: rawArgs, openRemoteBrowser, noBrowser, error: "Missing value for --port." };
+			}
+			const requestedPort = Number(rawPort);
+			if (!Number.isInteger(requestedPort) || requestedPort < 1 || requestedPort > 65535) {
+				return { args: rawArgs, openRemoteBrowser, noBrowser, error: `Invalid --port value: ${rawPort}. Use an integer from 1 to 65535.` };
+			}
+			port = requestedPort;
+			continue;
+		}
 		remaining.push(token);
 	}
-	return { args: remaining.join(" "), openRemoteBrowser };
+	if (openRemoteBrowser && noBrowser) {
+		return { args: rawArgs, openRemoteBrowser, noBrowser, port, error: "Use either --no-browser or --open-browser, not both." };
+	}
+	return { args: remaining.join(" "), openRemoteBrowser, noBrowser, port };
 }
 
-function shouldAutoOpenStudioBrowser(options?: { openRemoteBrowser?: boolean }): boolean {
+function shouldAutoOpenStudioBrowser(options?: { openRemoteBrowser?: boolean; noBrowser?: boolean }): boolean {
+	if (options?.noBrowser) return false;
 	return !isSshSession() || Boolean(options?.openRemoteBrowser);
 }
 
@@ -10220,7 +10282,7 @@ ${cssVarsBlock}
       <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 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="Browser import: load a selected text file as a detached unsaved copy. It will not be refreshable from disk. Use the Files view to open a file-backed document.">Import file copy…<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>
+      <label class="file-label" title="Browser import: load a selected text file as a detached copy. Use Save editor as… to attach this copy to a file path and make it file-backed, or use the Files view to open a refreshable file-backed document directly.">Import file copy…<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="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. Shortcut: F9.">Zen</button>
     </div>
@@ -10503,7 +10565,8 @@ ${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 id="footerMeta" class="footer-meta"><span id="footerMetaText" class="footer-meta-text"><button id="footerMetaModel" class="footer-meta-part footer-meta-model footer-model-btn" type="button" aria-haspopup="menu" aria-expanded="false">${initialModel}</button><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>
+    <div id="footerModelMenu" class="footer-model-menu" hidden></div>
     <button id="shortcutsBtn" class="shortcut-hint" type="button" title="Show Studio keyboard shortcuts. Press ? when not editing text.">Shortcuts (?)</button>
   </footer>
 
@@ -10624,7 +10687,7 @@ export default function (pi: ExtensionAPI) {
 	let terminalActivityToolName: string | null = null;
 	let terminalActivityLabel: string | null = null;
 	let lastSpecificToolActivityLabel: string | null = null;
-	let currentModel: { provider?: string; id?: string } | undefined;
+	let currentModel: { provider?: string; id?: string; name?: string; reasoning?: boolean } | undefined;
 	let currentModelLabel = "none";
 	let terminalSessionLabel = buildTerminalSessionLabel(studioCwd);
 	let terminalSessionDetail = buildTerminalSessionDetail(studioCwd);
@@ -10897,15 +10960,20 @@ export default function (pi: ExtensionAPI) {
 		}
 	};
 
-	const getThinkingLevelSafe = (): string | undefined => {
+	const getThinkingLevelSafe = (): ModelThinkingLevel | undefined => {
 		try {
-			return pi.getThinkingLevel();
+			return pi.getThinkingLevel() as ModelThinkingLevel;
 		} catch {
 			return undefined;
 		}
 	};
 
-	const refreshRuntimeMetadata = (ctx?: { cwd?: string; model?: { provider?: string; id?: string } | undefined }) => {
+	const setThinkingLevelSafe = (level: ModelThinkingLevel) => {
+		// Pi's CLI/model config support "off" as a thinking level; some extension API typings still expose the narrower reasoning-only type.
+		(pi.setThinkingLevel as (nextLevel: ModelThinkingLevel) => void)(level);
+	};
+
+	const refreshRuntimeMetadata = (ctx?: { cwd?: string; model?: { provider?: string; id?: string; name?: string; reasoning?: boolean } | undefined }) => {
 		if (ctx?.cwd) {
 			studioCwd = ctx.cwd;
 		}
@@ -10914,6 +10982,8 @@ export default function (pi: ExtensionAPI) {
 				currentModel = {
 					provider: ctx.model.provider,
 					id: ctx.model.id,
+					name: ctx.model.name,
+					reasoning: Boolean(ctx.model.reasoning),
 				};
 			} else {
 				currentModel = undefined;
@@ -10922,6 +10992,8 @@ export default function (pi: ExtensionAPI) {
 			currentModel = {
 				provider: lastCommandCtx.model.provider,
 				id: lastCommandCtx.model.id,
+				name: lastCommandCtx.model.name,
+				reasoning: Boolean(lastCommandCtx.model.reasoning),
 			};
 		}
 		const baseModelLabel = formatModelLabel(currentModel);
@@ -11606,7 +11678,7 @@ export default function (pi: ExtensionAPI) {
 		broadcastState();
 	};
 
-	const getSuggestionModelOptions = () => {
+	const getStudioModelOptions = () => {
 		const registry = lastCommandCtx?.modelRegistry ?? latestModelRequestCtx?.modelRegistry;
 		if (!registry || typeof registry.getAvailable !== "function") return [];
 		return registry.getAvailable().map((model) => ({
@@ -11617,11 +11689,21 @@ export default function (pi: ExtensionAPI) {
 		}));
 	};
 
+	const getCurrentStudioModelDescriptor = () => currentModel
+		? {
+			provider: currentModel.provider,
+			id: currentModel.id,
+			label: formatStudioModelOptionLabel(currentModel),
+			reasoning: Boolean(currentModel.reasoning),
+		}
+		: null;
+
 	const broadcastState = () => {
 		terminalSessionLabel = buildTerminalSessionLabel(studioCwd, getSessionNameSafe());
 		terminalSessionDetail = buildTerminalSessionDetail(studioCwd, getSessionNameSafe());
 		currentModelLabel = formatModelLabelWithThinking(formatModelLabel(currentModel), getThinkingLevelSafe());
 		refreshContextUsage();
+		const modelOptions = getStudioModelOptions();
 		broadcast({
 			type: "studio_state",
 			busy: isStudioBusy(),
@@ -11630,7 +11712,10 @@ export default function (pi: ExtensionAPI) {
 			terminalToolName: terminalActivityToolName,
 			terminalActivityLabel,
 			modelLabel: currentModelLabel,
-			suggestionModels: getSuggestionModelOptions(),
+			currentModel: getCurrentStudioModelDescriptor(),
+			thinkingLevel: getThinkingLevelSafe() ?? "off",
+			piModels: modelOptions,
+			suggestionModels: modelOptions,
 			terminalSessionLabel,
 			terminalSessionDetail,
 			contextTokens: contextUsageSnapshot.tokens,
@@ -11926,7 +12011,10 @@ export default function (pi: ExtensionAPI) {
 				terminalToolName: terminalActivityToolName,
 				terminalActivityLabel,
 				modelLabel: currentModelLabel,
-				suggestionModels: getSuggestionModelOptions(),
+				currentModel: getCurrentStudioModelDescriptor(),
+				thinkingLevel: getThinkingLevelSafe() ?? "off",
+				piModels: getStudioModelOptions(),
+				suggestionModels: getStudioModelOptions(),
 				terminalSessionLabel,
 				terminalSessionDetail,
 				contextTokens: contextUsageSnapshot.tokens,
@@ -11945,6 +12033,47 @@ export default function (pi: ExtensionAPI) {
 			return;
 		}
 
+		if (msg.type === "pi_model_select_request") {
+			void (async () => {
+				const registry = lastCommandCtx?.modelRegistry ?? latestModelRequestCtx?.modelRegistry;
+				if (!registry || typeof registry.find !== "function") {
+					sendToClient(client, { type: "info", level: "warning", message: "Pi model registry is not available yet." });
+					return;
+				}
+				const model = registry.find(msg.provider, msg.id);
+				if (!model) {
+					sendToClient(client, { type: "info", level: "warning", message: `Pi model not found: ${msg.provider}/${msg.id}` });
+					return;
+				}
+				try {
+					const ok = await pi.setModel(model);
+					if (!ok) {
+						sendToClient(client, { type: "info", level: "warning", message: `Could not switch to ${formatStudioModelOptionLabel(model)}; credentials may be unavailable.` });
+						return;
+					}
+					latestModelRequestCtx = { model, modelRegistry: registry };
+					refreshRuntimeMetadata({ model });
+					broadcastState();
+					sendToClient(client, { type: "info", level: "info", message: `Pi model switched to ${formatStudioModelOptionLabel(model)}.` });
+				} catch (error) {
+					sendToClient(client, { type: "info", level: "error", message: `Model switch failed: ${error instanceof Error ? error.message : String(error)}` });
+				}
+			})();
+			return;
+		}
+
+		if (msg.type === "pi_thinking_level_request") {
+			try {
+				setThinkingLevelSafe(msg.level);
+				refreshRuntimeMetadata({ model: lastCommandCtx?.model ?? latestModelRequestCtx?.model });
+				broadcastState();
+				sendToClient(client, { type: "info", level: "info", message: `Pi thinking level set to ${getThinkingLevelSafe() ?? msg.level}.` });
+			} catch (error) {
+				sendToClient(client, { type: "info", level: "error", message: `Thinking level change failed: ${error instanceof Error ? error.message : String(error)}` });
+			}
+			return;
+		}
+
 		if (msg.type === "get_latest_response") {
 			if (!lastStudioResponse) {
 				sendToClient(client, { type: "info", message: "No latest assistant response is available yet." });
@@ -13998,7 +14127,7 @@ export default function (pi: ExtensionAPI) {
 		res.end(buildStudioHtml(requestInitialDocument, serverState.token, lastCommandCtx?.ui.theme, currentModelLabel, terminalSessionLabel, terminalSessionDetail, contextUsageSnapshot, studioMode));
 	};
 
-	const ensureServer = async (): Promise<StudioServerState> => {
+	const ensureServer = async (requestedPort?: number): Promise<StudioServerState> => {
 		if (serverState) return serverState;
 
 		const server = createServer(handleHttpRequest);
@@ -14086,6 +14215,8 @@ export default function (pi: ExtensionAPI) {
 			});
 		});
 
+		const listenPort = typeof requestedPort === "number" && Number.isInteger(requestedPort) && requestedPort > 0 ? requestedPort : 0;
+
 		await new Promise<void>((resolve, reject) => {
 			const onError = (error: Error) => {
 				server.off("listening", onListening);
@@ -14097,7 +14228,7 @@ export default function (pi: ExtensionAPI) {
 			};
 			server.once("error", onError);
 			server.once("listening", onListening);
-			server.listen(0, "127.0.0.1");
+			server.listen(listenPort, "127.0.0.1");
 		});
 
 		const address = server.address();
@@ -14883,6 +15014,9 @@ export default function (pi: ExtensionAPI) {
 			return;
 		}
 		const launchArgs = launchOpenFlags.args;
+		if (serverState && launchOpenFlags.port && serverState.port !== launchOpenFlags.port) {
+			ctx.ui.notify(`Studio server is already running on port ${serverState.port}; requested port ${launchOpenFlags.port}. Use /studio --stop, then restart Studio with --port ${launchOpenFlags.port} to change it.`, "warning");
+		}
 		if (mode === "full" && hasConnectedFullStudioView()) {
 			if (options?.replaceExistingFull) {
 				closeStudioClientsByMode("full", 4001, "Full Studio replaced");
@@ -14891,8 +15025,9 @@ export default function (pi: ExtensionAPI) {
 				if (serverState) {
 					const url = buildStudioUrl(serverState.port, serverState.token, "full");
 					ctx.ui.notify(`Studio URL: ${url}`, "info");
-					const sshTunnelHint = buildStudioSshTunnelHint(serverState.port, url);
-					if (sshTunnelHint) ctx.ui.notify(sshTunnelHint, "info");
+					const tunnelHint = buildStudioSshTunnelHint(serverState.port, url)
+						?? (launchOpenFlags.noBrowser ? buildStudioForwardingHint(serverState.port, url, { prefix: "Browser auto-open was skipped because --no-browser was used." }) : null);
+					if (tunnelHint) ctx.ui.notify(tunnelHint, "info");
 				}
 				return;
 			}
@@ -14917,17 +15052,28 @@ export default function (pi: ExtensionAPI) {
 		if (!selected) return;
 		initialStudioDocument = selected;
 
-		const state = await ensureServer();
+		let state: StudioServerState;
+		try {
+			state = await ensureServer(launchOpenFlags.port);
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			const portText = launchOpenFlags.port ? ` on port ${launchOpenFlags.port}` : "";
+			ctx.ui.notify(`Failed to start Studio server${portText}: ${message}`, "error");
+			return;
+		}
 		const url = buildStudioUrl(state.port, state.token, mode, selected);
-		const sshTunnelHint = buildStudioSshTunnelHint(state.port, url);
+		const tunnelHint = buildStudioSshTunnelHint(state.port, url)
+			?? (launchOpenFlags.noBrowser ? buildStudioForwardingHint(state.port, url, { prefix: "Browser auto-open was skipped because --no-browser was used." }) : null);
 		const openedLabel = mode === "editor-only" ? "pi Studio editor-only view" : "pi Studio";
 
 		const shouldOpenBrowser = shouldAutoOpenStudioBrowser({
 			openRemoteBrowser: launchOpenFlags.openRemoteBrowser,
+			noBrowser: launchOpenFlags.noBrowser,
 		});
 		try {
 			if (!shouldOpenBrowser) {
-				ctx.ui.notify(`${openedLabel} is ready. Browser auto-open was skipped because SSH was detected.`, "info");
+				const skipReason = launchOpenFlags.noBrowser ? "--no-browser was used" : "SSH was detected";
+				ctx.ui.notify(`${openedLabel} is ready. Browser auto-open was skipped because ${skipReason}.`, "info");
 			} else {
 				await openUrlInDefaultBrowser(url);
 				if (selected.source === "file") {
@@ -14947,12 +15093,12 @@ export default function (pi: ExtensionAPI) {
 			}
 		} finally {
 			ctx.ui.notify(`Studio URL: ${url}`, "info");
-			if (sshTunnelHint) ctx.ui.notify(sshTunnelHint, "info");
+			if (tunnelHint) ctx.ui.notify(tunnelHint, "info");
 		}
 	};
 
 	pi.registerCommand("studio", {
-		description: "Open pi Studio browser UI (/studio, /studio <file>, /studio --blank, /studio --last)",
+		description: "Open pi Studio browser UI (/studio, /studio <file>, /studio --blank, /studio --last, /studio --no-browser, /studio --port <port>)",
 		handler: async (args: string, ctx: ExtensionCommandContext) => {
 			const trimmed = args.trim();
 
@@ -14985,6 +15131,8 @@ export default function (pi: ExtensionAPI) {
 						+ "  /studio <path>    Open studio with file preloaded\n"
 						+ "  /studio --blank   Open with blank editor\n"
 						+ "  /studio --last    Open with last model response\n"
+						+ "  /studio --no-browser  Print the Studio URL without opening a browser\n"
+						+ "  /studio --port <port> Bind Studio to a fixed localhost port when starting\n"
 						+ "  /studio --open-remote  Over SSH, open the remote browser anyway\n"
 						+ "  /studio --status  Show studio status\n"
 						+ "  /studio --stop    Stop studio server\n"
@@ -15004,7 +15152,7 @@ export default function (pi: ExtensionAPI) {
 	});
 
 	pi.registerCommand("studio-replace", {
-		description: "Replace the current full pi Studio view (/studio-replace, /studio-replace <file>)",
+		description: "Replace the current full pi Studio view (/studio-replace, /studio-replace <file>, /studio-replace --no-browser)",
 		handler: async (args: string, ctx: ExtensionCommandContext) => {
 			const trimmed = args.trim();
 			if (trimmed === "help" || trimmed === "--help" || trimmed === "-h") {
@@ -15014,6 +15162,8 @@ export default function (pi: ExtensionAPI) {
 						+ "  /studio-replace <path>  Replace the current full Studio view with file preloaded\n"
 						+ "  /studio-replace --blank Replace with blank editor\n"
 						+ "  /studio-replace --last  Replace with last model response\n"
+						+ "  /studio-replace --no-browser  Print URL without opening a browser\n"
+						+ "  /studio-replace --port <port> Bind Studio to a fixed localhost port when starting\n"
 						+ "Editor-only Studio views stay open.",
 					"info",
 				);
@@ -15029,7 +15179,7 @@ export default function (pi: ExtensionAPI) {
 	});
 
 	pi.registerCommand("studio-editor-only", {
-		description: "Open pi Studio in editor-only mode (/studio-editor-only, /studio-editor-only <file>)",
+		description: "Open pi Studio in editor-only mode (/studio-editor-only, /studio-editor-only <file>, /studio-editor-only --no-browser)",
 		handler: async (args: string, ctx: ExtensionCommandContext) => {
 			const trimmed = args.trim();
 			if (trimmed === "help" || trimmed === "--help" || trimmed === "-h") {
@@ -15039,6 +15189,8 @@ export default function (pi: ExtensionAPI) {
 						+ "  /studio-editor-only <path>  Open an editor-only Studio view with file preloaded\n"
 						+ "  /studio-editor-only --blank Open with blank editor\n"
 						+ "  /studio-editor-only --last  Open with last model response loaded into the editor\n"
+						+ "  /studio-editor-only --no-browser  Print URL without opening a browser\n"
+						+ "  /studio-editor-only --port <port> Bind Studio to a fixed localhost port when starting\n"
 						+ "Multiple editor-only views are allowed in the same Pi session.",
 					"info",
 				);

package/package.json

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

package/shared/studio-ssh-hint.js

@@ -4,16 +4,25 @@ export function isStudioSshSession(env = process.env) {
 	);
 }
 
-export function buildStudioSshTunnelHint(port, studioUrl, env = process.env) {
-	if (!isStudioSshSession(env)) return null;
+export function buildStudioForwardingHint(port, studioUrl, options = {}) {
 	const normalizedPort = Number(port);
 	const remotePort = Number.isInteger(normalizedPort) && normalizedPort > 0 ? normalizedPort : port;
 	const url = String(studioUrl || "").trim();
-	return [
-		"SSH detected. Studio was not opened in the remote browser.",
-		"To open it locally, run this on your local machine:",
+	const prefix = String(options.prefix || "").trim();
+	const lines = [];
+	if (prefix) lines.push(prefix);
+	lines.push(
+		"To open Studio locally through SSH, run this on your local machine:",
 		`  ssh -L ${remotePort}:127.0.0.1:${remotePort} <remote-host>`,
 		"Then open this Studio URL in your local browser:",
 		`  ${url}`,
-	].join("\n");
+	);
+	return lines.join("\n");
+}
+
+export function buildStudioSshTunnelHint(port, studioUrl, env = process.env) {
+	if (!isStudioSshSession(env)) return null;
+	return buildStudioForwardingHint(port, studioUrl, {
+		prefix: "SSH detected. Studio was not opened in the remote browser.",
+	});
 }