Add recent folders feature with localStorage persistence

- Create FolderSelectionView component showing recent folders and browse option
- Store up to 10 recent folders in localStorage with timestamps
- Show folder selection view on app start when no instances exist
- Display folder selection modal when creating new instance from existing instance
- Add keyboard navigation (arrows, page up/down, home/end, enter, delete)
- Add ability to remove folders from recent list
- Track folder access time and display relative timestamps
- Close modal with Escape key or close button
- Update preferences store with recent folders management

src/App.tsx

@@ -1,7 +1,7 @@
 import { Component, onMount, onCleanup, Show, createMemo, createEffect, createSignal } from "solid-js"
 import type { Session } from "./types/session"
 import type { Attachment } from "./types/attachment"
-import EmptyState from "./components/empty-state"
+import FolderSelectionView from "./components/folder-selection-view"
 import InstanceWelcomeView from "./components/instance-welcome-view"
 import CommandPalette from "./components/command-palette"
 import InstanceTabs from "./components/instance-tabs"
@@ -12,8 +12,15 @@ import LogsView from "./components/logs-view"
 import { initMarkdown } from "./lib/markdown"
 import { createCommandRegistry } from "./lib/commands"
 import type { Command } from "./lib/commands"
-import { hasInstances, isSelectingFolder, setIsSelectingFolder, setHasInstances } from "./stores/ui"
-import { toggleShowThinkingBlocks, preferences } from "./stores/preferences"
+import {
+  hasInstances,
+  isSelectingFolder,
+  setIsSelectingFolder,
+  setHasInstances,
+  showFolderSelection,
+  setShowFolderSelection,
+} from "./stores/ui"
+import { toggleShowThinkingBlocks, preferences, addRecentFolder } from "./stores/preferences"
 import {
   createInstance,
   instances,
@@ -176,16 +183,22 @@ const App: Component = () => {
     return activeSessionId().get(instance.id) || null
   })
 
