pi-studio 0.6.3 → 0.6.4

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to `pi-studio` are documented here.
 
 ## [Unreleased]
 
+## [0.6.4] — 2026-04-29
+
+### Fixed
+- Fixed `@`-selected quoted file paths such as `@"folder/file.md"` so Studio commands strip the `@` prefix and surrounding quotes before resolving the file.
+- `/studio --status` now prints the full tokenized Studio URL, and SSH tunnel hints explicitly say to preserve the `?token=...` parameter.
+
 ## [0.6.3] — 2026-04-29
 
 ### Changed

package/README.md

@@ -75,7 +75,7 @@ pi -e https://github.com/omaclaren/pi-studio
 ## 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` prints the localhost URL and an SSH tunnel hint when SSH is detected.
+- 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. Open that URL through the tunnel, preserving the `?token=...` parameter.
 - 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/index.ts

@@ -1382,20 +1382,27 @@ function isValidRequestId(id: string): boolean {
 	return /^[a-zA-Z0-9_-]{1,120}$/.test(id);
 }
 
-function parsePathArgument(args: string): string | null {
-	const trimmed = args.trim();
-	if (!trimmed) return null;
-
+function stripMatchingPathQuotes(value: string): string {
+	const trimmed = value.trim();
 	if (
 		(trimmed.startsWith('"') && trimmed.endsWith('"') && trimmed.length >= 2) ||
 		(trimmed.startsWith("'") && trimmed.endsWith("'") && trimmed.length >= 2)
 	) {
 		return trimmed.slice(1, -1).trim();
 	}
-
 	return trimmed;
 }
 
+function parsePathArgument(args: string): string | null {
+	const trimmed = args.trim();
+	if (!trimmed) return null;
+
+	const hasAtPrefix = trimmed.startsWith("@");
+	const pathPart = hasAtPrefix ? trimmed.slice(1).trim() : trimmed;
+	const unquoted = stripMatchingPathQuotes(pathPart);
+	return hasAtPrefix ? `@${unquoted}` : unquoted;
+}
+
 function tokenizeStudioCommandArgs(input: string): { tokens: string[]; error?: string } {
 	const tokens: string[] = [];
 	let current = "";
@@ -1445,8 +1452,8 @@ function tokenizeStudioCommandArgs(input: string): { tokens: string[]; error?: s
 
 function normalizePathInput(pathInput: string): string {
 	const trimmed = pathInput.trim();
-	if (trimmed.startsWith("@")) return trimmed.slice(1).trim();
-	return trimmed;
+	if (trimmed.startsWith("@")) return stripMatchingPathQuotes(trimmed.slice(1).trim());
+	return stripMatchingPathQuotes(trimmed);
 }
 
 function expandHome(pathInput: string): string {
@@ -6083,7 +6090,7 @@ function isSshSession(): boolean {
 
 function buildStudioSshTunnelHint(port: number): string | null {
 	if (!isSshSession()) return null;
-	return `SSH detected. If Studio is running on a remote machine, forward the port from your local machine, then open the Studio URL locally: ssh -L ${port}:127.0.0.1:${port} <remote-host>`;
+	return `SSH detected. Forward the remote Studio port, then open the full Studio URL above locally, including its ?token=... parameter: ssh -L ${port}:127.0.0.1:${port} <remote-host>. If you choose a different local port, change only the port in the URL; keep the token.`;
 }
 
 function resolveRequestedStudioDocumentFromUrl(
@@ -9481,10 +9488,13 @@ export default function (pi: ExtensionAPI) {
 					return;
 				}
 				const counts = getStudioClientCounts();
+				const url = buildStudioUrl(serverState.port, serverState.token, "full");
 				ctx.ui.notify(
-					`Studio running at http://127.0.0.1:${serverState.port}/ (busy: ${isStudioBusy() ? "yes" : "no"}; full views: ${counts.full}; editor-only views: ${counts.editorOnly})`,
+					`Studio running at ${url} (busy: ${isStudioBusy() ? "yes" : "no"}; full views: ${counts.full}; editor-only views: ${counts.editorOnly})`,
 					"info",
 				);
+				const sshTunnelHint = buildStudioSshTunnelHint(serverState.port);
+				if (sshTunnelHint) ctx.ui.notify(sshTunnelHint, "info");
 				return;
 			}
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-studio",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "description": "Two-pane browser workspace for pi with prompt/response editing, annotations, critiques, prompt/response history, and live Markdown/LaTeX/code preview",
   "type": "module",
   "license": "MIT",