feat: Normal App mode, Settings UI tabs, Dev Hub sub-title

CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 1.0.70
+
+- Feat: Normal App mode — window stays visible, shows in Dock, draggable
+  - Toggle in Settings: Normal App (default for new users) / Menu Bar
+  - Instant switching, no restart needed
+  - `Cmd+Ctrl+R` toggles show/hide in both modes
+  - Title bar shows "Dev Hub" sub-title + mode indicator + shortcut key
+  - Banner on first launch and mode switch (auto-dismiss)
+  - Clicking Dock icon shows hidden window
+- Feat: Settings UI redesigned with tabs (General / Sessions / Shortcuts)
+  - All settings visible without scrolling
+  - No more content changing based on active main tab
+  - Hints on context-specific settings (projects/sessions/tray)
+- Style: Terminal renamed to Terminal.app in Launch Terminal dropdown
+- Style: title bar padding reduced for tighter layout
+
 ## 1.0.69
 
 - Feat: adaptive VS Code resume via IDE lock file polling

README.md

@@ -8,7 +8,7 @@ Quick switcher for VS Code/Cursor projects, Claude Code session manager with liv
 
 ### Quick Switcher for VS Code / Cursor Projects
 
-Spotlight-like quick open: press `⌃+⌘+R` or click the menu bar icon to launch the Quick Switcher. Search and select a project to open or switch to it in VS Code or Cursor — even if the IDE is not running yet.
+Press `⌃+⌘+R` or click the menu bar icon to launch the Quick Switcher. Search and select a project to open or switch to it in VS Code or Cursor — even if the IDE is not running yet. In Normal App mode, the window stays visible for monitoring; in Menu Bar mode, it works like Spotlight.
 
 - **Recent projects** (white items): your latest VS Code/Cursor folders, workspaces, and recently opened files — read directly from IDE data, no extension required
 - **Working folder items** (green items): first-level subfolders found by scanning a folder you choose (Settings → Working Directory)
