refactor: streamline Electron API integration and enhance UI components

- Removed unused Electron API methods and simplified the main process.
- Introduced a new workspace picker modal for improved project selection.
- Enhanced error handling for authentication issues across various components.
- Updated UI styles for dark mode support and added new CSS variables.
- Refactored session management to utilize a centralized API access method.
- Added server routes for workspace management, including directory listing and configuration checks.

apps/app/src/components/views/board-view.tsx

@@ -583,10 +583,24 @@ export function BoardView() {
         }
 
         loadFeatures();
-        // Show error toast
-        toast.error("Agent encountered an error", {
-          description: event.error || "Check the logs for details",
-        });
+
+        // Check for authentication errors and show a more helpful message
+        const isAuthError = event.errorType === "authentication" ||
+                          (event.error && (
+                            event.error.includes("Authentication failed") ||
+                            event.error.includes("Invalid API key")
+                          ));
+
+        if (isAuthError) {
+          toast.error("Authentication Failed", {
+            description: "Your API key is invalid or expired. Please check Settings or run 'claude login' in terminal.",
+            duration: 10000,
+          });
+        } else {
+          toast.error("Agent encountered an error", {
+            description: event.error || "Check the logs for details",
+          });
+        }
       }
     });
 

apps/app/src/components/views/welcome-view.tsx

@@ -40,6 +40,8 @@ import {
   DropdownMenuTrigger,
 } from "@/components/ui/dropdown-menu";
 import { toast } from "sonner";
+import { WorkspacePickerModal } from "@/components/workspace-picker-modal";
+import { getHttpApiClient } from "@/lib/http-api-client";
 
 export function WelcomeView() {
   const { projects, addProject, setCurrentProject, setCurrentView } =
@@ -57,6 +59,7 @@ export function WelcomeView() {
     projectName: string;
     projectPath: string;
   } | null>(null);
+  const [showWorkspacePicker, setShowWorkspacePicker] = useState(false);
 
   /**
    * Kick off project analysis agent to analyze the codebase
@@ -172,17 +175,51 @@ export function WelcomeView() {
   );
 
   const handleOpenProject = useCallback(async () => {
-    const api = getElectronAPI();
-    const result = await api.openDirectory();
+    try {
+      // Check if workspace is configured
+      const httpClient = getHttpApiClient();
+      const configResult = await httpClient.workspace.getConfig();
 
-    if (!result.canceled && result.filePaths[0]) {
-      const path = result.filePaths[0];
-      // Extract folder name from path (works on both Windows and Mac/Linux)
-      const name = path.split(/[/\\]/).filter(Boolean).pop() || "Untitled Project";
-      await initializeAndOpenProject(path, name);
+      if (configResult.success && configResult.configured) {
+        // Show workspace picker modal
+        setShowWorkspacePicker(true);
+      } else {
+        // Fall back to current behavior (native dialog or manual input)
+        const api = getElectronAPI();
+        const result = await api.openDirectory();
+
+        if (!result.canceled && result.filePaths[0]) {
+          const path = result.filePaths[0];
+          // Extract folder name from path (works on both Windows and Mac/Linux)
+          const name = path.split(/[/\\]/).filter(Boolean).pop() || "Untitled Project";
+          await initializeAndOpenProject(path, name);
+        }
+      }
+    } catch (error) {
+      console.error("[Welcome] Failed to check workspace config:", error);
+      // Fall back to current behavior on error
+      const api = getElectronAPI();
+      const result = await api.openDirectory();
+
+      if (!result.canceled && result.filePaths[0]) {
+        const path = result.filePaths[0];
+        const name = path.split(/[/\\]/).filter(Boolean).pop() || "Untitled Project";
+        await initializeAndOpenProject(path, name);
+      }
     }
   }, [initializeAndOpenProject]);
 
+  /**
+   * Handle selecting a project from workspace picker
+   */
+  const handleWorkspaceSelect = useCallback(
+    async (path: string, name: string) => {
+      setShowWorkspacePicker(false);
+      await initializeAndOpenProject(path, name);
+    },
+    [initializeAndOpenProject]
+  );
+
   /**
    * Handle clicking on a recent project
    */
@@ -621,6 +658,13 @@ export function WelcomeView() {
         </DialogContent>
       </Dialog>
 
+      {/* Workspace Picker Modal */}
+      <WorkspacePickerModal
+        open={showWorkspacePicker}
+        onOpenChange={setShowWorkspacePicker}
+        onSelect={handleWorkspaceSelect}
+      />
+
       {/* Loading overlay when opening project */}
       {isOpening && (
         <div