hexclave
diff --git a/‎apps/backend/src/app/api/latest/internal/local-emulator/project/route.tsx‎
Lines changed: 102 additions & 8 deletions b/‎apps/backend/src/app/api/latest/internal/local-emulator/project/route.tsx‎
Lines changed: 102 additions & 8 deletions
diff --git a/‎apps/dashboard/src/app/(main)/(protected)/(outside-dashboard)/projects/page-client.tsx‎
Lines changed: 118 additions & 16 deletions b/‎apps/dashboard/src/app/(main)/(protected)/(outside-dashboard)/projects/page-client.tsx‎
Lines changed: 118 additions & 16 deletions
diff --git a/‎packages/stack-cli/package.json‎
Lines changed: 1 addition & 0 deletions b/‎packages/stack-cli/package.json‎
Lines changed: 1 addition & 0 deletions
@@ -4,10 +4,11 @@ import {
   LOCAL_EMULATOR_ADMIN_USER_ID,
   LOCAL_EMULATOR_ONLY_ENDPOINT_MESSAGE,
   LOCAL_EMULATOR_OWNER_TEAM_ID,
-  isLocalEmulatorOnboardingEnabledInConfig,
   isLocalEmulatorEnabled,
+  isLocalEmulatorOnboardingEnabledInConfig,
   readConfigFromFile,
   resolveEmulatorPath,
+  writeConfigToFile,
   writeShowOnboardingConfigToFile,
 } from "@/lib/local-emulator";
 import { DEFAULT_BRANCH_ID, getSoleTenancyFromProjectBranch } from "@/lib/tenancies";
@@ -18,6 +19,7 @@ import {
   projectOnboardingStatusSchema,
   projectOnboardingStatusValues,
   type ProjectOnboardingStatus,
+  yupArray,
   yupBoolean,
   yupNumber,
   yupObject,
@@ -37,6 +39,14 @@ function isProjectOnboardingStatus(value: string): value is ProjectOnboardingSta
   return projectOnboardingStatusValues.some((status) => status === value);
 }
 
