@ekkos/cli 1.2.9 → 1.2.11

package/dist/commands/dashboard.js

@@ -565,21 +565,24 @@ async function launchDashboard(initialSessionName, jsonlPath, refreshMs) {
     // 3. Claude Code pane remains fully independent
     // 4. Text selection works across panes without interference
     // ══════════════════════════════════════════════════════════════════════════
-    // Open /dev/tty for blessed to use (gives it direct terminal access)
+    // Open /dev/tty for blessed to use (gives it direct terminal access).
+    // On macOS/Linux in tmux, this isolates the dashboard from stdout piping.
+    // On Windows (no /dev/tty), stdin/stdout is correct — blessed handles the
+    // alternate screen buffer natively for clean rendering.
     const fs = require('fs');
     let ttyInput = process.stdin;
     let ttyOutput = process.stdout;
-    try {
-        // Create readable/writable streams from /dev/tty file descriptors
-        const ttyFd = fs.openSync('/dev/tty', 'r+');
-        ttyInput = new (require('tty').ReadStream)(ttyFd);
-        ttyOutput = new (require('tty').WriteStream)(ttyFd);
-    }
-    catch (e) {
-        // Fallback: if /dev/tty unavailable (some CI/remote environments),
-        // use stdin/stdout but disable all event handling
-        ttyInput = process.stdin;
-        ttyOutput = process.stdout;
+    if (inTmux) {
+        try {
+            const ttyFd = fs.openSync('/dev/tty', 'r+');
+            ttyInput = new (require('tty').ReadStream)(ttyFd);
+            ttyOutput = new (require('tty').WriteStream)(ttyFd);
+        }
+        catch (e) {
+            // Fallback: if /dev/tty unavailable, use stdin/stdout
+            ttyInput = process.stdin;
+            ttyOutput = process.stdout;
+        }
     }
     const screen = blessed.screen({
         smartCSR: true,
@@ -596,16 +599,17 @@ async function launchDashboard(initialSessionName, jsonlPath, refreshMs) {
         resizeTimeout: 300, // Debounce resize events
     });
     // ══════════════════════════════════════════════════════════════════════════
-    // DISABLE TERMINAL CONTROL SEQUENCE HIJACKING
-    // Prevent blessed from sending control sequences that might interfere with
-    // other panes in tmux. The /dev/tty approach already isolates this, but we
-    // also disable the raw mode entirely to be extra safe.
+    // DISABLE TERMINAL CONTROL SEQUENCE HIJACKING (TMUX ONLY)
+    // When running in a tmux split pane alongside Claude Code, prevent blessed
+    // from sending control sequences that would interfere with the other pane.
+    // In standalone mode (including Windows Terminal split), blessed needs the
+    // alternate buffer and raw mode for clean rendering without artifacts.
     // ══════════════════════════════════════════════════════════════════════════
-    if (screen.program) {
-        // Override alternateBuffer to do nothing
+    if (inTmux && screen.program) {
+        // Override alternateBuffer to do nothing (tmux pane isolation)
         screen.program.alternateBuffer = () => { };
         screen.program.normalBuffer = () => { };
-        // Don't enter raw mode — let the OS handle it
+        // Don't enter raw mode — let the OS handle it (tmux pane isolation)
         if (screen.program.setRawMode) {
             screen.program.setRawMode = (enabled) => {
                 // Silently ignore raw mode requests
@@ -1404,11 +1408,13 @@ async function launchDashboard(initialSessionName, jsonlPath, refreshMs) {
     // Delay first ccusage call — let blessed render first, then load heavy data
     setTimeout(() => updateWindowBox(), 2000);
     const pollInterval = setInterval(updateDashboard, refreshMs);
+    // Animation interval — slower on Windows to reduce blessed redraw flicker
+    const animMs = process.platform === 'win32' ? 1000 : 500;
     const headerAnimInterval = setInterval(() => {
         // Keep advancing across the full session label; wrap at a large value.
         waveOffset = (waveOffset + 1) % 1000000;
         renderHeader();
-    }, 500);
+    }, animMs);
     const fortuneInterval = setInterval(() => {
         if (activeFortunes.length === 0)
             return;

package/dist/commands/run.js

@@ -1134,7 +1134,10 @@ async function run(options) {
     // ══════════════════════════════════════════════════════════════════════════
     // STARTUP BANNER WITH COLOR PULSE ANIMATION
     // ══════════════════════════════════════════════════════════════════════════
-    const skipFancyIntro = process.env.EKKOS_REMOTE_SESSION === '1' || process.env.EKKOS_NO_SPLASH === '1';
+    // Skip cursor-manipulation animations on Windows — ConPTY + cmd /c can't handle rapid
+    // cursor repositioning (\x1B[6A, \b, etc.), leaving the terminal in a dirty state that
+    // causes Ink rendering artifacts in Claude Code. Use a clean static banner instead.
+    const skipFancyIntro = isWindows || process.env.EKKOS_REMOTE_SESSION === '1' || process.env.EKKOS_NO_SPLASH === '1';
     if (!skipFancyIntro) {
         const logoLines = [
             '                      ▄▄▄▄▄    ▄▄▄▄▄▄▄     ▄▄▄ ▄▄ ▄▄',
@@ -1320,8 +1323,10 @@ async function run(options) {
         console.log('');
     }
     else {
+        // Static banner for Windows / remote / no-splash — no cursor manipulation
+        console.log('');
+        console.log(chalk_1.default.hex('#FF6B35').bold('  ekkOS_Pulse') + chalk_1.default.gray('  —  Context is finite. Intelligence isn\'t.'));
         console.log('');
-        console.log(chalk_1.default.cyan('  ekkOS remote session ready'));
         if (bypass) {
             console.log(chalk_1.default.yellow('  ⚡ Bypass permissions mode enabled'));
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ekkos/cli",
-  "version": "1.2.9",
+  "version": "1.2.11",
   "description": "Setup ekkOS memory for AI coding assistants (Claude Code, Cursor, Windsurf)",
   "main": "dist/index.js",
   "bin": {