-  async function handleSelectFolder() {
+  async function handleSelectFolder(folderPath?: string) {
     setIsSelectingFolder(true)
     try {
-      const folder = await window.electronAPI.selectFolder()
+      let folder: string | null | undefined = folderPath
+
       if (!folder) {
-        return
+        folder = await window.electronAPI.selectFolder()
+        if (!folder) {
+          return
+        }
       }
 
+      addRecentFolder(folder)
       const instanceId = await createInstance(folder)
       setHasInstances(true)
+      setShowFolderSelection(false)
 
       console.log("Created instance:", instanceId, "Port:", instances().get(instanceId)?.port)
     } catch (error) {
@@ -195,6 +208,14 @@ const App: Component = () => {
     }
   }
 
+  function handleNewInstanceRequest() {
+    if (hasInstances()) {
+      setShowFolderSelection(true)
+    } else {
+      handleSelectFolder()
+    }
+  }
+
   async function handleCloseInstance(instanceId: string) {
     if (confirm("Stop OpenCode instance? This will stop the server.")) {
       await stopInstance(instanceId)
@@ -234,7 +255,7 @@ const App: Component = () => {
       category: "Instance",
       keywords: ["folder", "project", "workspace"],
       shortcut: { key: "N", meta: true },
-      action: handleSelectFolder,
+      action: handleNewInstanceRequest,
     })
 
     commandRegistry.register({
@@ -620,7 +641,7 @@ const App: Component = () => {
     setupCommands()
 
     setupTabKeyboardShortcuts(
-      handleSelectFolder,
+      handleNewInstanceRequest,
       handleCloseInstance,
       handleNewSession,
       handleCloseSession,
@@ -676,6 +697,8 @@ const App: Component = () => {
     )
     registerEscapeShortcut(
       () => {
+        if (showFolderSelection()) return true
+
         const instance = activeInstance()
         if (!instance) return false
 
@@ -697,6 +720,11 @@ const App: Component = () => {
         )
       },
       async () => {
+        if (showFolderSelection()) {
+          setShowFolderSelection(false)
+          return
+        }
+
         const instance = activeInstance()
         const sessionId = activeSessionIdForInstance()
         if (!instance || !sessionId || sessionId === "logs") return
@@ -740,7 +768,7 @@ const App: Component = () => {
     })
 
     window.electronAPI.onNewInstance(() => {
-      handleSelectFolder()
+      handleNewInstanceRequest()
     })
 
     window.electronAPI.onInstanceStarted(({ id, port, pid, binaryPath }) => {
@@ -774,7 +802,7 @@ const App: Component = () => {
               activeInstanceId={activeInstanceId()}
               onSelect={setActiveInstanceId}
               onClose={handleCloseInstance}
-              onNew={handleSelectFolder}
+              onNew={handleNewInstanceRequest}
             />
 
             <Show when={activeInstance()}>
@@ -825,7 +853,7 @@ const App: Component = () => {
           </>
         }
       >
-        <EmptyState onSelectFolder={handleSelectFolder} isLoading={isSelectingFolder()} />
+        <FolderSelectionView onSelectFolder={handleSelectFolder} isLoading={isSelectingFolder()} />
       </Show>
 
       <CommandPalette
@@ -834,6 +862,28 @@ const App: Component = () => {
         commands={commandRegistry.getAll()}
         onExecute={handleExecuteCommand}
       />
+
+      <Show when={showFolderSelection()}>
+        <div class="fixed inset-0 bg-black/50 z-50 flex items-center justify-center">
+          <div class="w-full h-full relative">
+            <button
+              onClick={() => setShowFolderSelection(false)}
+              class="absolute top-4 right-4 z-10 p-2 bg-white dark:bg-gray-800 rounded-lg shadow-lg hover:bg-gray-100 dark:hover:bg-gray-700 transition-colors"
+              title="Close (Esc)"
+            >
+              <svg
+                class="w-5 h-5 text-gray-600 dark:text-gray-300"
+                fill="none"
+                stroke="currentColor"
+                viewBox="0 0 24 24"
+              >
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12" />
+              </svg>
+            </button>
+            <FolderSelectionView onSelectFolder={handleSelectFolder} isLoading={isSelectingFolder()} />
+          </div>
+        </div>
+      </Show>
     </div>
   )
 }

src/components/folder-selection-view.tsx

@@ -0,0 +1,286 @@
+import { Component, createSignal, Show, For, onMount, onCleanup } from "solid-js"
+import { Folder, Clock, Trash2, FolderPlus } from "lucide-solid"
+import { recentFolders, removeRecentFolder } from "../stores/preferences"
+
+interface FolderSelectionViewProps {
+  onSelectFolder: (folder?: string) => void
+  isLoading?: boolean
+}
+
+const FolderSelectionView: Component<FolderSelectionViewProps> = (props) => {
+  const [selectedIndex, setSelectedIndex] = createSignal(0)
+  const [focusMode, setFocusMode] = createSignal<"recent" | "new" | null>("recent")
+
+  const folders = () => recentFolders()
+
+  function scrollToIndex(index: number) {
+    const element = document.querySelector(`[data-folder-index="${index}"]`)
+    if (element) {
+      element.scrollIntoView({ block: "nearest", behavior: "auto" })
+    }
+  }
+
+  function handleKeyDown(e: KeyboardEvent) {
+    const folderList = folders()
+
+    if (e.key === "Enter" && (e.metaKey || e.ctrlKey)) {
+      e.preventDefault()
+      handleBrowse()
+      return
+    }
+
+    if (folderList.length === 0) return
+
+    if (e.key === "ArrowDown") {
+      e.preventDefault()
+      const newIndex = Math.min(selectedIndex() + 1, folderList.length - 1)
+      setSelectedIndex(newIndex)
+      setFocusMode("recent")
+      scrollToIndex(newIndex)
+    } else if (e.key === "ArrowUp") {
+      e.preventDefault()
+      const newIndex = Math.max(selectedIndex() - 1, 0)
+      setSelectedIndex(newIndex)
+      setFocusMode("recent")
+      scrollToIndex(newIndex)
+    } else if (e.key === "PageDown") {
+      e.preventDefault()
+      const pageSize = 5
+      const newIndex = Math.min(selectedIndex() + pageSize, folderList.length - 1)
+      setSelectedIndex(newIndex)
+      setFocusMode("recent")
+      scrollToIndex(newIndex)
+    } else if (e.key === "PageUp") {
+      e.preventDefault()
+      const pageSize = 5
+      const newIndex = Math.max(selectedIndex() - pageSize, 0)
+      setSelectedIndex(newIndex)
+      setFocusMode("recent")
+      scrollToIndex(newIndex)
+    } else if (e.key === "Home") {
+      e.preventDefault()
+      setSelectedIndex(0)
+      setFocusMode("recent")
+      scrollToIndex(0)
+    } else if (e.key === "End") {
+      e.preventDefault()
+      const newIndex = folderList.length - 1
+      setSelectedIndex(newIndex)
+      setFocusMode("recent")
+      scrollToIndex(newIndex)
+    } else if (e.key === "Enter") {
+      e.preventDefault()
+      handleEnterKey()
+    } else if (e.key === "Backspace" || e.key === "Delete") {
+      e.preventDefault()
+      if (folderList.length > 0 && focusMode() === "recent") {
+        const folder = folderList[selectedIndex()]
+        if (folder) {
+          handleRemove(folder.path)
+        }
+      }
+    }
+  }
+
+  function handleEnterKey() {
+    const folderList = folders()
+    const index = selectedIndex()
+
+    if (index < folderList.length) {
+      props.onSelectFolder(folderList[index].path)
+    }
+  }
+
+  onMount(() => {
+    window.addEventListener("keydown", handleKeyDown)
+    onCleanup(() => {
+      window.removeEventListener("keydown", handleKeyDown)
+    })
+  })
+
+  function formatRelativeTime(timestamp: number): string {
+    const seconds = Math.floor((Date.now() - timestamp) / 1000)
+    const minutes = Math.floor(seconds / 60)
+    const hours = Math.floor(minutes / 60)
+    const days = Math.floor(hours / 24)
+
+    if (days > 0) return `${days}d ago`
+    if (hours > 0) return `${hours}h ago`
+    if (minutes > 0) return `${minutes}m ago`
+    return "just now"
+  }
+
+  function handleFolderSelect(path: string) {
+    props.onSelectFolder(path)
+  }
+
+  function handleBrowse() {
+    props.onSelectFolder()
+  }
+
+  function handleRemove(path: string, e?: Event) {
+    e?.stopPropagation()
+    removeRecentFolder(path)
+
+    const folderList = folders()
+    if (selectedIndex() >= folderList.length && folderList.length > 0) {
+      setSelectedIndex(folderList.length - 1)
+    }
+  }
+
+  function getDisplayPath(path: string): string {
+    if (path.startsWith("/Users/")) {
+      return path.replace(/^\/Users\/[^/]+/, "~")
+    }
+    return path
+  }
+
+  return (
+    <div class="flex h-full w-full items-center justify-center bg-gray-50 dark:bg-gray-900">
+      <div class="w-full max-w-3xl px-8 py-12">
+        <div class="mb-8 text-center">
+          <div class="mb-4 flex justify-center">
+            <Folder class="h-16 w-16 text-gray-400 dark:text-gray-600" />
+          </div>
+          <h1 class="mb-2 text-2xl font-semibold text-gray-900 dark:text-gray-100">Welcome to OpenCode</h1>
+          <p class="text-base text-gray-600 dark:text-gray-400">Select a folder to start coding with AI</p>
+        </div>
+
+        <div class="space-y-4">
+          <Show
+            when={folders().length > 0}
+            fallback={
+              <div class="bg-white dark:bg-gray-800 rounded-lg shadow-sm border border-gray-200 dark:border-gray-700 p-6 text-center">
+                <div class="text-gray-400 dark:text-gray-600 mb-2">
+                  <Clock class="w-12 h-12 mx-auto" />
+                </div>
+                <p class="text-gray-600 dark:text-gray-400 font-medium text-sm mb-1">No Recent Folders</p>
+                <p class="text-xs text-gray-500 dark:text-gray-500">Browse for a folder to get started</p>
+              </div>
+            }
+          >
+            <div class="bg-white dark:bg-gray-800 rounded-lg shadow-sm border border-gray-200 dark:border-gray-700 overflow-hidden">
+              <div class="px-4 py-3 border-b border-gray-200 dark:border-gray-700 bg-gray-50 dark:bg-gray-900">
+                <h2 class="text-base font-semibold text-gray-900 dark:text-gray-100">Recent Folders</h2>
+                <p class="text-xs text-gray-500 dark:text-gray-400 mt-0.5">
+                  {folders().length} {folders().length === 1 ? "folder" : "folders"} available
+                </p>
+              </div>
+              <div class="max-h-[400px] overflow-y-auto">
+                <For each={folders()}>
+                  {(folder, index) => (
+                    <div
+                      data-folder-index={index()}
+                      class="group relative border-b border-gray-100 dark:border-gray-700 last:border-b-0"
+                    >
+                      <button
+                        class="w-full text-left px-4 py-3 hover:bg-blue-50 dark:hover:bg-blue-900/20 transition-all focus:outline-none flex items-center justify-between gap-3"
+                        classList={{
+                          "bg-blue-100 dark:bg-blue-900/30 ring-2 ring-blue-500 ring-inset":
+                            focusMode() === "recent" && selectedIndex() === index(),
+                        }}
+                        onClick={() => handleFolderSelect(folder.path)}
+                        onMouseEnter={() => {
+                          setFocusMode("recent")
+                          setSelectedIndex(index())
+                        }}
+                      >
+                        <div class="flex-1 min-w-0">
+                          <div class="flex items-center gap-2 mb-1">
+                            <Folder class="w-4 h-4 text-gray-400 dark:text-gray-500 flex-shrink-0" />
+                            <span class="text-sm font-medium text-gray-900 dark:text-gray-100 truncate">
+                              {folder.path.split("/").pop()}
+                            </span>
+                          </div>
+                          <div class="text-xs text-gray-500 dark:text-gray-400 font-mono truncate pl-6">
+                            {getDisplayPath(folder.path)}
+                          </div>
+                          <div class="text-xs text-gray-400 dark:text-gray-500 mt-1 pl-6">
+                            {formatRelativeTime(folder.lastAccessed)}
+                          </div>
+                        </div>
+                        <div class="flex items-center gap-2 flex-shrink-0">
+                          <Show when={focusMode() === "recent" && selectedIndex() === index()}>
+                            <kbd class="px-1.5 py-0.5 text-xs font-semibold text-gray-700 dark:text-gray-300 bg-white dark:bg-gray-700 border border-gray-300 dark:border-gray-600 rounded">
+                              ↵
+                            </kbd>
+                          </Show>
+                          <button
+                            onClick={(e) => handleRemove(folder.path, e)}
+                            class="opacity-0 group-hover:opacity-100 p-1.5 hover:bg-red-100 dark:hover:bg-red-900/30 rounded transition-all"
+                            title="Remove from recent"
+                          >
+                            <Trash2 class="w-3.5 h-3.5 text-gray-400 dark:text-gray-500 hover:text-red-600 dark:hover:text-red-400" />
+                          </button>
+                        </div>
+                      </button>
+                    </div>
+                  )}
+                </For>
+              </div>
+            </div>
+          </Show>
+
+          <div class="bg-white dark:bg-gray-800 rounded-lg shadow-sm border border-gray-200 dark:border-gray-700 overflow-hidden">
+            <div class="px-4 py-3 border-b border-gray-200 dark:border-gray-700 bg-gray-50 dark:bg-gray-900">
+              <h2 class="text-base font-semibold text-gray-900 dark:text-gray-100">Browse for Folder</h2>
+              <p class="text-xs text-gray-500 dark:text-gray-400 mt-0.5">Select any folder on your computer</p>
+            </div>
+            <div class="p-4">
+              <button
+                onClick={handleBrowse}
+                disabled={props.isLoading}
+                class="w-full px-4 py-2.5 bg-blue-600 text-white rounded-lg hover:bg-blue-700 disabled:bg-gray-300 dark:disabled:bg-gray-600 disabled:cursor-not-allowed transition-all font-medium flex items-center justify-between text-sm"
+                onMouseEnter={() => setFocusMode("new")}
+              >
+                <div class="flex items-center gap-2 flex-1 justify-center">
+                  <FolderPlus class="w-4 h-4" />
+                  <span>{props.isLoading ? "Opening..." : "Browse Folders"}</span>
+                </div>
+                <kbd class="px-1.5 py-0.5 text-xs font-semibold bg-blue-700 border border-blue-500 rounded">
+                  Cmd+Enter
+                </kbd>
+              </button>
+            </div>
+          </div>
+        </div>
+
+        <div class="mt-6 px-4 py-3 bg-white dark:bg-gray-800 border border-gray-200 dark:border-gray-700 rounded-lg">
+          <div class="flex items-center justify-center flex-wrap gap-3 text-xs text-gray-500 dark:text-gray-400">
+            <Show when={folders().length > 0}>
+              <div class="flex items-center gap-1.5">
+                <kbd class="px-1.5 py-0.5 bg-gray-100 dark:bg-gray-700 border border-gray-300 dark:border-gray-600 rounded font-mono">
+                  ↑
+                </kbd>
+                <kbd class="px-1.5 py-0.5 bg-gray-100 dark:bg-gray-700 border border-gray-300 dark:border-gray-600 rounded font-mono">
+                  ↓
+                </kbd>
+                <span>Navigate</span>
+              </div>
+              <div class="flex items-center gap-1.5">
+                <kbd class="px-1.5 py-0.5 bg-gray-100 dark:bg-gray-700 border border-gray-300 dark:border-gray-600 rounded font-mono">
+                  Enter
+                </kbd>
+                <span>Select</span>
+              </div>
+              <div class="flex items-center gap-1.5">
+                <kbd class="px-1.5 py-0.5 bg-gray-100 dark:bg-gray-700 border border-gray-300 dark:border-gray-600 rounded font-mono">
+                  Del
+                </kbd>
+                <span>Remove</span>
+              </div>
+            </Show>
+            <div class="flex items-center gap-1.5">
+              <kbd class="px-1.5 py-0.5 bg-gray-100 dark:bg-gray-700 border border-gray-300 dark:border-gray-600 rounded">
+                Cmd+Enter
+              </kbd>
+              <span>Browse</span>
+            </div>
+          </div>
+        </div>
+      </div>
+    </div>
+  )
+}
+
+export default FolderSelectionView

src/stores/preferences.ts

@@ -1,11 +1,18 @@
 import { createSignal } from "solid-js"
 
 const STORAGE_KEY = "opencode-preferences"
+const RECENT_FOLDERS_KEY = "opencode-recent-folders"
+const MAX_RECENT_FOLDERS = 10
 
 interface Preferences {
   showThinkingBlocks: boolean
 }
 
+interface RecentFolder {
+  path: string
+  lastAccessed: number
+}
+
 const defaultPreferences: Preferences = {
   showThinkingBlocks: false,
 }
@@ -30,7 +37,28 @@ function savePreferences(prefs: Preferences): void {
   }
 }
 
+function loadRecentFolders(): RecentFolder[] {
+  try {
+    const stored = localStorage.getItem(RECENT_FOLDERS_KEY)
+    if (stored) {
+      return JSON.parse(stored)
+    }
+  } catch (error) {
+    console.error("Failed to load recent folders:", error)
+  }
+  return []
+}
+
+function saveRecentFolders(folders: RecentFolder[]): void {
+  try {
+    localStorage.setItem(RECENT_FOLDERS_KEY, JSON.stringify(folders))
+  } catch (error) {
+    console.error("Failed to save recent folders:", error)
+  }
+}
+
 const [preferences, setPreferences] = createSignal<Preferences>(loadPreferences())
+const [recentFolders, setRecentFolders] = createSignal<RecentFolder[]>(loadRecentFolders())
 
 function updatePreferences(updates: Partial<Preferences>): void {
   const updated = { ...preferences(), ...updates }
@@ -42,4 +70,19 @@ function toggleShowThinkingBlocks(): void {
   updatePreferences({ showThinkingBlocks: !preferences().showThinkingBlocks })
 }
 
-export { preferences, updatePreferences, toggleShowThinkingBlocks }
+function addRecentFolder(path: string): void {
+  const folders = recentFolders().filter((f) => f.path !== path)
+  folders.unshift({ path, lastAccessed: Date.now() })
+
+  const trimmed = folders.slice(0, MAX_RECENT_FOLDERS)
+  setRecentFolders(trimmed)
+  saveRecentFolders(trimmed)
+}
+
+function removeRecentFolder(path: string): void {
+  const folders = recentFolders().filter((f) => f.path !== path)
+  setRecentFolders(folders)
+  saveRecentFolders(folders)
+}
+
+export { preferences, updatePreferences, toggleShowThinkingBlocks, recentFolders, addRecentFolder, removeRecentFolder }

src/stores/ui.ts

@@ -3,6 +3,7 @@ import { createSignal } from "solid-js"
 const [hasInstances, setHasInstances] = createSignal(false)
 const [selectedFolder, setSelectedFolder] = createSignal<string | null>(null)
 const [isSelectingFolder, setIsSelectingFolder] = createSignal(false)
+const [showFolderSelection, setShowFolderSelection] = createSignal(false)
 
 const [instanceTabOrder, setInstanceTabOrder] = createSignal<string[]>([])
 const [sessionTabOrder, setSessionTabOrder] = createSignal<Map<string, string[]>>(new Map())
@@ -26,6 +27,8 @@ export {
   setSelectedFolder,
   isSelectingFolder,
   setIsSelectingFolder,
+  showFolderSelection,
+  setShowFolderSelection,
   instanceTabOrder,
   setInstanceTabOrder,
   sessionTabOrder,