pi-squire 0.13.0 → 0.13.1

package/CHANGELOG.md

@@ -6,6 +6,13 @@ follows [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.13.1] - 2026-10-27
+
+### Changed
+
+- A delegate's popup title names the key that closes it, with your tmux prefix,
+  for example `scout-first · C-b d to close`.
+
 ## [0.13.0] - 2026-10-26
 
 ### Added
@@ -513,7 +520,8 @@ author's dotfiles; the changes below are against that copy.
 
 - The published file list includes `child.ts`, which `index.ts` imports.
 
-[Unreleased]: https://github.com/gvanderclay/pi-squire/compare/v0.13.0...HEAD
+[Unreleased]: https://github.com/gvanderclay/pi-squire/compare/v0.13.1...HEAD
+[0.13.1]: https://github.com/gvanderclay/pi-squire/compare/v0.13.0...v0.13.1
 [0.13.0]: https://github.com/gvanderclay/pi-squire/compare/v0.12.0...v0.13.0
 [0.12.0]: https://github.com/gvanderclay/pi-squire/compare/v0.11.0...v0.12.0
 [0.11.0]: https://github.com/gvanderclay/pi-squire/compare/v0.10.0...v0.11.0

package/README.md

@@ -197,7 +197,8 @@ or done with auto-exit off, newest first. The model has no tool for any of this.
 Popup and switch act on the most recently active tmux client attached to the
 parent's session. With none attached they refuse with a notice; peek and close
 still work. The popup attaches to the window's session at that window, and
-detaching in it (`prefix d`) closes it. When the delegate's window goes, the parent
+detaching in it (`prefix d`) closes it; its title names that key with your
+prefix. When the delegate's window goes, the parent
 closes the popup within one poll (up to 5 s). No tmux key bindings or options are
 added.
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-squire",
-	"version": "0.13.0",
+	"version": "0.13.1",
 	"description": "Starts a delegate Pi session in a background tmux window, sends it the task over message:*, and shows the parent its result",
 	"keywords": [
 		"pi-package",

package/src/tmux.ts

@@ -139,6 +139,19 @@ async function parentSession(run: Run): Promise<Parent | undefined> {
 	return id.trim() === "" ? undefined : { id: id.trim(), name: name.join("\t"), companion: marker === "1" };
 }
 
+/**
+ * The key that starts a tmux command, as tmux names it (`C-b`), for the
+ * popup's title; `prefix` when it cannot be read or is unset.
+ */
+async function prefixKey(run: Run): Promise<string> {
+	try {
+		const key = (await run(["show-options", "-gv", "prefix"])).trim();
+		return key === "" || key === "None" ? "prefix" : key;
+	} catch {
+		return "prefix";
+	}
+}
+
 /** How long a launched popup may take to fail before it counts as shown. */
 const POPUP_SETTLE_MS = 300;
 
@@ -282,10 +295,8 @@ function navigation(
 			if (!/^\$[0-9]+$/.test(sessionId)) throw new Error(`tmux reported an invalid session id for ${window.id}`);
 			// Ids are `@N` and `$N` only; quoted so the popup's shell does not expand `$N`.
 			const command = `tmux select-window -t '${window.id}' \\; attach-session -t '${sessionId}'`;
-			await launchPopup(
-				["display-popup", "-c", client, "-E", "-w", "90%", "-h", "90%", "-T", window.name, command],
-				onExit,
-			);
+			const title = `${window.name} · ${await prefixKey(run)} d to close`;
+			await launchPopup(["display-popup", "-c", client, "-E", "-w", "90%", "-h", "90%", "-T", title, command], onExit);
 		},
 
 		async closePopup(client) {