aline-ai 0.5.13__py3-none-any.whl → 0.6.1__py3-none-any.whl

realign/dashboard/app.py

@@ -1,5 +1,6 @@
 """Aline Dashboard - Main Application."""
 
+import os
 import subprocess
 import sys
 import time
@@ -22,6 +23,9 @@ from .widgets import (
     TerminalPanel,
 )
 
+# Environment variable to control terminal mode
+ENV_TERMINAL_MODE = "ALINE_TERMINAL_MODE"
+
 # Set up dashboard logger - logs to ~/.aline/.logs/dashboard.log
 logger = setup_logger("realign.dashboard", "dashboard.log")
 
@@ -74,15 +78,31 @@ class AlineDashboard(App):
 
     _quit_confirm_window_s: float = 1.2
 
-    def __init__(self, dev_mode: bool = False):
+    def __init__(self, dev_mode: bool = False, use_native_terminal: bool | None = None):
         """Initialize the dashboard.
 
         Args:
             dev_mode: If True, shows developer tabs (Watcher, Worker).
+            use_native_terminal: If True, use native terminal backend (iTerm2/Kitty).
+                                 If False, use tmux.
+                                 If None (default), auto-detect from ALINE_TERMINAL_MODE env var.
         """
         super().__init__()
         self.dev_mode = dev_mode
-        logger.info(f"AlineDashboard initialized (dev_mode={dev_mode})")
+        self.use_native_terminal = use_native_terminal
+        self._native_terminal_mode = self._detect_native_mode()
+        logger.info(
+            f"AlineDashboard initialized (dev_mode={dev_mode}, "
+            f"native_terminal={self._native_terminal_mode})"
+        )
+
+    def _detect_native_mode(self) -> bool:
+        """Detect if native terminal mode should be used."""
+        if self.use_native_terminal is not None:
+            return self.use_native_terminal
+
+        mode = os.environ.get(ENV_TERMINAL_MODE, "").strip().lower()
+        return mode in {"native", "iterm2", "iterm", "kitty"}
 
     def compose(self) -> ComposeResult:
         """Compose the dashboard layout."""
@@ -92,7 +112,7 @@ class AlineDashboard(App):
             tab_ids = self._tab_ids()
             with TabbedContent(initial=tab_ids[0] if tab_ids else "terminal"):
                 with TabPane("Agents", id="terminal"):
-                    yield TerminalPanel()
+                    yield TerminalPanel(use_native_terminal=self.use_native_terminal)
                 if self.dev_mode:
                     with TabPane("Watcher", id="watcher"):
                         yield WatcherPanel()
@@ -125,11 +145,47 @@ class AlineDashboard(App):
             # Check for system theme changes every 2 seconds
             self.set_interval(2, self._sync_theme)
             self._quit_confirm_deadline: float | None = None
+
+            # Set up side-by-side layout for native terminal mode
+            if self._native_terminal_mode:
+                self._setup_native_terminal_layout()
+
             logger.info("on_mount() completed successfully")
         except Exception as e:
             logger.error(f"on_mount() failed: {e}\n{traceback.format_exc()}")
             raise
 
+    def _setup_native_terminal_layout(self) -> None:
+        """Set up side-by-side layout for Dashboard and native terminal."""
+        # Skip if using iTerm2 split pane mode (already set up by CLI)
+        if os.environ.get("ALINE_ITERM2_RIGHT_PANE"):
+            logger.info("Using iTerm2 split pane mode, skipping window layout")
+            return
+
+        try:
+            from .layout import setup_side_by_side_layout
+
+            # Determine the target terminal app
+            mode = os.environ.get(ENV_TERMINAL_MODE, "").strip().lower()
+            if mode == "kitty":
+                terminal_app = "Kitty"
+            else:
+                terminal_app = "iTerm2"
+
+            # Set up side-by-side layout (Dashboard on left, terminal on right)
+            success = setup_side_by_side_layout(
+                terminal_app=terminal_app,
+                dashboard_on_left=True,
+                dashboard_width_percent=40,  # Dashboard takes 40%, terminal takes 60%
+            )
+
+            if success:
+                logger.info(f"Set up side-by-side layout with {terminal_app}")
+            else:
+                logger.warning("Failed to set up side-by-side layout")
+        except Exception as e:
+            logger.warning(f"Could not set up native terminal layout: {e}")
+
     def _sync_theme(self) -> None:
         """Sync app theme with system theme."""
         target_theme = "textual-dark" if _detect_system_dark_mode() else "textual-light"
@@ -357,11 +413,17 @@ class AlineDashboard(App):
         self.notify(f"Loaded {what} into {context_id}", title="Load Context", timeout=3)
 
 
-def run_dashboard() -> None:
-    """Run the Aline Dashboard."""
+def run_dashboard(use_native_terminal: bool | None = None) -> None:
+    """Run the Aline Dashboard.
+
+    Args:
+        use_native_terminal: If True, use native terminal backend (iTerm2/Kitty).
+                             If False, use tmux.
+                             If None (default), auto-detect from ALINE_TERMINAL_MODE env var.
+    """
     logger.info("Starting Aline Dashboard")
     try:
-        app = AlineDashboard()
+        app = AlineDashboard(use_native_terminal=use_native_terminal)
         app.run()
         logger.info("Aline Dashboard exited normally")
     except Exception as e:

realign/dashboard/backends/__init__.py

@@ -0,0 +1,6 @@
+"""Terminal backends for native terminal support."""
+
+from .iterm2 import ITermBackend
+from .kitty import KittyBackend
+
+__all__ = ["ITermBackend", "KittyBackend"]