fix: iterm2 keybindings (#429)

Co-authored-by: Letta <noreply@letta.com>

src/cli/components/InputRich.tsx

@@ -173,6 +173,13 @@ export function Input({
   // Handle escape key for interrupt (when streaming) or double-escape-to-clear (when not)
   useInput((_input, key) => {
     if (!visible) return;
+    // Debug logging for escape key detection
+    if (process.env.LETTA_DEBUG_KEYS === "1" && key.escape) {
+      // eslint-disable-next-line no-console
+      console.error(
+        `[debug:InputRich:escape] escape=${key.escape} visible=${visible} onEscapeCancel=${!!onEscapeCancel} streaming=${streaming}`,
+      );
+    }
     // Skip if onEscapeCancel is provided - handled by the confirmation handler above
     if (onEscapeCancel) return;
 
@@ -232,6 +239,13 @@ export function Input({
   // Handle Shift+Tab for permission mode cycling
   useInput((_input, key) => {
     if (!visible) return;
+    // Debug logging for shift+tab detection
+    if (process.env.LETTA_DEBUG_KEYS === "1" && (key.shift || key.tab)) {
+      // eslint-disable-next-line no-console
+      console.error(
+        `[debug:InputRich] shift=${key.shift} tab=${key.tab} visible=${visible}`,
+      );
+    }
     if (key.shift && key.tab) {
       // Cycle through permission modes
       const modes: PermissionMode[] = [

src/cli/utils/kittyProtocolDetector.ts

@@ -10,16 +10,28 @@ let kittySupported = false;
 let kittyEnabled = false;
 
 const DEBUG = process.env.LETTA_DEBUG_KITTY === "1";
+const DISABLED = process.env.LETTA_DISABLE_KITTY === "1";
 
 /**
  * Detects Kitty keyboard protocol support.
  * This function should be called once at app startup, before rendering.
+ * Set LETTA_DISABLE_KITTY=1 to skip enabling the protocol (useful for debugging).
  */
 export async function detectAndEnableKittyProtocol(): Promise<void> {
   if (detectionComplete) {
     return;
   }
 
+  // Allow disabling Kitty protocol for debugging terminal issues
+  if (DISABLED) {
+    if (DEBUG) {
+      // eslint-disable-next-line no-console
+      console.error("[kitty] protocol disabled via LETTA_DISABLE_KITTY=1");
+    }
+    detectionComplete = true;
+    return;
+  }
+
   return new Promise((resolve) => {
     if (!process.stdin.isTTY || !process.stdout.isTTY) {
       detectionComplete = true;