pi-studio 0.6.2 → 0.6.4

package/CHANGELOG.md

@@ -4,6 +4,18 @@ 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
+- Polished rendered code blocks so ordinary code text uses normal foreground, Python function definitions keep function-name highlighting, and fenced-block borders are softened to better match theme intent.
+- Slightly sharpened footer metadata and shortcut text for better readability across darker custom themes.
+
 ## [0.6.2] — 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/client/studio.css

@@ -1143,7 +1143,7 @@
     }
 
     .rendered-markdown pre code {
-      color: var(--md-codeblock);
+      color: var(--text);
       white-space: inherit;
     }
 
@@ -1846,7 +1846,7 @@
     footer {
       border-top: 1px solid var(--panel-border);
       padding: 8px 12px;
-      color: var(--muted);
+      color: var(--studio-footer-text, var(--muted));
       font-size: 12px;
       min-height: 32px;
       background: var(--panel);
@@ -1903,7 +1903,7 @@
     .footer-meta {
       grid-area: meta;
       justify-self: start;
-      color: var(--muted);
+      color: var(--studio-footer-text, var(--muted));
       font-size: 11px;
       text-align: left;
       max-width: 100%;
@@ -1954,12 +1954,12 @@
       grid-area: hint;
       justify-self: end;
       align-self: center;
-      color: var(--muted);
+      color: var(--studio-footer-text, var(--muted));
       font-size: 11px;
       white-space: nowrap;
       text-align: right;
       font-style: normal;
-      opacity: 0.9;
+      opacity: 0.86;
       display: inline-flex;
       align-items: center;
       gap: 8px;

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 {
@@ -4341,6 +4348,13 @@ async function writeStudioSystemClipboard(text: string): Promise<{ ok: true; met
 	return { ok: false, error: errors.join("; ") || "No system clipboard command is available." };
 }
 
+function decorateStudioPandocSyntaxHtml(html: string): string {
+	return html.replace(
+		/(<span class="kw">def<\/span>)(\s*)([A-Za-z_][A-Za-z0-9_]*)(?=\s*\()/g,
+		(_match, keyword: string, spacing: string, name: string) => `${keyword}${spacing}<span class="fu">${name}</span>`,
+	);
+}
+
 async function renderStudioMarkdownWithPandoc(markdown: string, isLatex?: boolean, resourcePath?: string, sourcePath?: string): Promise<string> {
 	const pandocCommand = process.env.PANDOC_PATH?.trim() || "pandoc";
 	const markdownWithoutHtmlComments = isLatex ? markdown : stripStudioMarkdownHtmlComments(markdown);
@@ -4421,6 +4435,7 @@ async function renderStudioMarkdownWithPandoc(markdown: string, isLatex?: boolea
 				} else {
 					html = decorateStudioPreviewPageBreakHtml(html);
 				}
+				html = decorateStudioPandocSyntaxHtml(html);
 				succeed(stripMathMlAnnotationTags(html));
 				return;
 			}
@@ -6075,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(
@@ -6210,6 +6225,8 @@ function buildThemeCssVars(style: StudioThemeStyle): Record<string, string> {
 		style.mode === "light" ? 0.13 : 0.18,
 		style.mode === "light" ? "rgba(15, 23, 42, 0.06)" : "rgba(255, 255, 255, 0.07)",
 	);
+	const rawCodeBlockBorder = blendColors(style.palette.mdCodeBlockBorder, style.palette.panel2, style.mode === "light" ? 0.62 : 0.72);
+	const codeBlockBorder = capBorderContrast(rawCodeBlockBorder, style.palette.panel2, style.mode === "light" ? 1.16 : 1.18);
 	const diffAddedBg = withAlpha(style.palette.ok, style.mode === "light" ? 0.10 : 0.14, "rgba(46, 160, 67, 0.12)");
 	const diffRemovedBg = withAlpha(style.palette.error, style.mode === "light" ? 0.10 : 0.14, "rgba(248, 81, 73, 0.12)");
 	const okSoft = withAlpha(style.palette.ok, style.mode === "light" ? 0.10 : 0.12, "rgba(115, 209, 61, 0.08)");
@@ -6228,6 +6245,7 @@ function buildThemeCssVars(style: StudioThemeStyle): Record<string, string> {
 	const scratchpadHeaderBg = style.mode === "light" ? lightSecondarySurface : style.palette.panel2;
 	const scratchpadBodyBg = style.mode === "light" ? lightPrimarySurface : style.palette.panel;
 	const infoText = blendColors(style.palette.text, style.palette.muted, style.mode === "light" ? 0.36 : 0.30);
+	const footerText = blendColors(style.palette.text, style.palette.muted, style.mode === "light" ? 0.50 : 0.42);
 	const headerActionBg = style.mode === "light" ? lightPrimarySurface : "transparent";
 	const headerActionHoverBg = style.mode === "light" ? lightPrimarySurface : style.palette.panel2;
 	const headerActionBorder = style.mode === "light" ? controlBorder : "transparent";
@@ -6264,7 +6282,7 @@ function buildThemeCssVars(style: StudioThemeStyle): Record<string, string> {
 		"--md-link-url": style.palette.mdLinkUrl,
 		"--md-code": style.palette.mdCode,
 		"--md-codeblock": style.palette.mdCodeBlock,
-		"--md-codeblock-border": style.palette.mdCodeBlockBorder,
+		"--md-codeblock-border": codeBlockBorder,
 		"--md-quote": style.palette.mdQuote,
 		"--md-quote-border": style.palette.mdQuoteBorder,
 		"--md-hr": style.palette.mdHr,
@@ -6298,6 +6316,7 @@ function buildThemeCssVars(style: StudioThemeStyle): Record<string, string> {
 		"--scratchpad-header-bg": scratchpadHeaderBg,
 		"--scratchpad-body-bg": scratchpadBodyBg,
 		"--studio-info-text": infoText,
+		"--studio-footer-text": footerText,
 		"--studio-header-action-bg": headerActionBg,
 		"--studio-header-action-hover-bg": headerActionHoverBg,
 		"--studio-header-action-border": headerActionBorder,
@@ -9469,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.2",
+  "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",