refactor(tui): 🔨 enhance clear_screen with optional header display

The `clear_screen()` function in both launcher_tui.py and settings_tool.py has been enhanced to accept an optional subtitle parameter that displays a consistent header panel when provided.

- Add `subtitle` parameter to `clear_screen()` function
- Display formatted header panel with subtitle when provided
- Update function calls to use new subtitle feature in settings tool (e.g., "Save Changes", "Exit Without Saving")
- Remove redundant clear_screen call in launcher after startup message
- Improve code reuse and consistency across TUI interfaces

Author: Mirrowel

src/proxy_app/launcher_tui.py

@@ -30,16 +30,26 @@ def _get_env_file() -> Path:
     return Path.cwd() / ".env"
 
 
-def clear_screen():
+def clear_screen(subtitle: str = ""):
     """
-    Cross-platform terminal clear that works robustly on both
-    classic Windows conhost and modern terminals (Windows Terminal, Linux, Mac).
+    Cross-platform terminal clear with optional header.
 
     Uses native OS commands instead of ANSI escape sequences:
     - Windows (conhost & Windows Terminal): cls
     - Unix-like systems (Linux, Mac): clear
+
+    Args:
+        subtitle: If provided, displays a header panel with this subtitle.
+                  If empty/None, just clears the screen.
     """
     os.system("cls" if os.name == "nt" else "clear")
+    if subtitle:
+        console.print(
+            Panel(
+                f"[bold cyan]{subtitle}[/bold cyan]",
+                title="--- API Key Proxy ---",
+            )
+        )
 
 
 class LauncherConfig:
@@ -967,11 +977,10 @@ def run_proxy(self):
             f"\n[bold green]🚀 Starting proxy on {self.config.config['host']}:{self.config.config['port']}...[/bold green]\n"
         )
 
-        # Clear console again to remove the starting message before main.py shows loading details
+        # Brief pause so user sees the message before main.py takes over
         import time
 
-        time.sleep(0.5)  # Brief pause so user sees the message
-        clear_screen()
+        time.sleep(0.5)
 
         # Reconstruct sys.argv for main.py
         sys.argv = [

src/proxy_app/settings_tool.py

@@ -43,16 +43,26 @@
     IFLOW_DEFAULT_OAUTH_PORT = 11451
 
 
-def clear_screen():
+def clear_screen(subtitle: str = ""):
     """
-    Cross-platform terminal clear that works robustly on both
-    classic Windows conhost and modern terminals (Windows Terminal, Linux, Mac).
+    Cross-platform terminal clear with optional header.
 
     Uses native OS commands instead of ANSI escape sequences:
     - Windows (conhost & Windows Terminal): cls
     - Unix-like systems (Linux, Mac): clear
+
+    Args:
+        subtitle: If provided, displays a header panel with this subtitle.
+                  If empty/None, just clears the screen.
     """
     os.system("cls" if os.name == "nt" else "clear")
+    if subtitle:
+        console.print(
+            Panel(
+                f"[bold cyan]{subtitle}[/bold cyan]",
+                title="--- API Key Proxy ---",
+            )
+        )
 
 
 class AdvancedSettings:
@@ -1443,9 +1453,8 @@ def manage_provider_settings(self):
     def _manage_single_provider_settings(self, provider: str):
         """Manage settings for a single provider"""
         while True:
-            clear_screen()
-
             display_name = provider.replace("_", " ").title()
+            clear_screen()
             definitions = self.provider_settings_mgr.get_provider_settings_definitions(
                 provider
             )
@@ -2401,7 +2410,7 @@ def _show_changes_summary(self):
     def save_and_exit(self):
         """Save pending changes and exit"""
         if self.settings.has_pending():
-            clear_screen()
+            clear_screen("Save Changes")
             self._show_changes_summary()
 
             if Confirm.ask("\n[bold yellow]Save all pending changes?[/bold yellow]"):
@@ -2421,7 +2430,7 @@ def save_and_exit(self):
     def exit_without_saving(self):
         """Exit without saving"""
         if self.settings.has_pending():
-            clear_screen()
+            clear_screen("Exit Without Saving")
             self._show_changes_summary()
 
             if Confirm.ask("\n[bold red]Discard all pending changes?[/bold red]"):