@@ -52,6 +52,22 @@ CodeV includes a built-in terminal tab (powered by xterm.js + node-pty, same tec
 - `Cmd+←/→` jumps to beginning/end of line
 - **"Claude in Terminal" button**: launches a new Claude Code session in the configured external terminal using the current working directory
 
+### App Mode
+
+CodeV supports two window modes, configurable in Settings → App Mode:
+
+| | Normal App (default) | Menu Bar |
+|--|--|--|
+| **Dock** | Visible | Hidden |
+| **On blur** | Stays visible | Auto-hides |
+| **Window position** | Remembers last position, draggable | Centers on screen each time |
+| **On startup** | Shows window | Hidden until shortcut/tray click |
+| **`⌃+⌘+R`** | Toggle show/hide | Toggle show/hide |
+| **Click Dock icon** | Shows hidden window | N/A |
+| **Best for** | Dashboard / monitoring (keep in corner) | Quick access (spotlight-like) |
+
+**Real-time updates when unfocused (Normal mode):** Status dots, final assistant/user messages, and session order update via fs.watch — no need to re-focus. New sessions and full list refresh only occur on re-focus.
+
 ### Tab Switching
 
 | Shortcut | Action |

package.json

@@ -1,7 +1,7 @@
 {
   "name": "CodeV",
   "productName": "CodeV",
-  "version": "1.0.69",
+  "version": "1.0.70",
   "description": "Quick switcher for VS Code, Cursor, and Claude Code sessions",
   "repository": {
     "type": "git",

src/electron-api.d.ts

@@ -28,6 +28,12 @@ interface IElectronAPI {
   getUpdateStatus: () => Promise<{ status: string; releaseName?: string; error?: string } | null>;
   onUpdateStatus: (callback: IpcCallback) => void;
 
+  // App mode
+  getAppMode: () => Promise<string>;
+  setAppMode: (mode: string) => void;
+  onAppModeChanged: (callback: IpcCallback) => void;
+  onShortcutsUpdated: (callback: IpcCallback) => void;
+
   // Session terminal settings
   getSessionTerminalApp: () => Promise<string>;
   setSessionTerminalApp: (app: string) => void;

src/main.ts

@@ -81,6 +81,9 @@ let serverProcess: any;
 const WIN_WIDTH = 800;
 const WIN_HEIGHT = 600;
 
+// App mode: 'normal' (dock visible, no auto-hide) or 'menubar' (hidden dock, auto-hide on blur)
+let appMode: 'normal' | 'menubar' = 'normal'; // default to normal for new users
+
 const getWindowPosition = () => {
   const primaryDisplay = screen.getPrimaryDisplay();
   const { width, height } = primaryDisplay.workAreaSize;
@@ -95,19 +98,23 @@ const getWindowPosition = () => {
 // NOTE: setVisibleOnAllWorkspaces is needed ?
 const showSwitcherWindow = () => {
   let window = getSwitcherWindow();
-  
+
   if (!window) {
     // Recreate window if it has been destroyed
     switcherWindow = createSwitcherWindow();
     window = switcherWindow;
   }
-
-  const position = getWindowPosition();
-  window.setPosition(position.x, position.y, false);
+
+  if (appMode === 'menubar') {
+    // Menu bar mode: always center on screen
+    const position = getWindowPosition();
+    window.setPosition(position.x, position.y, false);
+  }
+  if (window.isMinimized()) {
+    window.restore();
+  }
   window.show();
-  // mainWindow.setVisibleOnAllWorkspaces(true);
   window.focus();
-  // mainWindow.setVisibleOnAllWorkspaces(false);
 };
 
 const showAIAssistantWindow = () => {
@@ -258,6 +265,8 @@ const hideSwitcherWindow = () => {
 };
 
 const onBlur = (event: any) => {
+  // Normal mode: don't auto-hide on blur
+  if (appMode === 'normal') return;
   hideSwitcherWindow();
 };
 
@@ -506,6 +515,11 @@ app.on('activate', () => {
   if (BrowserWindow.getAllWindows().length === 0) {
     switcherWindow = createSwitcherWindow();
   }
+  // Normal mode: clicking Dock icon shows hidden window
+  const window = getSwitcherWindow();
+  if (window && !window.isVisible()) {
+    showSwitcherWindow();
+  }
 });
 
 /** https://www.electronjs.org/docs/latest/tutorial/ipc */
@@ -1016,6 +1030,12 @@ const trayToggleEvtHandler = async () => {
 (async () => {
   await app.whenReady();
 
+  // Load app mode setting early (before window creation)
+  appMode = ((await settings.get('app-mode')) as 'normal' | 'menubar') || 'normal';
+  if (appMode === 'menubar') {
+    app.dock.hide();
+  }
+
   // Auto-update: check for updates via update.electronjs.org (non-MAS only)
   if (!isMAS()) {
     try {
@@ -1061,6 +1081,11 @@ const trayToggleEvtHandler = async () => {
   }
 
   switcherWindow = createSwitcherWindow();
+  // Normal mode: show window after bootstrap (server must be ready for API calls)
+  if (appMode === 'normal') {
+    // Delay show to ensure bootstrap() has completed (runs earlier in this block)
+    setTimeout(() => showSwitcherWindow(), 100);
+  }
   if (isDebug) {
     console.log('when ready');
   }
@@ -1293,7 +1318,7 @@ const trayToggleEvtHandler = async () => {
     } else {
       const window = getSwitcherWindow();
 
-      if (window && window.isVisible()) {
+      if (window && window.isVisible() && !window.isMinimized()) {
         if (isDebug) {
           console.log('Switcher window visible, hiding it');
         }
@@ -1679,6 +1704,8 @@ const trayToggleEvtHandler = async () => {
     if (registered) {
       await settings.set(`shortcut-${key}`, accelerator);
       await syncTrayShortcuts();
+      // Notify switcher window to update shortcut display
+      switcherWindow?.webContents.send('shortcuts-updated', await getCurrentShortcuts());
       return { success: true };
     } else {
       // Re-register the old shortcut since the new one failed
@@ -1694,6 +1721,8 @@ const trayToggleEvtHandler = async () => {
     }
     await registerAllShortcuts();
     await syncTrayShortcuts();
+    // Notify switcher window to update shortcut display
+    switcherWindow?.webContents.send('shortcuts-updated', DEFAULT_SHORTCUTS);
     return DEFAULT_SHORTCUTS;
   });
 })();
@@ -1934,6 +1963,31 @@ ipcMain.handle('get-session-statuses', async () => {
   return obj;
 });
 
+ipcMain.handle('get-app-mode', async () => {
+  return appMode;
+});
+
+ipcMain.on('set-app-mode', async (_event, mode: string) => {
+  const newMode = mode === 'menubar' ? 'menubar' : 'normal';
+  await settings.set('app-mode', newMode);
+  appMode = newMode;
+  if (newMode === 'menubar') {
+    app.dock.hide();
+  } else {
+    await app.dock.show();
+  }
+  // Notify renderer to update drag region
+  const window = getSwitcherWindow();
+  if (window) {
+    window.webContents.send('app-mode-changed', newMode);
+    // Re-center when switching to menu bar mode
+    if (newMode === 'menubar') {
+      const position = getWindowPosition();
+      window.setPosition(position.x, position.y, false);
+    }
+  }
+});
+
 ipcMain.handle('get-session-terminal-app', async () => {
   return (await settings.get('session-terminal-app')) || 'iterm2';
 });
@@ -2077,4 +2131,4 @@ ipcMain.handle('detect-active-ide-projects', async () => {
   return Array.from(folderNames);
 });
 
-app.dock.hide();
+// app.dock.hide() moved to async init block (after settings loaded)