pi-btw 0.2.0 → 0.2.1

package/README.md

@@ -13,6 +13,7 @@ A small [pi](https://github.com/badlogic/pi-mono) extension that adds a `/btw` s
 - keeps a continuous BTW thread by default
 - supports `/btw:tangent` for a contextless side thread that does not inherit the current main-session conversation
 - opens a focused BTW modal shell with its own composer and transcript
+- keeps the BTW overlay open while you switch focus back to the main editor with `Alt+/`
 - keeps BTW thread entries out of the main agent's future context
 - lets you inject the full thread, or a summary of it, back into the main agent
 - optionally saves an individual BTW exchange as a visible session note with `--save`
@@ -69,6 +70,13 @@ pi install /absolute/path/to/pi-btw
 - persists the BTW exchange as hidden thread state
 - with `--save`, also saves that single exchange as a visible session note
 
+## Overlay controls
+
+- `Alt+/` toggles focus between BTW and the main editor without closing the overlay
+- `Ctrl+Alt+W` is a fallback focus toggle for terminals that do not deliver `Alt+/` as a usable shortcut
+- `Esc` still dismisses BTW immediately while the overlay is focused
+- BTW now opens top-centered so the main session remains visible underneath it
+
 ### `/btw:new [question]`
 
 - clears the current BTW thread

package/extensions/btw.ts

@@ -31,6 +31,11 @@ import {
 const BTW_MESSAGE_TYPE = "btw-note";
 const BTW_ENTRY_TYPE = "btw-thread-entry";
 const BTW_RESET_TYPE = "btw-thread-reset";
+const BTW_FOCUS_SHORTCUTS = [Key.alt("/"), Key.ctrlAlt("w")] as const;
+
+function matchesBtwFocusShortcut(data: string): boolean {
+  return BTW_FOCUS_SHORTCUTS.some((shortcut) => matchesKey(data, shortcut));
+}
 
 const BTW_SYSTEM_PROMPT = [
   "You are having an aside conversation with the user, separate from their main working session.",
@@ -940,6 +945,7 @@ class BtwOverlayComponent extends Container implements Focusable {
   private readonly getMode: () => BtwThreadMode;
   private readonly onSubmitCallback: (value: string) => void;
   private readonly onDismissCallback: () => void;
+  private readonly onUnfocusCallback: () => void;
   private readonly tui: TUI;
   private readonly theme: ExtensionContext["ui"]["theme"];
   private transcriptLines: string[] = [];
@@ -966,6 +972,7 @@ class BtwOverlayComponent extends Container implements Focusable {
     getMode: () => BtwThreadMode,
     onSubmit: (value: string) => void,
     onDismiss: () => void,
+    onUnfocus: () => void,
   ) {
     super();
     this.tui = tui;
@@ -975,6 +982,7 @@ class BtwOverlayComponent extends Container implements Focusable {
     this.getMode = getMode;
     this.onSubmitCallback = onSubmit;
     this.onDismissCallback = onDismiss;
+    this.onUnfocusCallback = onUnfocus;
 
     this.modeText = new Text("", 1, 0);
     this.summaryText = new Text("", 1, 0);
@@ -1034,10 +1042,15 @@ class BtwOverlayComponent extends Container implements Focusable {
 
   private getDialogHeight(): number {
     const terminalRows = process.stdout.rows ?? 30;
-    return Math.max(16, Math.min(24, Math.floor(terminalRows * 0.7)));
+    return Math.max(18, Math.min(32, Math.floor(terminalRows * 0.78)));
   }
 
   handleInput(data: string): void {
+    if (matchesBtwFocusShortcut(data)) {
+      this.onUnfocusCallback();
+      return;
+    }
+
     if (matchesKey(data, Key.pageUp)) {
       this.followTranscript = false;
       this.transcriptScrollOffset = Math.max(0, this.transcriptScrollOffset - Math.max(1, this.transcriptViewportHeight - 1));
@@ -1151,7 +1164,7 @@ class BtwOverlayComponent extends Container implements Focusable {
 
     const status = this.getStatus() ?? "Ready. Enter submits; Escape dismisses without clearing.";
     this.statusText.setText(status);
-    this.hintsText.setText("Enter submit · Escape dismiss · PgUp/PgDn scroll · /btw:clear resets thread");
+    this.hintsText.setText("Enter submit · Alt+/ toggle focus · Escape dismiss · PgUp/PgDn scroll");
     this.tui.requestRender();
   }
 }
@@ -1189,6 +1202,32 @@ export default function (pi: ExtensionAPI) {
     overlayRuntime = null;
   }
 
+  function toggleOverlayFocus(): void {
+    const handle = overlayRuntime?.handle;
+    if (!handle) {
+      return;
+    }
+
+    handle.setHidden(false);
+    if (handle.isFocused()) {
+      handle.unfocus();
+    } else {
+      handle.focus();
+    }
+    overlayRuntime?.refresh?.();
+  }
+
+  function focusOverlay(): void {
+    const handle = overlayRuntime?.handle;
+    if (!handle) {
+      return;
+    }
+
+    handle.setHidden(false);
+    handle.focus();
+    overlayRuntime?.refresh?.();
+  }
+
   function removeBtwSessionSubscription(sessionRuntime: BtwSessionRuntime, unsubscribe: () => void): void {
     if (!sessionRuntime.subscriptions.delete(unsubscribe)) {
       return;
@@ -1318,9 +1357,7 @@ export default function (pi: ExtensionAPI) {
 
     if (overlayRuntime?.handle) {
       subscribeOverlayToActiveBtwSession(ctx);
-      overlayRuntime.handle.setHidden(false);
-      overlayRuntime.handle.focus();
-      overlayRuntime.refresh?.();
+      focusOverlay();
       return;
     }
 
@@ -1363,6 +1400,10 @@ export default function (pi: ExtensionAPI) {
             () => {
               void dismissOverlaySession();
             },
+            () => {
+              overlayRuntime?.handle?.unfocus();
+              overlayRuntime?.refresh?.();
+            },
           );
 
           overlay.focused = runtime.handle?.isFocused() ?? true;
@@ -1393,8 +1434,9 @@ export default function (pi: ExtensionAPI) {
             width: "78%",
             minWidth: 72,
             maxHeight: "78%",
-            anchor: "center",
-            margin: 1,
+            anchor: "top-center",
+            margin: { top: 1, left: 2, right: 2 },
+            nonCapturing: true,
           },
           onHandle: (handle) => {
             runtime.handle = handle;
@@ -1836,6 +1878,15 @@ export default function (pi: ExtensionAPI) {
     dismissOverlay();
   });
 
+  for (const shortcut of BTW_FOCUS_SHORTCUTS) {
+    pi.registerShortcut(shortcut, {
+      description: "Toggle BTW overlay focus while leaving it open.",
+      handler: async (_args, _ctx) => {
+        toggleOverlayFocus();
+      },
+    });
+  }
+
   pi.registerCommand("btw", {
     description: "Continue a side conversation in a focused BTW modal. Add --save to also persist a visible note.",
     handler: async (args, ctx) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-btw",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "A pi extension for parallel side conversations with /btw",
   "type": "module",
   "license": "MIT",