From 71373f80d45e1a73461d92675cb26845a8781fb1 Mon Sep 17 00:00:00 2001
From: arkon <arkon.85@hotmail.com>
Date: Wed, 21 Jan 2026 06:24:55 +0100
Subject: [PATCH] docs(tui): update HelpOverlay with all TUI shortcuts

- Add Start Screen section with arrow navigation and attach
- Separate Main View into Navigation and Session Management
- Include all new shortcuts (Enter, a, arrows)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 src/tui/components/HelpOverlay.tsx | 28 +++++++++++++++-------------
 1 file changed, 15 insertions(+), 13 deletions(-)

diff --git a/src/tui/components/HelpOverlay.tsx b/src/tui/components/HelpOverlay.tsx
index fbed6adf..9641a021 100644
--- a/src/tui/components/HelpOverlay.tsx
+++ b/src/tui/components/HelpOverlay.tsx
@@ -19,31 +19,33 @@ interface ShortcutGroup {
 
 const SHORTCUT_GROUPS: ShortcutGroup[] = [
   {
-    title: 'Navigation',
+    title: 'Start Screen',
     shortcuts: [
-      { key: 'Ctrl+Tab', description: 'Next session' },
-      { key: 'Ctrl+Shift+Tab', description: 'Previous session' },
+      { key: '\u2191/\u2193', description: 'Navigate session list' },
+      { key: 'Enter', description: 'View session in TUI' },
+      { key: 'a', description: 'Attach to screen (full terminal)' },
+      { key: 'n', description: 'Create new session' },
+      { key: 'r', description: 'Refresh session list' },
+      { key: 'q', description: 'Quit' },
+    ],
+  },
+  {
+    title: 'Main View - Navigation',
+    shortcuts: [
+      { key: 'Ctrl+Tab', description: 'Next session tab' },
+      { key: 'Ctrl+Shift+Tab', description: 'Previous session tab' },
       { key: 'Ctrl+1-9', description: 'Go to session N' },
       { key: 'Escape', description: 'Back to start screen' },
     ],
   },
   {
-    title: 'Session Management',
+    title: 'Main View - Session Management',
     shortcuts: [
       { key: 'Ctrl+N', description: 'New session' },
       { key: 'Ctrl+W', description: 'Close current session' },
       { key: 'Ctrl+K', description: 'Kill all sessions' },
     ],
   },
-  {
-    title: 'Start Screen',
-    shortcuts: [
-      { key: '1-9', description: 'Select session by number' },
-      { key: 'n', description: 'Create new session' },
-      { key: 'r', description: 'Refresh session list' },
-      { key: 'q', description: 'Quit' },
-    ],
-  },
   {
     title: 'General',
     shortcuts: [