feat(setup): implement setup wizard for CLI tools configuration

- Added a new SetupView component to guide users through the installation and authentication of Claude and Codex CLIs.
- Integrated IPC handlers for checking CLI status, installing, and authenticating both CLIs.
- Enhanced the app store to manage setup state, including first run detection and progress tracking.
- Updated the main application view to redirect to the setup wizard on first run.
- Improved user experience by providing clear instructions and feedback during the setup process.

These changes streamline the initial configuration of CLI tools, ensuring users can easily set up their development environment.

app/src/store/app-store.ts

@@ -4,6 +4,7 @@ import type { Project, TrashedProject } from "@/lib/electron";
 
 export type ViewMode =
   | "welcome"
+  | "setup"
   | "spec"
   | "board"
   | "agent"

app/src/store/setup-store.ts

@@ -0,0 +1,182 @@
+import { create } from "zustand";
+import { persist } from "zustand/middleware";
+
+// CLI Installation Status
+export interface CliStatus {
+  installed: boolean;
+  path: string | null;
+  version: string | null;
+  method: string;
+  error?: string;
+}
+
+// Claude Auth Status
+export interface ClaudeAuthStatus {
+  authenticated: boolean;
+  method: "oauth" | "api_key" | "none";
+  hasCredentialsFile: boolean;
+  oauthTokenValid?: boolean;
+  apiKeyValid?: boolean;
+  error?: string;
+}
+
+// Codex Auth Status
+export interface CodexAuthStatus {
+  authenticated: boolean;
+  method: "api_key" | "env" | "none";
+  apiKeyValid?: boolean;
+  mcpConfigured?: boolean;
+  error?: string;
+}
+
+// Installation Progress
+export interface InstallProgress {
+  isInstalling: boolean;
+  currentStep: string;
+  progress: number; // 0-100
+  output: string[];
+  error?: string;
+}
+
+export type SetupStep =
+  | "welcome"
+  | "claude_detect"
+  | "claude_auth"
+  | "codex_detect"
+  | "codex_auth"
+  | "complete";
+
+export interface SetupState {
+  // Setup wizard state
+  isFirstRun: boolean;
+  setupComplete: boolean;
+  currentStep: SetupStep;
+
+  // Claude CLI state
+  claudeCliStatus: CliStatus | null;
+  claudeAuthStatus: ClaudeAuthStatus | null;
+  claudeInstallProgress: InstallProgress;
+
+  // Codex CLI state
+  codexCliStatus: CliStatus | null;
+  codexAuthStatus: CodexAuthStatus | null;
+  codexInstallProgress: InstallProgress;
+
+  // Setup preferences
+  skipClaudeSetup: boolean;
+  skipCodexSetup: boolean;
+}
+
+export interface SetupActions {
+  // Setup flow
+  setCurrentStep: (step: SetupStep) => void;
+  completeSetup: () => void;
+  resetSetup: () => void;
+  setIsFirstRun: (isFirstRun: boolean) => void;
+
+  // Claude CLI
+  setClaudeCliStatus: (status: CliStatus | null) => void;
+  setClaudeAuthStatus: (status: ClaudeAuthStatus | null) => void;
+  setClaudeInstallProgress: (progress: Partial<InstallProgress>) => void;
+  resetClaudeInstallProgress: () => void;
+
+  // Codex CLI
+  setCodexCliStatus: (status: CliStatus | null) => void;
+  setCodexAuthStatus: (status: CodexAuthStatus | null) => void;
+  setCodexInstallProgress: (progress: Partial<InstallProgress>) => void;
+  resetCodexInstallProgress: () => void;
+
+  // Preferences
+  setSkipClaudeSetup: (skip: boolean) => void;
+  setSkipCodexSetup: (skip: boolean) => void;
+}
+
+const initialInstallProgress: InstallProgress = {
+  isInstalling: false,
+  currentStep: "",
+  progress: 0,
+  output: [],
+};
+
+const initialState: SetupState = {
+  isFirstRun: true,
+  setupComplete: false,
+  currentStep: "welcome",
+
+  claudeCliStatus: null,
+  claudeAuthStatus: null,
+  claudeInstallProgress: { ...initialInstallProgress },
+
+  codexCliStatus: null,
+  codexAuthStatus: null,
+  codexInstallProgress: { ...initialInstallProgress },
+
+  skipClaudeSetup: false,
+  skipCodexSetup: false,
+};
+
+export const useSetupStore = create<SetupState & SetupActions>()(
+  persist(
+    (set, get) => ({
+      ...initialState,
+
+      // Setup flow
+      setCurrentStep: (step) => set({ currentStep: step }),
+
+      completeSetup: () => set({ setupComplete: true, currentStep: "complete" }),
+
+      resetSetup: () => set({
+        ...initialState,
+        isFirstRun: false, // Don't reset first run flag
+      }),
+
+      setIsFirstRun: (isFirstRun) => set({ isFirstRun }),
+
+      // Claude CLI
+      setClaudeCliStatus: (status) => set({ claudeCliStatus: status }),
+
+      setClaudeAuthStatus: (status) => set({ claudeAuthStatus: status }),
+
+      setClaudeInstallProgress: (progress) => set({
+        claudeInstallProgress: {
+          ...get().claudeInstallProgress,
+          ...progress,
+        },
+      }),
+
+      resetClaudeInstallProgress: () => set({
+        claudeInstallProgress: { ...initialInstallProgress },
+      }),
+
+      // Codex CLI
+      setCodexCliStatus: (status) => set({ codexCliStatus: status }),
+
+      setCodexAuthStatus: (status) => set({ codexAuthStatus: status }),
+
+      setCodexInstallProgress: (progress) => set({
+        codexInstallProgress: {
+          ...get().codexInstallProgress,
+          ...progress,
+        },
+      }),
+
+      resetCodexInstallProgress: () => set({
+        codexInstallProgress: { ...initialInstallProgress },
+      }),
+
+      // Preferences
+      setSkipClaudeSetup: (skip) => set({ skipClaudeSetup: skip }),
+
+      setSkipCodexSetup: (skip) => set({ skipCodexSetup: skip }),
+    }),
+    {
+      name: "automaker-setup",
+      partialize: (state) => ({
+        isFirstRun: state.isFirstRun,
+        setupComplete: state.setupComplete,
+        skipClaudeSetup: state.skipClaudeSetup,
+        skipCodexSetup: state.skipCodexSetup,
+      }),
+    }
+  )
+);