+function deriveDisplayLabel(absoluteFilePath: string): string {
+  const base = path.basename(absoluteFilePath);
+  if (base.toLowerCase() === "stack.config.ts") {
+    return path.basename(path.dirname(absoluteFilePath)) || base;
+  }
+  return base;
+}
+
 async function assertLocalEmulatorOwnerTeamReadiness() {
   const internalTenancy = await getSoleTenancyFromProjectBranch("internal", DEFAULT_BRANCH_ID);
   const internalPrisma = await getPrismaClientForTenancy(internalTenancy);
@@ -90,7 +100,7 @@ async function getOrCreateLocalEmulatorProjectId(absoluteFilePath: string): Prom
     update: {},
     create: {
       id: projectId,
-      displayName: `Local Emulator: ${path.basename(absoluteFilePath) || "Project"}`,
+      displayName: `Local Emulator: ${deriveDisplayLabel(absoluteFilePath) || "Project"}`,
       description: `Local emulator project for ${absoluteFilePath}`,
       isProductionMode: false,
       ownerTeamId: LOCAL_EMULATOR_OWNER_TEAM_ID,
@@ -287,14 +297,30 @@ export const POST = createSmartRouteHandler({
     if (!isLocalEmulatorEnabled()) {
       throw new StatusError(StatusError.BadRequest, LOCAL_EMULATOR_ONLY_ENDPOINT_MESSAGE);
     }
-    if (!path.isAbsolute(req.body.absolute_file_path)) {
-      throw new StatusError(StatusError.BadRequest, "absolute_file_path must be an absolute path.");
+    if (!path.posix.isAbsolute(req.body.absolute_file_path)) {
+      const looksWindows = path.win32.isAbsolute(req.body.absolute_file_path);
+      throw new StatusError(
+        StatusError.BadRequest,
+        looksWindows
+          ? "absolute_file_path must be a POSIX absolute path. The local emulator runs in a Linux VM and does not accept Windows-style paths. Use the in-VM path or run the emulator from WSL."
+          : "absolute_file_path must be an absolute path.",
+      );
     }
 
-    const absoluteFilePath = path.resolve(req.body.absolute_file_path);
-    const resolvedFilePath = resolveEmulatorPath(absoluteFilePath);
+    const inputPath = path.resolve(req.body.absolute_file_path);
+    let inputStat;
+    try {
+      inputStat = await fs.stat(resolveEmulatorPath(inputPath));
+    } catch {
+      inputStat = undefined;
+    }
 
-    // Validate file exists before creating a project
+    const looksLikeConfigFile = /\.(ts|js|mjs)$/i.test(inputPath);
+    const absoluteFilePath = (inputStat?.isDirectory() || (!inputStat && !looksLikeConfigFile))
+      ? path.join(inputPath, "stack.config.ts")
+      : inputPath;
+
+    const resolvedFilePath = resolveEmulatorPath(absoluteFilePath);
     let fileExists: boolean;
     try {
       await fs.access(resolvedFilePath);
@@ -303,7 +329,7 @@ export const POST = createSmartRouteHandler({
       fileExists = false;
     }
     if (!fileExists) {
-      throw new StatusError(StatusError.BadRequest, `Config file not found: ${absoluteFilePath}`);
+      await writeConfigToFile(absoluteFilePath, {});
     }
 
     const fileContent = await fs.readFile(resolvedFilePath, "utf-8");
@@ -335,3 +361,71 @@ export const POST = createSmartRouteHandler({
     };
   },
 });
+
+type LocalEmulatorProjectListRow = {
+  projectId: string,
+  absoluteFilePath: string,
+  updatedAt: Date,
+};
+
+export const GET = createSmartRouteHandler({
+  metadata: {
+    hidden: true,
+    summary: "List recent local emulator projects",
+    description: "Returns previously opened local emulator project mappings, most-recent first.",
+    tags: ["Local Emulator"],
+  },
+  request: yupObject({
+    auth: yupObject({
+      type: clientOrHigherAuthTypeSchema.defined(),
+      project: yupObject({
+        id: yupString().oneOf(["internal"]).defined(),
+      }).defined(),
+    }).defined(),
+    method: yupString().oneOf(["GET"]).defined(),
+  }),
+  response: yupObject({
+    statusCode: yupNumber().oneOf([200]).defined(),
+    bodyType: yupString().oneOf(["json"]).defined(),
+    body: yupObject({
+      projects: yupArray(yupObject({
+        project_id: yupString().defined(),
+        absolute_file_path: yupString().defined(),
+        display_name: yupString().defined(),
+      }).defined()).defined(),
+    }).defined(),
+  }),
+  handler: async () => {
+    if (!isLocalEmulatorEnabled()) {
+      throw new StatusError(StatusError.BadRequest, LOCAL_EMULATOR_ONLY_ENDPOINT_MESSAGE);
+    }
+
+    const rows = await globalPrismaClient.$queryRaw<LocalEmulatorProjectListRow[]>(Prisma.sql`
+      SELECT "projectId", "absoluteFilePath", "updatedAt"
+      FROM "LocalEmulatorProject"
+      ORDER BY "updatedAt" DESC
+      LIMIT 20
+    `);
+
+    const projectIds = rows.map((r) => r.projectId);
+    const projects = projectIds.length > 0
+      ? await globalPrismaClient.project.findMany({
+        where: { id: { in: projectIds } },
+        select: { id: true, displayName: true },
+      })
+      : [];
+    const displayNameById = new Map(projects.map((p) => [p.id, p.displayName]));
+
+    return {
+      statusCode: 200 as const,
+      bodyType: "json" as const,
+      body: {
+        projects: rows.map((r) => ({
+          project_id: r.projectId,
+          absolute_file_path: r.absoluteFilePath,
+          display_name: displayNameById.get(r.projectId) ?? deriveDisplayLabel(r.absoluteFilePath),
+        })),
+      },
+    };
+  },
+});
@@ -66,6 +66,8 @@ export default function PageClient() {
   const [openConfigFileDialog, setOpenConfigFileDialog] = useState(false);
   const [absoluteConfigFilePath, setAbsoluteConfigFilePath] = useState("");
   const [openingConfigFile, setOpeningConfigFile] = useState(false);
+  const [recentConfigProjects, setRecentConfigProjects] = useState<Array<{ project_id: string, absolute_file_path: string, display_name: string }>>([]);
+  const [recentConfigProjectsError, setRecentConfigProjectsError] = useState(false);
   const [projectStatuses, setProjectStatuses] = useState<Map<string, ProjectOnboardingStatus>>(new Map());
   const [loadingProjectStatuses, setLoadingProjectStatuses] = useState(true);
   const [projectDau, setProjectDau] = useState<Map<string, { date: string, activity: number }[]>>(new Map());
@@ -157,17 +159,77 @@ export default function PageClient() {
     };
   }, [appInternals, rawProjects.length]);
 
+  useEffect(() => {
+    if (!openConfigFileDialog || !isLocalEmulator) return;
+    let cancelled = false;
+    setRecentConfigProjectsError(false);
+    runAsynchronously(async () => {
+      try {
+        const response = await appInternals.sendRequest("/internal/local-emulator/project", { method: "GET" }, "client");
+        if (!response.ok) {
+          if (!cancelled) {
+            setRecentConfigProjects([]);
+            setRecentConfigProjectsError(true);
+          }
+          return;
+        }
+        const body = await response.json() as { projects?: unknown };
+        if (cancelled) return;
+        if (!Array.isArray(body.projects)) {
+          throw new Error("Invalid recent-projects payload");
+        }
+        const parsed = body.projects.map((p: unknown): { project_id: string, absolute_file_path: string, display_name: string } => {
+          if (
+            !p || typeof p !== "object"
+            || typeof (p as Record<string, unknown>).project_id !== "string"
+            || typeof (p as Record<string, unknown>).absolute_file_path !== "string"
+            || typeof (p as Record<string, unknown>).display_name !== "string"
+          ) {
+            throw new Error("Invalid recent-projects payload");
+          }
+          const r = p as Record<string, string>;
+          return { project_id: r.project_id, absolute_file_path: r.absolute_file_path, display_name: r.display_name };
+        });
+        setRecentConfigProjects(parsed);
+      } catch {
+        if (!cancelled) {
+          setRecentConfigProjects([]);
+          setRecentConfigProjectsError(true);
+        }
+      }
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [openConfigFileDialog, isLocalEmulator, appInternals]);
+
+  const pathCopyTip = useMemo(() => {
+    const p = typeof navigator !== "undefined" ? navigator.platform : "";
+    if (/Mac|iPhone|iPad|iPod/i.test(p)) {
+      return "Tip: in Finder, right-click the file → hold ⌥ Option → Copy as Pathname, then paste here.";
+    }
+    if (/Win/i.test(p)) {
+      return "Note: the emulator runs in a Linux VM and needs a POSIX path. From WSL, run `wslpath -a stack.config.ts` (or `realpath stack.config.ts`) and paste that here.";
+    }
+    return "Tip: from your project folder, run `realpath stack.config.ts` in a terminal.";
+  }, []);
+
   const handleOpenConfigFile = async () => {
     const trimmedPath = absoluteConfigFilePath.trim();
     if (trimmedPath.length === 0) {
-      throw new Error("Please enter an absolute config file path.");
+      toast({ description: "Please enter a path to your project or stack.config.ts.", variant: "destructive" });
+      return;
     }
 
-    const hasUnixAbsolutePath = trimmedPath.startsWith("/");
-    const hasWindowsAbsolutePath = /^[a-zA-Z]:[\\/]/.test(trimmedPath);
-    const hasWindowsUncPath = trimmedPath.startsWith("\\\\");
-    if (!hasUnixAbsolutePath && !hasWindowsAbsolutePath && !hasWindowsUncPath) {
-      throw new Error("Config file path must be absolute.");
+    if (!trimmedPath.startsWith("/")) {
+      const looksWindows = /^[a-zA-Z]:[\\/]/.test(trimmedPath) || trimmedPath.startsWith("\\\\");
+      toast({
+        description: looksWindows
+          ? "The local emulator runs in a Linux VM and only accepts POSIX paths (e.g. /Users/you/project). Windows paths aren't supported — use WSL or the in-VM path."
+          : "The path must be absolute (e.g. /Users/you/project or /Users/you/project/stack.config.ts).",
+        variant: "destructive",
+      });
+      return;
     }
 
     setOpeningConfigFile(true);
@@ -188,19 +250,20 @@ export default function PageClient() {
       const responseBody = await response.json();
 
       if (!response.ok) {
+        let message = "Couldn't open that path. Make sure it points to your project folder or a valid stack.config.ts.";
         if (typeof responseBody === "string" && responseBody.length > 0) {
-          throw new Error(responseBody);
-        }
-        if (
+          message = responseBody;
+        } else if (
           responseBody != null &&
           typeof responseBody === "object" &&
           "error" in responseBody &&
           typeof responseBody.error === "string" &&
           responseBody.error.length > 0
         ) {
-          throw new Error(responseBody.error);
+          message = responseBody.error;
         }
-        throw new Error("Failed to open config file project in local emulator.");
+        toast({ description: message, variant: "destructive" });
+        return;
       }
 
       if (
@@ -209,7 +272,8 @@ export default function PageClient() {
         !("project_id" in responseBody) ||
         typeof responseBody.project_id !== "string"
       ) {
-        throw new Error("Local emulator endpoint returned an invalid response.");
+        toast({ description: "Local emulator endpoint returned an invalid response.", variant: "destructive" });
+        return;
       }
       const onboardingStatus = "onboarding_status" in responseBody
         ? responseBody.onboarding_status
@@ -232,6 +296,11 @@ export default function PageClient() {
         router.push(`/new-project?project_id=${encodeURIComponent(responseBody.project_id)}`);
       }
       await wait(2000);
+    } catch (e) {
+      toast({
+        description: e instanceof Error ? e.message : "Something went wrong opening that project.",
+        variant: "destructive",
+      });
     } finally {
       setOpeningConfigFile(false);
     }
@@ -302,7 +371,7 @@ export default function PageClient() {
               router.push("/new-project");
               return await wait(2000);
             }}
-          >{isLocalEmulator ? "Open config file" : "Create Project"}
+          >{isLocalEmulator ? "Open a project" : "Create Project"}
           </Button>
         </div>
       </div>
@@ -318,24 +387,57 @@ export default function PageClient() {
       >
         <DialogContent className="sm:max-w-[520px]">
           <DialogHeader>
-            <DialogTitle>Open config file</DialogTitle>
+            <DialogTitle>Open your Stack Auth project</DialogTitle>
           </DialogHeader>
           <div className="space-y-3">
             <Typography variant="secondary">
-              Enter the absolute path to your local Stack config file. The local emulator will create or reuse the mapped project and open it in the dashboard.
+              Point the local dashboard at the <code>stack.config.ts</code> in your project. If you just ran <code>stack init</code>, it was created at the root of that project.
+            </Typography>
+            <Typography variant="secondary" className="text-xs">
+              Don&apos;t have one yet? Paste your project folder path instead and we&apos;ll create <code>stack.config.ts</code> for you.
             </Typography>
+            {recentConfigProjects.length > 0 && (
+              <div className="space-y-1">
+                <Typography variant="secondary" className="text-xs uppercase tracking-wide">Recent</Typography>
+                <div className="max-h-40 overflow-y-auto rounded-md border">
+                  {recentConfigProjects.map((p) => (
+                    <button
+                      key={p.project_id}
+                      type="button"
+                      className="block w-full truncate px-3 py-2 text-left text-sm hover:bg-muted"
+                      onClick={() => setAbsoluteConfigFilePath(p.absolute_file_path)}
+                      title={p.absolute_file_path}
+                    >
+                      {p.absolute_file_path}
+                    </button>
+                  ))}
+                </div>
+              </div>
+            )}
+            {recentConfigProjectsError && recentConfigProjects.length === 0 && (
+              <Typography variant="secondary" className="text-xs text-destructive">
+                Couldn&apos;t load recent projects. Paste a path below to continue.
+              </Typography>
+            )}
             <Input
               autoFocus
               placeholder="/Users/you/project/stack.config.ts"
               value={absoluteConfigFilePath}
               onChange={(event) => setAbsoluteConfigFilePath(event.target.value)}
             />
+            <Typography variant="secondary" className="text-xs">
+              {pathCopyTip}
+            </Typography>
           </div>
           <DialogFooter className="pt-2">
             <Button variant="outline" onClick={() => setOpenConfigFileDialog(false)} disabled={openingConfigFile}>
               Cancel
             </Button>
-            <Button onClick={handleOpenConfigFile} loading={openingConfigFile}>
+            <Button
+              onClick={handleOpenConfigFile}
+              loading={openingConfigFile}
+              disabled={absoluteConfigFilePath.trim().length === 0}
+            >
               Open project
             </Button>
           </DialogFooter>
 
@@ -29,6 +29,7 @@
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.2.73",
     "@inquirer/prompts": "^7.0.0",
+    "@sentry/node": "^10.42.0",
     "@stackframe/js": "workspace:*",
     "@stackframe/stack-shared": "workspace:*",
     "commander": "^13.1.0",