feat: Interactive TUI Dashboard

.gitignore

@@ -118,6 +118,7 @@ dmypy.json
 # ==============================
 .vscode/
 .idea/
+.cursor/
 .spyproject/
 .ropeproject/
 .sublime-project

cortex/cli.py

@@ -817,6 +817,7 @@ def install(
         execute: bool = False,
         dry_run: bool = False,
         parallel: bool = False,
+        json_output: bool = False,
     ):
         # Validate input first
         is_valid, error = validate_install_request(software)
@@ -878,6 +879,19 @@ def install(
                     InstallationType.INSTALL, packages, commands, start_time
                 )
 
+            # If JSON output requested, return structured data and exit early
+            if json_output:
+                import json
+
+                output = {
+                    "success": True,
+                    "commands": commands,
+                    "packages": packages,
+                    "install_id": install_id,
+                }
+                print(json.dumps(output, indent=2))
+                return 0
+
             self._print_status("⚙️", f"Installing {software}...")
             print("\nGenerated commands:")
             for i, cmd in enumerate(commands, 1):
@@ -1037,17 +1051,32 @@ def parallel_log_callback(message: str, level: str = "info"):
         except ValueError as e:
             if install_id:
                 history.update_installation(install_id, InstallationStatus.FAILED, str(e))
-            self._print_error(str(e))
+            if json_output:
+                import json
+
+                print(json.dumps({"success": False, "error": str(e), "error_type": "ValueError"}))
+            else:
+                self._print_error(str(e))
             return 1
         except RuntimeError as e:
             if install_id:
                 history.update_installation(install_id, InstallationStatus.FAILED, str(e))
-            self._print_error(f"API call failed: {str(e)}")
+            if json_output:
+                import json
+
+                print(json.dumps({"success": False, "error": str(e), "error_type": "RuntimeError"}))
+            else:
+                self._print_error(f"API call failed: {str(e)}")
             return 1
         except OSError as e:
             if install_id:
                 history.update_installation(install_id, InstallationStatus.FAILED, str(e))
-            self._print_error(f"System error: {str(e)}")
+            if json_output:
+                import json
+
+                print(json.dumps({"success": False, "error": str(e), "error_type": "OSError"}))
+            else:
+                self._print_error(f"System error: {str(e)}")
             return 1
         except Exception as e:
             if install_id:
@@ -2827,6 +2856,25 @@ def progress_callback(current: int, total: int, step: InstallationStep) -> None:
 
     # --------------------------
 
+    def dashboard(self) -> int:
+        """Launch the real-time system monitoring dashboard"""
+        try:
+            from cortex.dashboard import DashboardApp
+
+            app = DashboardApp()
+            rc = app.run()
+            return rc
+        except ImportError as e:
+            self._print_error(f"Dashboard dependencies not available: {e}")
+            cx_print("Install required packages with:", "info")
+            cx_print("  pip install psutil pynvml", "info")
+            return 1
+        except KeyboardInterrupt:
+            return 0
+        except Exception as e:
+            self._print_error(f"Dashboard error: {e}")
+            return 1
+
 
 def show_rich_help():
     """Display a beautifully formatted help table using the Rich library.
@@ -2965,6 +3013,11 @@ def main():
     # Demo command
     demo_parser = subparsers.add_parser("demo", help="See Cortex in action")
 
+    # Dashboard command
+    dashboard_parser = subparsers.add_parser(
+        "dashboard", help="Real-time system monitoring dashboard"
+    )
+
     # Wizard command
     wizard_parser = subparsers.add_parser("wizard", help="Configure API key interactively")
 
@@ -3566,6 +3619,8 @@ def main():
 
         if args.command == "demo":
             return cli.demo()
+        elif args.command == "dashboard":
+            return cli.dashboard()
         elif args.command == "wizard":
             return cli.wizard()
         elif args.command == "status":