storymode-cli 1.3.7 → 1.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "storymode-cli",
-  "version": "1.3.7",
+  "version": "1.4.0",
   "description": "Play AI-animated pixel art characters in your terminal",
   "type": "module",
   "bin": {

package/src/cli.mjs

@@ -203,10 +203,11 @@ export async function run(args) {
       // but iTerm2's \x1b[2J is intercepted by tmux). So for iTerm2 we use native
       // splits (AppleScript) instead of tmux, keeping the companion process direct.
       const renderMode = detectGraphicsProtocol();
-      // iTerm2 inside tmux: can't clear inline images (\x1b[2J intercepted by tmux).
-      // Kitty/Ghostty work fine in tmux (a=d,d=a deletes placements).
-      const useHd = renderMode.protocol === 'kitty'
-        || (renderMode.protocol === 'iterm2' && !renderMode.inTmux);
+      // HD only works with Kitty protocol (Kitty/Ghostty/WezTerm) — they have
+      // a=d,d=a to delete previous image placements between frames.
+      // iTerm2 inline images are permanent (can't be replaced or cleared),
+      // so animation is impossible — fall back to ANSI.
+      const useHd = renderMode.protocol === 'kitty';
       const paneWidth = useHd && size === 'full' ? 80 : size === 'full' ? 62 : size === 'tiny' ? 14 : 22;
 
       // If we're already the companion pane (spawned by tmux split), play inline
@@ -250,35 +251,6 @@ export async function run(args) {
       const modelFlag = model ? ` --model=${model}` : '';
       const companionCmd = `STORYMODE_COMPANION=1 npx --yes storymode-cli play ${id} --size=${size}${sextantFlag}${reactiveFlag}${noAiFlag}${modelFlag}`;
 
-      // iTerm2 (not in tmux): use native split to keep HD working.
-      // iTerm2 inline images can't be cleared through tmux passthrough,
-      // so we avoid tmux entirely and use AppleScript to split the pane.
-      // Use "write text" instead of "command" — the latter uses execve directly
-      // (no shell, no PATH, no env vars). "write text" types into the new
-      // pane's shell, which inherits everything.
-      if (renderMode.protocol === 'iterm2' && !renderMode.inTmux) {
-        try {
-          execSync(`osascript -e '
-            tell application "iTerm2"
-              tell current session of current tab of current window
-                set newSession to split vertically with default profile
-                tell newSession
-                  write text "${companionCmd.replace(/"/g, '\\"')}"
-                end tell
-              end tell
-            end tell
-          '`, { stdio: 'ignore' });
-          process.stderr.write(`  Companion opened in iTerm2 pane (${size} HD/${renderMode.protocol}).\n`);
-          process.stderr.write('  Close the pane or press q in it to stop.\n');
-        } catch (err) {
-          console.error(`  iTerm2 split failed: ${err.message}`);
-          console.error('  Falling back to tmux...');
-          // Fall through to tmux path below
-          renderMode.protocol = null;
-        }
-        if (renderMode.protocol) break;
-      }
-
       // Open tmux side pane — install tmux if needed
       if (!await ensureTmux()) process.exit(1);
       const inTmux = !!process.env.TMUX;

package/src/player.mjs

@@ -439,19 +439,18 @@ export async function playReactiveCompanion(animMap, opts = {}) {
         const delSeq = `\x1b_Ga=d,d=a\x1b\\`;
         stdout.write(hdInTmux ? wrapForTmux(delSeq) : delSeq);
         writeKitty(currentPngFrames[idx], null, imageRows || undefined, hdInTmux);
-      } else {
-        // iTerm2: clear to release previous images from memory
-        stdout.write(fullscreen ? '\x1b[2J\x1b[H' : '\x1b8');
-        if (!fullscreen) {
-          // Clear the image area to release old images
-          for (let i = 0; i < maxLines; i++) stdout.write('\x1b[K\n');
-          stdout.write(fullscreen ? '\x1b[H' : '\x1b8');
+        // Kitty needs explicit cursor positioning after image
+        if (imageRows > 0) {
+          stdout.write(`\x1b[${imageRows + 1};1H`);
         }
-        writeIterm2(currentPngFrames[idx], null, imageRows || undefined, hdInTmux);
-      }
-      // Move cursor below the image area for text rendering
-      if (imageRows > 0) {
-        stdout.write(`\x1b[${imageRows}B`);
+      } else {
+        // iTerm2: clear screen to release previous inline images from memory,
+        // then render new image. Cursor advances past the image automatically.
+        stdout.write('\x1b[2J\x1b[H');
+        // Use width=pane columns, let preserveAspectRatio size the height
+        const paneCols = process.stdout.columns || 80;
+        writeIterm2(currentPngFrames[idx], paneCols, null, hdInTmux);
+        stdout.write('\n'); // ensure cursor is on next line after image
       }
     } else {
       // --- ANSI fallback path ---