conductor-oss 0.2.15 → 0.2.16

package/web/.next/standalone/packages/web/src/app/page.tsx

@@ -0,0 +1,4559 @@
+"use client";
+
+import dynamic from "next/dynamic";
+import { type FormEvent, memo, useCallback, useEffect, useMemo, useState } from "react";
+import * as DropdownMenu from "@radix-ui/react-dropdown-menu";
+import {
+  getAgentModelCatalog,
+  resolveAgentModelAccess,
+  supportsAgentModelSelection,
+  type AgentModelOption,
+  type AgentReasoningOption,
+  type DashboardRole,
+  type ModelAccessPreferences,
+  type TrustedHeaderAccessProvider,
+} from "@conductor-oss/core/types";
+import type { IconType } from "react-icons";
+import { SiNotion, SiObsidian } from "react-icons/si";
+import { VscVscode } from "react-icons/vsc";
+import {
+  Bot,
+  BookText,
+  Building2,
+  ChevronsRight,
+  Check,
+  ChevronDown,
+  Copy,
+  Eye,
+  FolderOpen,
+  FolderGit2,
+  FolderKanban,
+  Github,
+  Hand,
+  List,
+  Loader2,
+  Paperclip,
+  PlugZap,
+  RefreshCcw,
+  Search,
+  SlidersHorizontal,
+  Settings2,
+  type LucideIcon,
+  Volume2,
+  VolumeX,
+  X,
+} from "lucide-react";
+import type { DashboardSession } from "@/lib/types";
+import { normalizeAgentName } from "@/lib/agentUtils";
+import { useSessions } from "@/hooks/useSessions";
+import { useConfig, type ConfigProject } from "@/hooks/useConfig";
+import { useAgents } from "@/hooks/useAgents";
+import { AppShell } from "@/components/layout/AppShell";
+import { TopBar } from "@/components/layout/TopBar";
+import { AgentTileIcon } from "@/components/AgentTileIcon";
+import { WorkspaceSidebarPanel } from "@/components/layout/WorkspaceSidebarPanel";
+import { normalizeModelAccessPreferences } from "@/lib/modelAccess";
+import {
+  getRuntimeCatalogDefaultModelForAccess,
+  getRuntimeCatalogDefaultReasoning,
+  getRuntimeCatalogModelsForAccess,
+  getRuntimeCatalogReasoningOptions,
+  type RuntimeAgentModelCatalog,
+} from "@/lib/runtimeAgentModelsShared";
+
+const EXECUTOR_ORDER = [
+  "codex",
+  "gemini",
+  "qwen-code",
+  "droid",
+  "claude-code",
+  "amp",
+  "opencode",
+  "github-copilot",
+  "cursor-cli",
+  "ccr",
+];
+
+const EXECUTOR_LABELS: Record<string, string> = {
+  codex: "Codex",
+  gemini: "Gemini",
+  "qwen-code": "Qwen Code",
+  droid: "Droid",
+  "claude-code": "Claude Code",
+  amp: "Amp",
+  opencode: "Opencode",
+  "github-copilot": "Copilot",
+  "cursor-cli": "Cursor Agent",
+  ccr: "CCR",
+};
+
+const AGENT_SETUP_URLS: Record<string, string> = {
+  "claude-code": "https://claude.ai/",
+  codex: "https://chatgpt.com/codex",
+  gemini: "https://aistudio.google.com/",
+  "qwen-code": "https://chat.qwen.ai/",
+  opencode: "https://opencode.ai/",
+  "github-copilot": "https://github.com/settings/copilot",
+};
+
+const SessionDetail = dynamic(
+  () => import("@/components/sessions/SessionDetail").then((mod) => mod.SessionDetail),
+  {
+    loading: () => (
+      <div className="flex h-full items-center justify-center text-[13px] text-[var(--vk-text-muted)]">
+        Loading session...
+      </div>
+    ),
+  },
+);
+
+const WorkspaceKanban = dynamic(
+  () => import("@/components/board/WorkspaceKanban").then((mod) => mod.WorkspaceKanban),
+  {
+    loading: () => (
+      <div className="flex h-full items-center justify-center text-[13px] text-[var(--vk-text-muted)]">
+        Loading board...
+      </div>
+    ),
+  },
+);
+
+function getAgentLabel(value: string): string {
+  const normalized = normalizeAgentName(value);
+  if (EXECUTOR_LABELS[normalized]) return EXECUTOR_LABELS[normalized];
+  return value
+    .split(/[-_\s]+/g)
+    .filter(Boolean)
+    .map((part) => part[0]?.toUpperCase() + part.slice(1))
+    .join(" ");
+}
+
+function formatCurrentModelLabel(agentName: string, modelId: string): string {
+  const normalizedModel = modelId.trim();
+  const normalizedAgent = normalizeAgentName(agentName);
+  if (!normalizedModel) return normalizedModel;
+
+  if (normalizedAgent === "claude-code") {
+    const lower = normalizedModel.toLowerCase();
+    if (lower === "opus") return "Claude Opus";
+    if (lower === "sonnet") return "Claude Sonnet";
+    if (lower === "haiku") return "Claude Haiku";
+    const match = lower.match(/^claude-(sonnet|opus|haiku)-(\d+)-(\d+)(?:-\d{8})?$/);
+    if (match) {
+      const family = match[1];
+      return `Claude ${family[0]?.toUpperCase() + family.slice(1)} ${match[2]}.${match[3]}`;
+    }
+  }
+
+  return normalizedModel
+    .split(/[-_]+/g)
+    .filter(Boolean)
+    .map((segment) => {
+      const lower = segment.toLowerCase();
+      if (lower === "gpt") return "GPT";
+      if (/^\d+(?:\.\d+)?$/.test(segment)) return segment;
+      return segment[0]?.toUpperCase() + segment.slice(1);
+    })
+    .join("-");
+}
+
+type NewWorkspacePayload = {
+  mode: "git" | "local";
+  projectId?: string;
+  agent: string;
+  defaultBranch: string;
+  useWorktree?: boolean;
+  gitUrl?: string;
+  path?: string;
+  initializeGit?: boolean;
+};
+
+type CreatePermissionMode = "default" | "auto" | "ask" | "plan";
+
+type CreateSessionOptions = {
+  projectId?: string;
+  branch?: string;
+  baseBranch?: string;
+  useWorktree?: boolean;
+  permissionMode?: CreatePermissionMode;
+  issueId?: string;
+};
+
+type LinkedBoardTask = {
+  id: string;
+  text: string;
+  taskRef: string | null;
+  type: string | null;
+  priority: string | null;
+};
+
+type LinkedBoardResponse = {
+  columns?: Array<{
+    tasks?: LinkedBoardTask[];
+  }>;
+};
+
+type GitHubRepo = {
+  name: string;
+  fullName: string;
+  httpsUrl: string;
+  sshUrl: string;
+  defaultBranch: string;
+  private: boolean;
+};
+
+type DirectoryEntry = {
+  name: string;
+  path: string;
+  isDirectory: boolean;
+  isGitRepo: boolean;
+};
+
+type PreferencesPayload = {
+  onboardingAcknowledged: boolean;
+  codingAgent: string;
+  ide: string;
+  remoteSshHost: string;
+  remoteSshUser: string;
+  markdownEditor: string;
+  modelAccess: ModelAccessPreferences;
+  notifications: {
+    soundEnabled: boolean;
+    soundFile: string | null;
+  };
+};
+
+type AccessIdentitySummary = {
+  authenticated: boolean;
+  role: DashboardRole | null;
+  email: string | null;
+  provider: string | null;
+};
+
+function getLinkedTaskValue(task: LinkedBoardTask): string {
+  return task.taskRef?.trim() || task.id;
+}
+
+function getLinkedTaskTitle(text: string): string {
+  const [title] = text.split(" - ");
+  return (title ?? text).trim();
+}
+
+type AccessSettingsPayload = {
+  requireAuth: boolean;
+  defaultRole: DashboardRole;
+  trustedHeaders: {
+    enabled: boolean;
+    provider: TrustedHeaderAccessProvider;
+    emailHeader: string;
+    jwtHeader: string;
+    teamDomain: string;
+    audience: string;
+  };
+  roles: {
+    viewers: string;
+    operators: string;
+    admins: string;
+    viewerDomains: string;
+    operatorDomains: string;
+    adminDomains: string;
+  };
+  current: AccessIdentitySummary;
+};
+
+type RepositoryPathHealth = {
+  exists: boolean;
+  isGitRepository: boolean;
+  suggestedPath: string | null;
+};
+
+type RepositorySettingsPayload = {
+  id: string;
+  displayName: string;
+  repo: string;
+  path: string;
+  agent: string;
+  agentModel: string;
+  agentReasoningEffort: string;
+  workspaceMode: string;
+  runtimeMode: string;
+  scmMode: string;
+  defaultWorkingDirectory: string;
+  defaultBranch: string;
+  devServerScript: string;
+  setupScript: string;
+  runSetupInParallel: boolean;
+  cleanupScript: string;
+  archiveScript: string;
+  copyFiles: string;
+  pathHealth: RepositoryPathHealth;
+};
+
+type ModelSelectionState = {
+  catalogModel: string;
+  customModel: string;
+  reasoningEffort: string;
+};
+
+type AgentSetupState = {
+  name: string;
+  ready: boolean;
+  installed: boolean;
+  configured: boolean;
+  homepage: string | null;
+  description: string | null;
+};
+
+type PreferencesDialogMode = "onboarding" | "settings";
+type SettingsTabId =
+  | "general"
+  | "remote_access"
+  | "repositories"
+  | "organization"
+  | "projects"
+  | "agents"
+  | "mcp"
+  | "preferences";
+
+type SettingsTab = {
+  id: SettingsTabId;
+  label: string;
+  icon: LucideIcon;
+  implemented: boolean;
+};
+
+const SETTINGS_TABS: SettingsTab[] = [
+  { id: "general", label: "General", icon: Settings2, implemented: true },
+  { id: "remote_access", label: "Remote Access", icon: SlidersHorizontal, implemented: true },
+  { id: "repositories", label: "Repositories", icon: FolderGit2, implemented: true },
+  { id: "organization", label: "Organization Settings", icon: Building2, implemented: true },
+  { id: "projects", label: "Projects", icon: FolderKanban, implemented: false },
+  { id: "agents", label: "Agents", icon: Bot, implemented: true },
+  { id: "mcp", label: "MCP Servers", icon: PlugZap, implemented: false },
+  { id: "preferences", label: "Preferences", icon: SlidersHorizontal, implemented: false },
+];
+
+const ONBOARDING_TABS: SettingsTab[] = [
+  { id: "preferences", label: "Preferences", icon: SlidersHorizontal, implemented: true },
+  { id: "repositories", label: "Repository", icon: FolderGit2, implemented: true },
+];
+
+const IDE_OPTIONS = [
+  { id: "vscode", label: "VS Code" },
+  { id: "vscode-insiders", label: "VS Code Insiders" },
+  { id: "cursor", label: "Cursor" },
+  { id: "windsurf", label: "Windsurf" },
+  { id: "intellij-idea", label: "IntelliJ IDEA" },
+  { id: "zed", label: "Zed" },
+  { id: "xcode", label: "Xcode" },
+  { id: "antigravity", label: "Antigravity" },
+  { id: "custom", label: "Custom" },
+];
+
+const MARKDOWN_EDITOR_OPTIONS = [
+  { id: "obsidian", label: "Obsidian" },
+  { id: "vscode", label: "VS Code" },
+  { id: "notion", label: "Notion" },
+  { id: "typora", label: "Typora" },
+  { id: "logseq", label: "Logseq" },
+  { id: "custom", label: "Custom" },
+];
+
+const NOTIFICATION_SOUND_OPTIONS = [
+  { id: "abstract-sound-1", label: "Abstract Sound 1" },
+  { id: "abstract-sound-2", label: "Abstract Sound 2" },
+  { id: "abstract-sound-3", label: "Abstract Sound 3" },
+  { id: "abstract-sound-4", label: "Abstract Sound 4" },
+  { id: "cow-mooing", label: "Cow Mooing" },
+  { id: "phone-vibration", label: "Phone Vibration" },
+  { id: "rooster", label: "Rooster" },
+];
+
+function toObject(value: unknown): Record<string, unknown> {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return {};
+  return { ...(value as Record<string, unknown>) };
+}
+
+function normalizePreferences(value: unknown, fallbackAgent: string): PreferencesPayload {
+  const payload = toObject(value);
+  const notifications = toObject(payload["notifications"]);
+  const soundFileRaw = notifications["soundFile"];
+  const codingAgent = typeof payload["codingAgent"] === "string" && payload["codingAgent"].trim().length > 0
+    ? payload["codingAgent"].trim()
+    : fallbackAgent;
+  const ide = typeof payload["ide"] === "string" && payload["ide"].trim().length > 0
+    ? payload["ide"].trim()
+    : "vscode";
+  const remoteSshHost = typeof payload["remoteSshHost"] === "string" && payload["remoteSshHost"].trim().length > 0
+    ? payload["remoteSshHost"].trim()
+    : "";
+  const remoteSshUser = typeof payload["remoteSshUser"] === "string" && payload["remoteSshUser"].trim().length > 0
+    ? payload["remoteSshUser"].trim()
+    : "";
+  const markdownEditor = typeof payload["markdownEditor"] === "string" && payload["markdownEditor"].trim().length > 0
+    ? payload["markdownEditor"].trim()
+    : "obsidian";
+
+  return {
+    onboardingAcknowledged: payload["onboardingAcknowledged"] === true,
+    codingAgent,
+    ide,
+    remoteSshHost,
+    remoteSshUser,
+    markdownEditor,
+    modelAccess: normalizeModelAccessPreferences(payload["modelAccess"]),
+    notifications: {
+      soundEnabled: notifications["soundEnabled"] !== false,
+      soundFile: soundFileRaw === null
+        ? null
+        : typeof soundFileRaw === "string" && soundFileRaw.trim().length > 0
+          ? soundFileRaw.trim()
+          : "abstract-sound-4",
+    },
+  };
+}
+
+function normalizeMultilineList(value: unknown): string {
+  if (Array.isArray(value)) {
+    return value
+      .filter((item): item is string => typeof item === "string")
+      .map((item) => item.trim())
+      .filter(Boolean)
+      .join("\n");
+  }
+  if (typeof value !== "string") return "";
+  return value
+    .split(/[\n,]+/g)
+    .map((item) => item.trim())
+    .filter(Boolean)
+    .join("\n");
+}
+
+function normalizeAccessSettings(value: unknown, summary?: unknown): AccessSettingsPayload {
+  const payload = toObject(value);
+  const trustedHeaders = toObject(payload["trustedHeaders"]);
+  const roles = toObject(payload["roles"]);
+  const current = toObject(summary);
+  const defaultRoleRaw = payload["defaultRole"];
+  const defaultRole: DashboardRole =
+    defaultRoleRaw === "viewer" || defaultRoleRaw === "admin" || defaultRoleRaw === "operator"
+      ? defaultRoleRaw
+      : "operator";
+  const currentRoleRaw = current["role"];
+
+  return {
+    requireAuth: payload["requireAuth"] === true,
+    defaultRole,
+    trustedHeaders: {
+      enabled: trustedHeaders["enabled"] === true,
+      provider: trustedHeaders["provider"] === "generic" ? "generic" : "cloudflare-access",
+      emailHeader: typeof trustedHeaders["emailHeader"] === "string" && trustedHeaders["emailHeader"].trim().length > 0
+        ? trustedHeaders["emailHeader"].trim()
+        : "Cf-Access-Authenticated-User-Email",
+      jwtHeader: typeof trustedHeaders["jwtHeader"] === "string" && trustedHeaders["jwtHeader"].trim().length > 0
+        ? trustedHeaders["jwtHeader"].trim()
+        : "Cf-Access-Jwt-Assertion",
+      teamDomain: typeof trustedHeaders["teamDomain"] === "string" && trustedHeaders["teamDomain"].trim().length > 0
+        ? trustedHeaders["teamDomain"].trim()
+        : "",
+      audience: typeof trustedHeaders["audience"] === "string" && trustedHeaders["audience"].trim().length > 0
+        ? trustedHeaders["audience"].trim()
+        : "",
+    },
+    roles: {
+      viewers: normalizeMultilineList(roles["viewers"]),
+      operators: normalizeMultilineList(roles["operators"]),
+      admins: normalizeMultilineList(roles["admins"]),
+      viewerDomains: normalizeMultilineList(roles["viewerDomains"]),
+      operatorDomains: normalizeMultilineList(roles["operatorDomains"]),
+      adminDomains: normalizeMultilineList(roles["adminDomains"]),
+    },
+    current: {
+      authenticated: current["authenticated"] === true,
+      role: currentRoleRaw === "viewer" || currentRoleRaw === "operator" || currentRoleRaw === "admin"
+        ? currentRoleRaw
+        : null,
+      email: typeof current["email"] === "string" && current["email"].trim().length > 0
+        ? current["email"].trim()
+        : null,
+      provider: typeof current["provider"] === "string" && current["provider"].trim().length > 0
+        ? current["provider"].trim()
+        : null,
+    },
+  };
+}
+
+function emptyModelSelection(): ModelSelectionState {
+  return {
+    catalogModel: "",
+    customModel: "",
+    reasoningEffort: "",
+  };
+}
+
+function getRuntimeModelCatalog(
+  agent: string,
+  runtimeModelCatalogs: Record<string, RuntimeAgentModelCatalog>,
+): RuntimeAgentModelCatalog | null {
+  return runtimeModelCatalogs[normalizeAgentName(agent)] ?? null;
+}
+
+function getAllRuntimeCatalogModels(
+  runtimeCatalog: RuntimeAgentModelCatalog | null,
+): AgentModelOption[] {
+  if (!runtimeCatalog) return [];
+
+  const ordered: AgentModelOption[] = [];
+  const seen = new Set<string>();
+  for (const group of Object.values(runtimeCatalog.modelsByAccess)) {
+    if (!Array.isArray(group)) continue;
+    for (const model of group) {
+      if (!model?.id || seen.has(model.id)) continue;
+      seen.add(model.id);
+      ordered.push(model);
+    }
+  }
+  return ordered;
+}
+
+function getSelectableAgentModels(
+  agent: string,
+  modelAccess: ModelAccessPreferences,
+  runtimeModelCatalogs: Record<string, RuntimeAgentModelCatalog>,
+): AgentModelOption[] {
+  const runtimeCatalog = getRuntimeModelCatalog(agent, runtimeModelCatalogs);
+  const access = resolveAgentModelAccess(agent, modelAccess);
+  const scopedModels = getRuntimeCatalogModelsForAccess(runtimeCatalog, access);
+  return scopedModels.length > 0 ? scopedModels : getAllRuntimeCatalogModels(runtimeCatalog);
+}
+
+function getSelectableAgentReasoningOptions(
+  agent: string,
+  modelAccess: ModelAccessPreferences,
+  runtimeModelCatalogs: Record<string, RuntimeAgentModelCatalog>,
+  model: string | null | undefined,
+): AgentReasoningOption[] {
+  const runtimeCatalog = getRuntimeModelCatalog(agent, runtimeModelCatalogs);
+  const access = resolveAgentModelAccess(agent, modelAccess);
+  return getRuntimeCatalogReasoningOptions(runtimeCatalog, model, access);
+}
+
+function getSelectableDefaultAgentModel(
+  agent: string,
+  modelAccess: ModelAccessPreferences,
+  runtimeModelCatalogs: Record<string, RuntimeAgentModelCatalog>,
+): string {
+  const runtimeCatalog = getRuntimeModelCatalog(agent, runtimeModelCatalogs);
+  const access = resolveAgentModelAccess(agent, modelAccess);
+  return getRuntimeCatalogDefaultModelForAccess(runtimeCatalog, access)
+    ?? getAllRuntimeCatalogModels(runtimeCatalog)[0]?.id
+    ?? "";
+}
+
+function getSelectableDefaultReasoningEffort(
+  agent: string,
+  modelAccess: ModelAccessPreferences,
+  runtimeModelCatalogs: Record<string, RuntimeAgentModelCatalog>,
+  model: string | null | undefined,
+): string {
+  const runtimeCatalog = getRuntimeModelCatalog(agent, runtimeModelCatalogs);
+  const access = resolveAgentModelAccess(agent, modelAccess);
+  return getRuntimeCatalogDefaultReasoning(runtimeCatalog, model, access) ?? "";
+}
+
+function getSelectableModelPlaceholder(
+  agent: string,
+  runtimeModelCatalogs: Record<string, RuntimeAgentModelCatalog>,
+): string {
+  const runtimeCatalog = getRuntimeModelCatalog(agent, runtimeModelCatalogs);
+  if (runtimeCatalog?.customModelPlaceholder.trim()) {
+    return runtimeCatalog.customModelPlaceholder;
+  }
+  const label = getAgentModelCatalog(agent)?.label ?? "agent";
+  return `Enter exact ${label} model id`;
+}
+
+function buildModelSelection(
+  agent: string,
+  modelAccess: ModelAccessPreferences,
+  runtimeModelCatalogs: Record<string, RuntimeAgentModelCatalog>,
+  preferredModel?: string | null,
+  preferredReasoningEffort?: string | null,
+): ModelSelectionState {
+  const trimmedPreferred = preferredModel?.trim() ?? "";
+  const trimmedPreferredReasoning = preferredReasoningEffort?.trim().toLowerCase() ?? "";
+  const availableModels = getSelectableAgentModels(agent, modelAccess, runtimeModelCatalogs);
+  const defaultModel = getSelectableDefaultAgentModel(agent, modelAccess, runtimeModelCatalogs);
+  const resolveReasoningEffort = (resolvedModel: string | null | undefined): string => {
+    const options = getSelectableAgentReasoningOptions(agent, modelAccess, runtimeModelCatalogs, resolvedModel);
+    if (trimmedPreferredReasoning.length > 0 && options.some((option) => option.id === trimmedPreferredReasoning)) {
+      return trimmedPreferredReasoning;
+    }
+    return getSelectableDefaultReasoningEffort(agent, modelAccess, runtimeModelCatalogs, resolvedModel);
+  };
+
+  if (trimmedPreferred.length > 0) {
+    if (availableModels.some((model) => model.id === trimmedPreferred)) {
+      return {
+        catalogModel: trimmedPreferred,
+        customModel: "",
+        reasoningEffort: resolveReasoningEffort(trimmedPreferred),
+      };
+    }
+
+    return {
+      catalogModel: defaultModel,
+      customModel: trimmedPreferred,
+      reasoningEffort: resolveReasoningEffort(trimmedPreferred),
+    };
+  }
+
+  return {
+    catalogModel: defaultModel,
+    customModel: "",
+    reasoningEffort: resolveReasoningEffort(defaultModel),
+  };
+}
+
+function resolveModelSelectionValue(selection: ModelSelectionState): string | undefined {
+  const custom = selection.customModel.trim();
+  if (custom.length > 0) return custom;
+  const catalog = selection.catalogModel.trim();
+  return catalog.length > 0 ? catalog : undefined;
+}
+
+function resolveReasoningSelectionValue(selection: ModelSelectionState): string | undefined {
+  const reasoningEffort = selection.reasoningEffort.trim().toLowerCase();
+  return reasoningEffort.length > 0 ? reasoningEffort : undefined;
+}
+
+function getAgentModelAccessLabel(agent: string, modelAccess: ModelAccessPreferences): string | null {
+  const catalog = getAgentModelCatalog(agent);
+  const access = resolveAgentModelAccess(agent, modelAccess);
+  if (!catalog || !access) return null;
+
+  return catalog.accessOptions.find((option) => option.id === access)?.label ?? null;
+}
+
+const MARKDOWN_EDITOR_ICON_CLASS = "block h-4 w-4 shrink-0";
+const CODE_EDITOR_ICON_CLASS = "block h-4 w-4 shrink-0 object-contain";
+
+type CodeEditorIconSpec =
+  | { kind: "icon"; icon: IconType; className: string }
+  | { kind: "image"; imageSrc: string; className: string };
+
+const CODE_EDITOR_ICON_MAP: Record<string, CodeEditorIconSpec> = {
+  vscode: { kind: "image", imageSrc: "/icons/ide/vscode-dark.svg", className: CODE_EDITOR_ICON_CLASS },
+  "vscode-insiders": { kind: "image", imageSrc: "/icons/ide/vscode-insiders.svg", className: CODE_EDITOR_ICON_CLASS },
+  cursor: { kind: "image", imageSrc: "/icons/ide/cursor-dark.svg", className: CODE_EDITOR_ICON_CLASS },
+  windsurf: { kind: "image", imageSrc: "/icons/ide/windsurf-dark.svg", className: CODE_EDITOR_ICON_CLASS },
+  "intellij-idea": { kind: "image", imageSrc: "/icons/ide/intellij.svg", className: CODE_EDITOR_ICON_CLASS },
+  zed: { kind: "image", imageSrc: "/icons/ide/zed-dark.svg", className: CODE_EDITOR_ICON_CLASS },
+  xcode: { kind: "image", imageSrc: "/icons/ide/xcode.svg", className: CODE_EDITOR_ICON_CLASS },
+  antigravity: { kind: "image", imageSrc: "/icons/ide/antigravity-dark.svg", className: CODE_EDITOR_ICON_CLASS },
+  custom: { kind: "icon", icon: Settings2, className: `${CODE_EDITOR_ICON_CLASS} text-[var(--vk-text-muted)]` },
+};
+
+function CodeEditorIcon({ editorId, label }: { editorId: string; label: string }) {
+  const iconSpec = CODE_EDITOR_ICON_MAP[editorId];
+  if (!iconSpec) {
+    return <Settings2 className={`${CODE_EDITOR_ICON_CLASS} text-[var(--vk-text-muted)]`} />;
+  }
+  if (iconSpec.kind === "image") {
+    return <img src={iconSpec.imageSrc} alt={`${label} logo`} className={iconSpec.className} />;
+  }
+  const Icon = iconSpec.icon;
+  return <Icon className={iconSpec.className} />;
+}
+
+function shellQuote(value: string): string {
+  return JSON.stringify(value);
+}
+
+function buildRepositoryBootstrapCommand(
+  repository: RepositorySettingsPayload,
+  preferences: Pick<PreferencesPayload, "ide" | "markdownEditor">,
+): string {
+  const initArgs = [
+    "npx conductor-oss@latest setup",
+    "--yes",
+    `--path ${shellQuote(repository.path)}`,
+    `--project-id ${shellQuote(repository.id)}`,
+    `--display-name ${shellQuote(repository.displayName)}`,
+    `--agent ${shellQuote(repository.agent || "claude-code")}`,
+    `--ide ${shellQuote(preferences.ide)}`,
+    `--markdown-editor ${shellQuote(preferences.markdownEditor)}`,
+  ];
+
+  if (repository.repo.trim().length > 0) {
+    initArgs.push(`--repo ${shellQuote(repository.repo.trim())}`);
+  }
+  if (repository.defaultBranch.trim().length > 0) {
+    initArgs.push(`--default-branch ${shellQuote(repository.defaultBranch.trim())}`);
+  }
+  if (repository.agentModel.trim().length > 0) {
+    initArgs.push(`--model ${shellQuote(repository.agentModel.trim())}`);
+  }
+  if (repository.agentReasoningEffort.trim().length > 0) {
+    initArgs.push(`--reasoning-effort ${shellQuote(repository.agentReasoningEffort.trim())}`);
+  }
+  if (repository.defaultWorkingDirectory.trim().length > 0) {
+    initArgs.push(`--default-working-directory ${shellQuote(repository.defaultWorkingDirectory.trim())}`);
+  }
+
+  return initArgs.join(" ");
+}
+
+type MarkdownEditorIconSpec =
+  | { kind: "icon"; icon: IconType; className: string }
+  | { kind: "image"; imageSrc: string; className: string };
+
+const MARKDOWN_EDITOR_ICON_MAP: Record<string, MarkdownEditorIconSpec> = {
+  obsidian: { kind: "icon", icon: SiObsidian, className: `${MARKDOWN_EDITOR_ICON_CLASS} text-[#8b5cf6]` },
+  vscode: { kind: "icon", icon: VscVscode, className: `${MARKDOWN_EDITOR_ICON_CLASS} text-[#22a3f5]` },
+  notion: { kind: "icon", icon: SiNotion, className: `${MARKDOWN_EDITOR_ICON_CLASS} text-white` },
+  logseq: { kind: "image", imageSrc: "/icons/editors/logseq.svg", className: `${MARKDOWN_EDITOR_ICON_CLASS} object-contain` },
+  typora: {
+    kind: "image",
+    imageSrc: "/icons/editors/typora-32.png",
+    className: `${MARKDOWN_EDITOR_ICON_CLASS} rounded-[3px] bg-white/90 p-[1px] object-contain`,
+  },
+  custom: { kind: "icon", icon: Settings2, className: `${MARKDOWN_EDITOR_ICON_CLASS} text-[var(--vk-text-muted)]` },
+};
+
+function MarkdownEditorIcon({ editorId }: { editorId: string }) {
+  const iconSpec = MARKDOWN_EDITOR_ICON_MAP[editorId];
+  if (!iconSpec) {
+    return <BookText className={`${MARKDOWN_EDITOR_ICON_CLASS} text-[var(--vk-text-muted)]`} />;
+  }
+  if (iconSpec.kind === "image") {
+    return <img src={iconSpec.imageSrc} alt="" className={iconSpec.className} />;
+  }
+  const Icon = iconSpec.icon;
+  return <Icon className={iconSpec.className} />;
+}
+
+function AgentModelSelector({
+  agent,
+  modelAccess,
+  runtimeModelCatalogs,
+  selection,
+  onChange,
+  compact = false,
+}: {
+  agent: string;
+  modelAccess: ModelAccessPreferences;
+  runtimeModelCatalogs: Record<string, RuntimeAgentModelCatalog>;
+  selection: ModelSelectionState;
+  onChange: (next: ModelSelectionState) => void;
+  compact?: boolean;
+}) {
+  if (!supportsAgentModelSelection(agent)) return null;
+
+  const catalog = getAgentModelCatalog(agent);
+  const availableModels = getSelectableAgentModels(agent, modelAccess, runtimeModelCatalogs);
+  const resolvedModel = resolveModelSelectionValue(selection) ?? selection.catalogModel;
+  const availableReasoningOptions = getSelectableAgentReasoningOptions(
+    agent,
+    modelAccess,
+    runtimeModelCatalogs,
+    resolvedModel,
+  );
+  const accessLabel = getAgentModelAccessLabel(agent, modelAccess);
+
+  if (!catalog) return null;
+
+  return (
+    <div className={compact ? "grid gap-3 md:grid-cols-3" : "space-y-3"}>
+      <label className="block">
+        <span className="mb-1.5 block text-[12px] text-[var(--vk-text-muted)]">Model</span>
+        <select
+          value={selection.catalogModel}
+          disabled={availableModels.length === 0}
+          onChange={(event) => {
+            const nextCatalogModel = event.target.value;
+            const nextReasoningOptions = getSelectableAgentReasoningOptions(
+              agent,
+              modelAccess,
+              runtimeModelCatalogs,
+              nextCatalogModel,
+            );
+            onChange({
+              ...selection,
+              catalogModel: nextCatalogModel,
+              reasoningEffort: nextReasoningOptions.some((option) => option.id === selection.reasoningEffort)
+                ? selection.reasoningEffort
+                : getSelectableDefaultReasoningEffort(agent, modelAccess, runtimeModelCatalogs, nextCatalogModel),
+            });
+          }}
+          className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-[var(--vk-bg-panel)] px-2 text-[14px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)] disabled:opacity-60"
+        >
+          {availableModels.length === 0 && (
+            <option value="">No runtime models detected</option>
+          )}
+          {availableModels.map((model) => (
+            <option key={model.id} value={model.id}>
+              {model.label}
+            </option>
+          ))}
+        </select>
+        <p className="mt-1 text-[11px] text-[var(--vk-text-muted)]">
+          {accessLabel
+            ? `Filtered for ${accessLabel}.`
+            : "Filtered for your current access preference."} Leave custom override blank to use this selection.
+        </p>
+      </label>
+
+      {availableReasoningOptions.length > 0 && (
+        <label className="block">
+          <span className="mb-1.5 block text-[12px] text-[var(--vk-text-muted)]">Reasoning Effort</span>
+          <select
+            value={selection.reasoningEffort}
+            onChange={(event) => {
+              onChange({
+                ...selection,
+                reasoningEffort: event.target.value,
+              });
+            }}
+            className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-[var(--vk-bg-panel)] px-2 text-[14px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+          >
+            {availableReasoningOptions.map((option) => (
+              <option key={option.id} value={option.id}>
+                {option.label}
+              </option>
+            ))}
+          </select>
+          <p className="mt-1 text-[11px] text-[var(--vk-text-muted)]">
+            Choose how much deliberate reasoning the CLI should use before it acts.
+          </p>
+        </label>
+      )}
+
+      <label className="block">
+        <span className="mb-1.5 block text-[12px] text-[var(--vk-text-muted)]">Custom Model Override</span>
+        <input
+          value={selection.customModel}
+          onChange={(event) => {
+            const nextCustomModel = event.target.value;
+            const nextResolvedModel = nextCustomModel.trim() || selection.catalogModel;
+            const nextReasoningOptions = getSelectableAgentReasoningOptions(
+              agent,
+              modelAccess,
+              runtimeModelCatalogs,
+              nextResolvedModel,
+            );
+            onChange({
+              ...selection,
+              customModel: nextCustomModel,
+              reasoningEffort: nextReasoningOptions.some((option) => option.id === selection.reasoningEffort)
+                ? selection.reasoningEffort
+                : getSelectableDefaultReasoningEffort(
+                  agent,
+                  modelAccess,
+                  runtimeModelCatalogs,
+                  nextResolvedModel,
+                ),
+            });
+          }}
+          placeholder={getSelectableModelPlaceholder(agent, runtimeModelCatalogs)}
+          className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 text-[14px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+        />
+        <p className="mt-1 text-[11px] text-[var(--vk-text-muted)]">
+          Optional. Use this to force an exact model id from the installed CLI when you want to override the detected list.
+        </p>
+      </label>
+    </div>
+  );
+}
+
+export default function Home() {
+  const [selectedProjectId, setSelectedProjectId] = useState<string | null>(null);
+  const { sessions, error: sessionsError, refresh: refreshSessions } = useSessions(selectedProjectId);
+  const { projects, error: configError, refresh: refreshConfig } = useConfig();
+  const { agents } = useAgents();
+
+  const [selectedSessionId, setSelectedSessionId] = useState<string | null>(null);
+  const [sidebarOpen, setSidebarOpen] = useState(true);
+
+  const [prompt, setPrompt] = useState("");
+  const [selectedAgent, setSelectedAgent] = useState("");
+  const [launchModelSelection, setLaunchModelSelection] = useState<ModelSelectionState>(emptyModelSelection());
+  const [creating, setCreating] = useState(false);
+  const [createError, setCreateError] = useState<string | null>(null);
+  const [newWorkspaceOpen, setNewWorkspaceOpen] = useState(false);
+  const [creatingWorkspace, setCreatingWorkspace] = useState(false);
+  const [newWorkspaceError, setNewWorkspaceError] = useState<string | null>(null);
+  const [workspaceView, setWorkspaceView] = useState<"chat" | "board">("chat");
+  const [preferences, setPreferences] = useState<PreferencesPayload | null>(null);
+  const [preferencesLoading, setPreferencesLoading] = useState(true);
+  const [preferencesSaving, setPreferencesSaving] = useState(false);
+  const [preferencesError, setPreferencesError] = useState<string | null>(null);
+  const [preferencesDialogOpen, setPreferencesDialogOpen] = useState(false);
+  const [pendingWorkspaceSetup, setPendingWorkspaceSetup] = useState(false);
+
+  const dashboardSessions = sessions as unknown as DashboardSession[];
+  const workspaceError = createError ?? configError ?? sessionsError ?? preferencesError;
+
+  useEffect(() => {
+    if (typeof window === "undefined") return;
+    if (window.innerWidth < 1024) {
+      setSidebarOpen(false);
+    }
+  }, []);
+
+  useEffect(() => {
+    if (projects.length === 0) {
+      if (selectedProjectId !== null) setSelectedProjectId(null);
+      return;
+    }
+
+    if (!selectedProjectId || !projects.some((project) => project.id === selectedProjectId)) {
+      setSelectedProjectId(projects[0]?.id ?? null);
+    }
+  }, [projects, selectedProjectId]);
+
+  useEffect(() => {
+    if (!selectedSessionId) return;
+    if (!dashboardSessions.some((session) => session.id === selectedSessionId)) {
+      setSelectedSessionId(null);
+    }
+  }, [dashboardSessions, selectedSessionId]);
+
+  const selectedSession = useMemo(
+    () => dashboardSessions.find((s) => s.id === selectedSessionId) ?? null,
+    [dashboardSessions, selectedSessionId],
+  );
+  const selectedProject = useMemo(
+    () => projects.find((project) => project.id === selectedProjectId) ?? null,
+    [projects, selectedProjectId],
+  );
+
+  const agentOptions = useMemo(() => {
+    const safeAgents = Array.isArray(agents)
+      ? agents as Array<{ name?: string; ready?: boolean; configured?: boolean; installed?: boolean }>
+      : [];
+    const opts = new Set<string>();
+
+    for (const agent of safeAgents) {
+      if (agent.name) {
+        opts.add(agent.name);
+      }
+    }
+    for (const project of projects) {
+      if (project.agent) opts.add(project.agent);
+    }
+    if (preferences?.codingAgent) {
+      opts.add(preferences.codingAgent);
+    }
+    if (selectedAgent) {
+      opts.add(selectedAgent);
+    }
+    if (opts.size === 0) {
+      opts.add(preferences?.codingAgent || "qwen-code");
+    }
+    return [...opts];
+  }, [agents, preferences?.codingAgent, projects, selectedAgent]);
+
+  const agentStatesByName = useMemo(() => {
+    const states: Record<string, AgentSetupState> = {};
+    const safeAgents = Array.isArray(agents)
+      ? agents as Array<{
+        name?: string;
+        ready?: boolean;
+        installed?: boolean;
+        configured?: boolean;
+        homepage?: string | null;
+        description?: string | null;
+      }>
+      : [];
+
+    for (const agent of safeAgents) {
+      if (!agent.name) continue;
+      states[normalizeAgentName(agent.name)] = {
+        name: agent.name,
+        ready: agent.ready === true,
+        installed: agent.installed !== false,
+        configured: agent.configured !== false,
+        homepage: typeof agent.homepage === "string" ? agent.homepage : null,
+        description: typeof agent.description === "string" ? agent.description : null,
+      };
+    }
+
+    return states;
+  }, [agents]);
+
+  const runtimeModelCatalogs = useMemo(() => {
+    const catalogs: Record<string, RuntimeAgentModelCatalog> = {};
+    const safeAgents = Array.isArray(agents)
+      ? agents as Array<{ name?: string; runtimeModelCatalog?: RuntimeAgentModelCatalog | null }>
+      : [];
+
+    for (const agent of safeAgents) {
+      if (!agent.name || !agent.runtimeModelCatalog) continue;
+      catalogs[normalizeAgentName(agent.name)] = agent.runtimeModelCatalog;
+    }
+
+    return catalogs;
+  }, [agents]);
+
+  const openAgentSetup = useCallback((agentName: string) => {
+    const normalized = normalizeAgentName(agentName);
+    const target = agentStatesByName[normalized]?.homepage || AGENT_SETUP_URLS[normalized];
+    if (!target || typeof window === "undefined") return;
+    window.open(target, "_blank", "noopener,noreferrer");
+  }, [agentStatesByName]);
+
+  useEffect(() => {
+    let cancelled = false;
+    async function loadPreferences() {
+      setPreferencesLoading(true);
+      try {
+        const res = await fetch("/api/preferences");
+        const data = (await res.json().catch(() => null)) as
+          | { preferences?: unknown; error?: string }
+          | null;
+        if (!res.ok) {
+          throw new Error(data?.error ?? `Failed to load preferences: ${res.status}`);
+        }
+        if (cancelled) return;
+        const normalized = normalizePreferences(data?.preferences, "qwen-code");
+        setPreferences(normalized);
+        setPreferencesError(null);
+      } catch (err) {
+        if (cancelled) return;
+        setPreferences(normalizePreferences(null, "qwen-code"));
+        setPreferencesError(err instanceof Error ? err.message : "Failed to load preferences");
+      } finally {
+        if (!cancelled) {
+          setPreferencesLoading(false);
+        }
+      }
+    }
+
+    void loadPreferences();
+    return () => {
+      cancelled = true;
+    };
+  }, []);
+
+  useEffect(() => {
+    if (!preferences) return;
+    if (!selectedAgent) {
+      setSelectedAgent(preferences.codingAgent);
+    }
+  }, [preferences, selectedAgent]);
+
+  useEffect(() => {
+    if (preferencesLoading) return;
+    if (!preferences) return;
+    if (!preferences.onboardingAcknowledged) {
+      setPreferencesDialogOpen(true);
+    }
+  }, [preferences, preferencesLoading]);
+
+  useEffect(() => {
+    if (selectedAgent) return;
+    const fromProject = projects.find((p) => p.id === selectedProjectId)?.agent;
+    if (fromProject) {
+      setSelectedAgent(fromProject);
+    }
+  }, [projects, selectedAgent, selectedProjectId]);
+
+  useEffect(() => {
+    if (agentOptions.length === 0) return;
+    if (!selectedAgent || !agentOptions.includes(selectedAgent)) {
+      const fallbackAgent = preferences?.codingAgent || "qwen-code";
+      setSelectedAgent(
+        agentOptions.includes(fallbackAgent)
+          ? fallbackAgent
+          : agentOptions[0] ?? "qwen-code",
+      );
+    }
+  }, [agentOptions, preferences?.codingAgent, selectedAgent]);
+
+  useEffect(() => {
+    const effectiveAgent = selectedAgent || selectedProject?.agent || preferences?.codingAgent || "qwen-code";
+    const preferredModel = selectedProject && normalizeAgentName(selectedProject.agent) === normalizeAgentName(effectiveAgent)
+      ? selectedProject.agentModel
+      : null;
+    const preferredReasoningEffort = selectedProject && normalizeAgentName(selectedProject.agent) === normalizeAgentName(effectiveAgent)
+      ? selectedProject.agentReasoningEffort
+      : null;
+
+    setLaunchModelSelection(
+      buildModelSelection(
+        effectiveAgent,
+        preferences?.modelAccess ?? normalizeModelAccessPreferences(null),
+        runtimeModelCatalogs,
+        preferredModel,
+        preferredReasoningEffort,
+      ),
+    );
+  }, [preferences?.modelAccess, preferences?.codingAgent, runtimeModelCatalogs, selectedAgent, selectedProject]);
+
+  async function handleSavePreferences(
+    next: PreferencesPayload,
+    options?: { closeDialog?: boolean },
+  ): Promise<boolean> {
+    setPreferencesSaving(true);
+    setPreferencesError(null);
+    try {
+      const res = await fetch("/api/preferences", {
+        method: "PUT",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(next),
+      });
+      const data = (await res.json().catch(() => null)) as
+        | { preferences?: unknown; error?: string }
+        | null;
+      if (!res.ok) {
+        throw new Error(data?.error ?? `Failed to save preferences: ${res.status}`);
+      }
+      const normalized = normalizePreferences(data?.preferences, next.codingAgent || "qwen-code");
+      setPreferences(normalized);
+      setSelectedAgent(normalized.codingAgent);
+      if (options?.closeDialog !== false) {
+        setPreferencesDialogOpen(false);
+      }
+      return true;
+    } catch (err) {
+      setPreferencesError(err instanceof Error ? err.message : "Failed to save preferences");
+      return false;
+    } finally {
+      setPreferencesSaving(false);
+    }
+  }
+
+  const toggleSidebar = useCallback(() => setSidebarOpen((prev) => !prev), []);
+
+  const closeSidebarOnMobile = useCallback(() => {
+    if (typeof window !== "undefined" && window.innerWidth < 1024) {
+      setSidebarOpen(false);
+    }
+  }, []);
+
+  const syncSidebarForViewport = useCallback(() => {
+    if (typeof window !== "undefined" && window.innerWidth < 1024) {
+      setSidebarOpen(false);
+      return;
+    }
+    setSidebarOpen(true);
+  }, []);
+
+  const openWorkspaceDialog = useCallback(() => {
+    setNewWorkspaceError(null);
+    setNewWorkspaceOpen(true);
+    syncSidebarForViewport();
+  }, [syncSidebarForViewport]);
+
+  useEffect(() => {
+    if (!pendingWorkspaceSetup || preferencesDialogOpen) return;
+    setPendingWorkspaceSetup(false);
+    openWorkspaceDialog();
+  }, [pendingWorkspaceSetup, preferencesDialogOpen]);
+
+  const handleCreateSession = useCallback(async (options?: CreateSessionOptions) => {
+    const trimmedPrompt = prompt.trim();
+    if (!trimmedPrompt) return;
+    const resolvedModel = resolveModelSelectionValue(launchModelSelection);
+    const resolvedReasoningEffort = resolveReasoningSelectionValue(launchModelSelection);
+
+    const projectId = options?.projectId ?? selectedProjectId ?? projects[0]?.id;
+    if (!projectId) {
+      setCreateError("No project is configured in conductor.yaml");
+      return;
+    }
+
+    const effectiveAgent = selectedAgent || "qwen-code";
+    const selectedAgentState = agentStatesByName[normalizeAgentName(effectiveAgent)] ?? null;
+    if (selectedAgentState && !selectedAgentState.ready) {
+      setCreateError(
+        selectedAgentState.installed
+          ? `${getAgentLabel(effectiveAgent)} is not ready yet. Finish setup or authentication and try again.`
+          : `${getAgentLabel(effectiveAgent)} is not installed on this machine yet. Open setup and try again.`,
+      );
+      openAgentSetup(effectiveAgent);
+      return;
+    }
+
+    setCreating(true);
+    setCreateError(null);
+
+    try {
+      const res = await fetch("/api/spawn", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          projectId,
+          prompt: trimmedPrompt,
+          ...(options?.issueId?.trim() ? { issueId: options.issueId.trim() } : {}),
+          agent: effectiveAgent,
+          ...(options?.branch ? { branch: options.branch } : {}),
+          ...(options?.baseBranch ? { baseBranch: options.baseBranch } : {}),
+          ...(typeof options?.useWorktree === "boolean" ? { useWorktree: options.useWorktree } : {}),
+          ...(options?.permissionMode ? { permissionMode: options.permissionMode } : {}),
+          ...(resolvedModel ? { model: resolvedModel } : {}),
+          ...(resolvedReasoningEffort ? { reasoningEffort: resolvedReasoningEffort } : {}),
+        }),
+      });
+
+      const data = (await res.json().catch(() => null)) as
+        | { session?: DashboardSession; error?: string }
+        | null;
+
+      if (!res.ok) {
+        throw new Error(data?.error ?? `Failed to create workspace: ${res.status}`);
+      }
+
+      if (!data?.session?.id) {
+        throw new Error("Session created but response is missing session id");
+      }
+
+      setPrompt("");
+      setWorkspaceView("chat");
+      syncSidebarForViewport();
+      await refreshSessions();
+      setSelectedSessionId(data.session.id);
+    } catch (err) {
+      setCreateError(err instanceof Error ? err.message : "Failed to create workspace");
+    } finally {
+      setCreating(false);
+    }
+  }, [
+    agentStatesByName,
+    launchModelSelection,
+    openAgentSetup,
+    projects,
+    prompt,
+    refreshSessions,
+    selectedAgent,
+    selectedProjectId,
+    syncSidebarForViewport,
+  ]);
+
+  const handleArchiveSession = useCallback(async (sessionId: string) => {
+    let res = await fetch(`/api/sessions/${encodeURIComponent(sessionId)}/archive`, {
+      method: "POST",
+    });
+    let data = (await res.json().catch(() => null)) as
+      | { ok?: boolean; error?: string }
+      | null;
+
+    if (res.status === 404) {
+      res = await fetch(`/api/sessions/${encodeURIComponent(sessionId)}/actions`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ action: "archive" }),
+      });
+      data = (await res.json().catch(() => null)) as
+        | { ok?: boolean; error?: string }
+        | null;
+    }
+
+    if (!res.ok) {
+      throw new Error(data?.error ?? `Failed to archive session: ${res.status}`);
+    }
+
+    if (selectedSessionId === sessionId) {
+      setSelectedSessionId(null);
+    }
+
+    await refreshSessions();
+  }, [refreshSessions, selectedSessionId]);
+
+  const handleCreateWorkspace = useCallback(async (payload: NewWorkspacePayload) => {
+    setCreatingWorkspace(true);
+    setNewWorkspaceError(null);
+
+    try {
+      const res = await fetch("/api/workspaces", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(payload),
+      });
+
+      const data = (await res.json().catch(() => null)) as
+        | { project?: { id?: string }; error?: string }
+        | null;
+
+      if (!res.ok) {
+        throw new Error(data?.error ?? `Failed to add workspace: ${res.status}`);
+      }
+
+      const createdProjectId = data?.project?.id;
+      if (!createdProjectId) {
+        throw new Error("Workspace created but response is missing project id");
+      }
+
+      await refreshConfig();
+      setSelectedProjectId(createdProjectId);
+      setSelectedSessionId(null);
+      setPrompt("");
+      syncSidebarForViewport();
+      setNewWorkspaceOpen(false);
+    } catch (err) {
+      setNewWorkspaceError(err instanceof Error ? err.message : "Failed to add workspace");
+    } finally {
+      setCreatingWorkspace(false);
+    }
+  }, [refreshConfig, syncSidebarForViewport]);
+
+  const onboardingRequired = !preferencesLoading && !!preferences && !preferences.onboardingAcknowledged;
+  const resolvedPreferences = preferences ?? normalizePreferences(null, selectedAgent || "qwen-code");
+  const resolvedCodingAgent = selectedAgent || resolvedPreferences.codingAgent || "qwen-code";
+
+  const handleSelectProject = useCallback((projectId: string | null) => {
+    setSelectedProjectId(projectId);
+    setSelectedSessionId(null);
+    closeSidebarOnMobile();
+  }, [closeSidebarOnMobile]);
+
+  const handleSelectSession = useCallback((id: string) => {
+    setSelectedSessionId(id);
+    closeSidebarOnMobile();
+  }, [closeSidebarOnMobile]);
+
+  const handleOpenPreferences = useCallback(() => {
+    setPreferencesDialogOpen(true);
+  }, []);
+
+  const handleCloseNewWorkspaceDialog = useCallback(() => {
+    if (creatingWorkspace) return;
+    setNewWorkspaceOpen(false);
+  }, [creatingWorkspace]);
+
+  const handleClosePreferencesDialog = useCallback(() => {
+    if (preferencesSaving || onboardingRequired) return;
+    setPreferencesDialogOpen(false);
+    setPreferencesError(null);
+  }, [onboardingRequired, preferencesSaving]);
+
+  const sidebarContent = useMemo(() => (
+    <WorkspaceSidebarPanel
+      orgLabel="conductor-oss"
+      projects={projects}
+      selectedProjectId={selectedProjectId}
+      onSelectProject={handleSelectProject}
+      sessions={dashboardSessions}
+      selectedSessionId={selectedSessionId}
+      onSelectSession={handleSelectSession}
+      onArchiveSession={handleArchiveSession}
+      onCreateWorkspace={openWorkspaceDialog}
+    />
+  ), [
+    dashboardSessions,
+    handleArchiveSession,
+    handleSelectProject,
+    handleSelectSession,
+    openWorkspaceDialog,
+    projects,
+    selectedProjectId,
+    selectedSessionId,
+  ]);
+
+  const workspaceContent = useMemo(() => {
+    if (selectedSessionId) {
+      return <SessionDetail sessionId={selectedSessionId} />;
+    }
+
+    return (
+      <div className="flex h-full min-h-0 flex-col">
+        <div className="border-b border-[var(--vk-border)] px-3 py-2">
+          <div className="inline-flex rounded-[3px] border border-[var(--vk-border)] p-px">
+            <button
+              type="button"
+              onClick={() => setWorkspaceView("chat")}
+              className={`min-h-[28px] rounded-[2px] px-3 text-[13px] ${
+                workspaceView === "chat"
+                  ? "bg-[var(--vk-bg-active)] text-[var(--vk-text-strong)]"
+                  : "text-[var(--vk-text-muted)] hover:bg-[var(--vk-bg-hover)]"
+              }`}
+            >
+              Chat
+            </button>
+            <button
+              type="button"
+              onClick={() => setWorkspaceView("board")}
+              className={`min-h-[28px] rounded-[2px] px-3 text-[13px] ${
+                workspaceView === "board"
+                  ? "bg-[var(--vk-bg-active)] text-[var(--vk-text-strong)]"
+                  : "text-[var(--vk-text-muted)] hover:bg-[var(--vk-bg-hover)]"
+              }`}
+            >
+              Board
+            </button>
+          </div>
+        </div>
+
+        <div className="min-h-0 flex-1 overflow-hidden">
+          {workspaceView === "board" ? (
+            <WorkspaceKanban
+              projectId={selectedProjectId}
+              defaultAgent={resolvedCodingAgent}
+              agentOptions={agentOptions}
+            />
+          ) : (
+            <CreateWorkspacePanel
+              prompt={prompt}
+              setPrompt={setPrompt}
+              selectedAgent={resolvedCodingAgent}
+              setSelectedAgent={setSelectedAgent}
+              agentStates={agentStatesByName}
+              modelSelection={launchModelSelection}
+              setModelSelection={setLaunchModelSelection}
+              modelAccess={resolvedPreferences.modelAccess}
+              runtimeModelCatalogs={runtimeModelCatalogs}
+              agentOptions={agentOptions}
+              projects={projects}
+              selectedProjectId={selectedProjectId}
+              onSelectProject={setSelectedProjectId}
+              projectLabel={selectedProjectId ?? "No project selected"}
+              hasProject={projects.length > 0}
+              creating={creating}
+              error={workspaceError}
+              onOpenAddWorkspace={openWorkspaceDialog}
+              onOpenAgentSetup={openAgentSetup}
+              onCreate={handleCreateSession}
+            />
+          )}
+        </div>
+      </div>
+    );
+  }, [
+    agentOptions,
+    agentStatesByName,
+    creating,
+    handleCreateSession,
+    launchModelSelection,
+    openAgentSetup,
+    openWorkspaceDialog,
+    preferences?.modelAccess,
+    projects,
+    prompt,
+    resolvedCodingAgent,
+    resolvedPreferences.modelAccess,
+    runtimeModelCatalogs,
+    selectedProjectId,
+    selectedSessionId,
+    workspaceError,
+    workspaceView,
+  ]);
+
+  return (
+    <>
+      <AppShell
+        sidebarOpen={sidebarOpen}
+        onToggleSidebar={toggleSidebar}
+        sidebar={sidebarContent}
+      >
+        <TopBar
+          session={selectedSession}
+          fallbackTitle={selectedProjectId ?? (workspaceView === "board" ? "Board" : "Create Workspace")}
+          onOpenPreferences={handleOpenPreferences}
+        />
+
+        <div className="min-h-0 flex-1 overflow-hidden">
+          {workspaceContent}
+        </div>
+      </AppShell>
+
+      {newWorkspaceOpen ? (
+        <NewWorkspaceDialog
+          open={newWorkspaceOpen}
+          onClose={handleCloseNewWorkspaceDialog}
+          onCreate={handleCreateWorkspace}
+          creating={creatingWorkspace}
+          error={newWorkspaceError}
+          defaultAgent={resolvedCodingAgent}
+          agentOptions={agentOptions}
+        />
+      ) : null}
+
+      {preferencesDialogOpen || onboardingRequired ? (
+        <SettingsDialog
+          open={preferencesDialogOpen}
+          mode={onboardingRequired ? "onboarding" : "settings"}
+          creating={preferencesSaving}
+          error={preferencesError}
+          current={resolvedPreferences}
+          projectCount={projects.length}
+          agentOptions={agentOptions}
+          runtimeModelCatalogs={runtimeModelCatalogs}
+          onRepositoriesChanged={refreshConfig}
+          onOnboardingComplete={({ needsProject }) => {
+            if (needsProject) {
+              setPendingWorkspaceSetup(true);
+            }
+          }}
+          onClose={handleClosePreferencesDialog}
+          onSave={handleSavePreferences}
+        />
+      ) : null}
+    </>
+  );
+}
+
+function NewWorkspaceDialog({
+  open,
+  onClose,
+  onCreate,
+  creating,
+  error,
+  defaultAgent,
+  agentOptions,
+}: {
+  open: boolean;
+  onClose: () => void;
+  onCreate: (payload: NewWorkspacePayload) => Promise<void>;
+  creating: boolean;
+  error: string | null;
+  defaultAgent: string;
+  agentOptions: string[];
+}) {
+  const [mode, setMode] = useState<"git" | "local">("git");
+  const [projectId, setProjectId] = useState("");
+  const [gitUrl, setGitUrl] = useState("");
+  const [path, setPath] = useState("");
+  const [defaultBranch, setDefaultBranch] = useState("main");
+  const [agent, setAgent] = useState(defaultAgent);
+  const [useWorktree, setUseWorktree] = useState(true);
+  const [initializeGit, setInitializeGit] = useState(true);
+  const [githubRepos, setGithubRepos] = useState<GitHubRepo[]>([]);
+  const [githubReposLoading, setGithubReposLoading] = useState(false);
+  const [githubReposError, setGithubReposError] = useState<string | null>(null);
+  const [githubRepoSearch, setGithubRepoSearch] = useState("");
+  const [selectedGithubRepo, setSelectedGithubRepo] = useState("");
+  const [folderPickerOpen, setFolderPickerOpen] = useState(false);
+  const [folderPickerTarget, setFolderPickerTarget] = useState<"clone" | "local">("local");
+  const [branchOptions, setBranchOptions] = useState<string[]>([]);
+  const [branchesLoading, setBranchesLoading] = useState(false);
+  const [branchesError, setBranchesError] = useState<string | null>(null);
+
+  useEffect(() => {
+    if (!open) return;
+    setMode("git");
+    setProjectId("");
+    setGitUrl("");
+    setPath("");
+    setDefaultBranch("main");
+    setInitializeGit(true);
+    setUseWorktree(true);
+    setAgent(defaultAgent);
+    setGithubRepos([]);
+    setGithubReposError(null);
+    setGithubRepoSearch("");
+    setSelectedGithubRepo("");
+    setBranchOptions([]);
+    setBranchesError(null);
+    setBranchesLoading(false);
+    setFolderPickerOpen(false);
+    setFolderPickerTarget("local");
+  }, [defaultAgent, open]);
+
+  useEffect(() => {
+    if (!open) return;
+    if (mode !== "local") return;
+    if (path.trim().length > 0) return;
+    setFolderPickerTarget("local");
+    setFolderPickerOpen(true);
+  }, [mode, open, path]);
+
+  const filteredGitHubRepos = useMemo(() => {
+    if (githubRepoSearch.trim().length === 0) return githubRepos;
+    const query = githubRepoSearch.trim().toLowerCase();
+    return githubRepos.filter((repo) => {
+      return repo.fullName.toLowerCase().includes(query)
+        || repo.name.toLowerCase().includes(query)
+        || repo.defaultBranch.toLowerCase().includes(query);
+    });
+  }, [githubRepoSearch, githubRepos]);
+
+  const orderedAgentOptions = useMemo(() => {
+    const opts = [...new Set(agentOptions)];
+    if (opts.length === 0) {
+      opts.push(defaultAgent || "qwen-code");
+    }
+
+    const rankMap = new Map(EXECUTOR_ORDER.map((name, index) => [name, index]));
+    return opts.sort((left, right) => {
+      const leftRank = rankMap.get(normalizeAgentName(left)) ?? Number.MAX_SAFE_INTEGER;
+      const rightRank = rankMap.get(normalizeAgentName(right)) ?? Number.MAX_SAFE_INTEGER;
+      if (leftRank !== rightRank) return leftRank - rightRank;
+      return getAgentLabel(left).localeCompare(getAgentLabel(right));
+    });
+  }, [agentOptions, defaultAgent]);
+
+  useEffect(() => {
+    if (!orderedAgentOptions.includes(agent)) {
+      setAgent(orderedAgentOptions[0] ?? "qwen-code");
+    }
+  }, [agent, orderedAgentOptions]);
+
+  const handleFetchGitHubRepos = async () => {
+    setGithubReposLoading(true);
+    setGithubReposError(null);
+    try {
+      const query = githubRepoSearch.trim();
+      const queryParam = query.length > 0 ? `?q=${encodeURIComponent(query)}` : "";
+      const res = await fetch(`/api/github/repos${queryParam}`);
+      const data = (await res.json().catch(() => null)) as
+        | { repos?: GitHubRepo[]; error?: string }
+        | null;
+      if (!res.ok) {
+        throw new Error(data?.error ?? `Failed to load GitHub repositories (${res.status})`);
+      }
+      setGithubRepos(Array.isArray(data?.repos) ? data.repos : []);
+    } catch (err) {
+      setGithubRepos([]);
+      setGithubReposError(
+        err instanceof Error ? err.message : "Failed to load GitHub repositories",
+      );
+    } finally {
+      setGithubReposLoading(false);
+    }
+  };
+
+  const handleDetectBranches = async (
+    sourceOverride?: { gitUrl?: string; path?: string },
+  ) => {
+    const effectiveGitUrl = sourceOverride?.gitUrl ?? (mode === "git" ? gitUrl.trim() : "");
+    const effectivePath = sourceOverride?.path ?? (mode === "local" ? path.trim() : "");
+
+    if (effectiveGitUrl.length === 0 && effectivePath.length === 0) {
+      setBranchesError(
+        mode === "git"
+          ? "Enter a Git URL first."
+          : "Select a local repository path first.",
+      );
+      return;
+    }
+
+    setBranchesLoading(true);
+    setBranchesError(null);
+    try {
+      const params = new URLSearchParams();
+      if (effectiveGitUrl.length > 0) {
+        params.set("gitUrl", effectiveGitUrl);
+      }
+      if (effectivePath.length > 0) {
+        params.set("path", effectivePath);
+      }
+
+      const res = await fetch(`/api/workspaces/branches?${params.toString()}`);
+      const data = (await res.json().catch(() => null)) as
+        | { branches?: string[]; defaultBranch?: string | null; error?: string }
+        | null;
+
+      if (!res.ok) {
+        throw new Error(data?.error ?? `Failed to load branches (${res.status})`);
+      }
+
+      const branches = Array.isArray(data?.branches)
+        ? data.branches.filter((branch) => typeof branch === "string" && branch.trim().length > 0)
+        : [];
+      setBranchOptions(branches);
+
+      const suggestedDefault = typeof data?.defaultBranch === "string" && data.defaultBranch.trim().length > 0
+        ? data.defaultBranch.trim()
+        : branches[0] ?? null;
+
+      if (suggestedDefault && (defaultBranch.trim().length === 0 || !branches.includes(defaultBranch))) {
+        setDefaultBranch(suggestedDefault);
+      }
+    } catch (err) {
+      setBranchOptions([]);
+      setBranchesError(err instanceof Error ? err.message : "Failed to load branches");
+    } finally {
+      setBranchesLoading(false);
+    }
+  };
+
+  const handleSelectGitHubRepo = async (httpsUrl: string) => {
+    setSelectedGithubRepo(httpsUrl);
+    const selected = githubRepos.find((repo) => repo.httpsUrl === httpsUrl);
+    if (!selected) return;
+
+    setGitUrl(selected.httpsUrl);
+    setDefaultBranch(selected.defaultBranch || "main");
+    if (projectId.trim().length === 0) {
+      const suggestedProjectId = selected.name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 64);
+      setProjectId(suggestedProjectId || projectId);
+    }
+
+    await handleDetectBranches({ gitUrl: selected.httpsUrl });
+  };
+
+  const openFolderPicker = (target: "clone" | "local") => {
+    setFolderPickerTarget(target);
+    setFolderPickerOpen(true);
+  };
+
+  if (!open) return null;
+
+  const canSubmit = mode === "git"
+    ? gitUrl.trim().length > 0 && defaultBranch.trim().length > 0
+    : path.trim().length > 0 && defaultBranch.trim().length > 0;
+
+  async function handleSubmit(event: FormEvent<HTMLFormElement>) {
+    event.preventDefault();
+    if (!canSubmit || creating) return;
+
+    const payload: NewWorkspacePayload =
+      mode === "git"
+        ? {
+            mode,
+            projectId: projectId.trim() || undefined,
+            agent,
+            defaultBranch: defaultBranch.trim(),
+            useWorktree,
+            gitUrl: gitUrl.trim(),
+            path: path.trim() || undefined,
+          }
+        : {
+            mode,
+            projectId: projectId.trim() || undefined,
+            agent,
+            defaultBranch: defaultBranch.trim(),
+            useWorktree,
+            path: path.trim(),
+            initializeGit,
+          };
+
+    await onCreate(payload);
+  }
+
+  return (
+    <>
+      <div
+        className="fixed inset-0 z-[80] flex items-start justify-center overflow-y-auto bg-black/65 px-3 py-3 sm:items-center sm:py-0"
+        onClick={() => {
+          if (creating || folderPickerOpen) return;
+          onClose();
+        }}
+        role="presentation"
+      >
+        <form
+          onSubmit={handleSubmit}
+          onClick={(event) => event.stopPropagation()}
+          className="flex max-h-[calc(100dvh-1.5rem)] w-full max-w-[760px] flex-col overflow-hidden rounded-[6px] border border-[var(--vk-border)] bg-[var(--vk-bg-panel)] shadow-[0_24px_80px_rgba(0,0,0,0.55)]"
+        >
+          <header className="flex items-center border-b border-[var(--vk-border)] px-4 py-3">
+            <div>
+              <h2 className="text-[18px] leading-[22px] text-[var(--vk-text-strong)]">Add Workspace</h2>
+              <p className="pt-1 text-[12px] text-[var(--vk-text-muted)]">
+                Select a repository with a folder picker, then choose the target branch.
+              </p>
+            </div>
+            <button
+              type="button"
+              onClick={onClose}
+              disabled={creating}
+              aria-label="Close dialog"
+              className="ml-auto inline-flex h-8 w-8 items-center justify-center rounded-[4px] text-[var(--vk-text-muted)] hover:bg-[var(--vk-bg-hover)] disabled:opacity-50"
+            >
+              <X className="h-4 w-4" />
+            </button>
+          </header>
+
+          <div className="min-h-0 flex-1 space-y-4 overflow-y-auto px-4 py-4">
+            <div className="inline-flex rounded-[4px] border border-[var(--vk-border)] p-1">
+              <button
+                type="button"
+                onClick={() => setMode("git")}
+                className={`rounded-[3px] px-3 py-1.5 text-[13px] ${
+                  mode === "git"
+                    ? "bg-[var(--vk-bg-active)] text-[var(--vk-text-strong)]"
+                    : "text-[var(--vk-text-muted)] hover:bg-[var(--vk-bg-hover)]"
+                }`}
+              >
+                Git Repository
+              </button>
+              <button
+                type="button"
+                onClick={() => setMode("local")}
+                className={`rounded-[3px] px-3 py-1.5 text-[13px] ${
+                  mode === "local"
+                    ? "bg-[var(--vk-bg-active)] text-[var(--vk-text-strong)]"
+                    : "text-[var(--vk-text-muted)] hover:bg-[var(--vk-bg-hover)]"
+                }`}
+              >
+                Local Folder
+              </button>
+            </div>
+
+            <label className="block">
+              <span className="mb-1.5 block text-[12px] text-[var(--vk-text-muted)]">Project ID (optional)</span>
+              <input
+                value={projectId}
+                onChange={(event) => setProjectId(event.target.value)}
+                placeholder="auto-derived from repo/folder"
+                className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 text-[14px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+              />
+            </label>
+
+            {mode === "git" ? (
+              <>
+                <div className="rounded-[4px] border border-[var(--vk-border)] p-3">
+                  <div className="flex items-center gap-2">
+                    <Github className="h-4 w-4 text-[var(--vk-text-muted)]" />
+                    <span className="text-[12px] font-medium text-[var(--vk-text-normal)]">GitHub Integration</span>
+                  </div>
+                  <div className="mt-2 flex flex-wrap items-center gap-2">
+                    <button
+                      type="button"
+                      onClick={handleFetchGitHubRepos}
+                      disabled={githubReposLoading}
+                      className="inline-flex h-8 items-center rounded-[4px] border border-[var(--vk-border)] px-2 text-[12px] text-[var(--vk-text-normal)] hover:bg-[var(--vk-bg-hover)] disabled:opacity-50"
+                    >
+                      {githubReposLoading ? (
+                        <>
+                          <Loader2 className="mr-1.5 h-3.5 w-3.5 animate-spin" />
+                          Loading repos...
+                        </>
+                      ) : "Load My GitHub Repositories"}
+                    </button>
+                    <div className="relative min-w-[220px] flex-1">
+                      <Search className="pointer-events-none absolute left-2 top-1/2 h-3.5 w-3.5 -translate-y-1/2 text-[var(--vk-text-muted)]" />
+                      <input
+                        value={githubRepoSearch}
+                        onChange={(event) => setGithubRepoSearch(event.target.value)}
+                        placeholder="Filter repos..."
+                        className="h-8 w-full rounded-[4px] border border-[var(--vk-border)] bg-transparent pl-7 pr-2 text-[12px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+                      />
+                    </div>
+                  </div>
+                  {filteredGitHubRepos.length > 0 && (
+                    <label className="mt-2 block">
+                      <span className="mb-1 block text-[11px] text-[var(--vk-text-muted)]">Choose repository</span>
+                      <select
+                        value={selectedGithubRepo}
+                        onChange={(event) => {
+                          void handleSelectGitHubRepo(event.target.value);
+                        }}
+                        className="h-8 w-full rounded-[4px] border border-[var(--vk-border)] bg-[var(--vk-bg-panel)] px-2 text-[12px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+                      >
+                        <option value="">Select a GitHub repo...</option>
+                        {filteredGitHubRepos.map((repo) => (
+                          <option key={repo.httpsUrl} value={repo.httpsUrl}>
+                            {repo.fullName} ({repo.defaultBranch})
+                          </option>
+                        ))}
+                      </select>
+                    </label>
+                  )}
+                  {githubReposError && (
+                    <p className="mt-2 text-[11px] text-[var(--vk-red)]">{githubReposError}</p>
+                  )}
+                </div>
+
+                <label className="block">
+                  <span className="mb-1.5 block text-[12px] text-[var(--vk-text-muted)]">Git URL</span>
+                  <input
+                    value={gitUrl}
+                    onChange={(event) => setGitUrl(event.target.value)}
+                    placeholder="https://github.com/org/repo.git"
+                    className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 text-[14px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+                  />
+                </label>
+
+                <label className="block">
+                  <span className="mb-1.5 block text-[12px] text-[var(--vk-text-muted)]">
+                    Local Path (optional, clone target)
+                  </span>
+                  <div className="flex items-center gap-2">
+                    <input
+                      value={path}
+                      readOnly
+                      onClick={() => openFolderPicker("clone")}
+                      placeholder="Use Browse to choose a clone target folder"
+                      className="h-9 w-full cursor-pointer rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 text-[14px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+                    />
+                    <button
+                      type="button"
+                      onClick={() => openFolderPicker("clone")}
+                      className="inline-flex h-9 items-center rounded-[4px] border border-[var(--vk-border)] px-2 text-[12px] text-[var(--vk-text-normal)] hover:bg-[var(--vk-bg-hover)]"
+                      title="Browse folders"
+                    >
+                      <FolderOpen className="h-4 w-4" />
+                    </button>
+                  </div>
+                </label>
+              </>
+            ) : (
+              <>
+                <label className="block">
+                  <span className="mb-1.5 block text-[12px] text-[var(--vk-text-muted)]">Local Path</span>
+                  <div className="flex items-center gap-2">
+                    <input
+                      value={path}
+                      readOnly
+                      onClick={() => openFolderPicker("local")}
+                      placeholder="Use Browse to select a repository folder"
+                      className="h-9 w-full cursor-pointer rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 text-[14px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+                    />
+                    <button
+                      type="button"
+                      onClick={() => openFolderPicker("local")}
+                      className="inline-flex h-9 items-center rounded-[4px] border border-[var(--vk-border)] px-2 text-[12px] text-[var(--vk-text-normal)] hover:bg-[var(--vk-bg-hover)]"
+                      title="Browse folders"
+                    >
+                      <FolderOpen className="h-4 w-4" />
+                    </button>
+                  </div>
+                </label>
+                <label className="flex items-center gap-2 text-[13px] text-[var(--vk-text-normal)]">
+                  <input
+                    type="checkbox"
+                    checked={initializeGit}
+                    onChange={(event) => setInitializeGit(event.target.checked)}
+                    className="h-4 w-4 rounded border border-[var(--vk-border)] bg-transparent accent-[var(--vk-orange)]"
+                  />
+                  <span>Initialize git if this folder is non-git</span>
+                </label>
+              </>
+            )}
+
+            <div className="grid grid-cols-1 gap-3 md:grid-cols-2">
+              <label className="block">
+                <span className="mb-1.5 block text-[12px] text-[var(--vk-text-muted)]">Default Branch</span>
+                <div className="flex items-center gap-2">
+                  <input
+                    value={defaultBranch}
+                    onChange={(event) => setDefaultBranch(event.target.value)}
+                    placeholder="main"
+                    className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 text-[14px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+                  />
+                  <button
+                    type="button"
+                    onClick={() => {
+                      void handleDetectBranches();
+                    }}
+                    disabled={branchesLoading}
+                    className="inline-flex h-9 items-center rounded-[4px] border border-[var(--vk-border)] px-2 text-[12px] text-[var(--vk-text-normal)] hover:bg-[var(--vk-bg-hover)] disabled:opacity-50"
+                    title="Detect branches"
+                  >
+                    {branchesLoading ? (
+                      <Loader2 className="h-3.5 w-3.5 animate-spin" />
+                    ) : (
+                      <RefreshCcw className="h-3.5 w-3.5" />
+                    )}
+                  </button>
+                </div>
+                {branchOptions.length > 0 && (
+                  <select
+                    value={defaultBranch}
+                    onChange={(event) => setDefaultBranch(event.target.value)}
+                    className="mt-2 h-8 w-full rounded-[4px] border border-[var(--vk-border)] bg-[var(--vk-bg-panel)] px-2 text-[12px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+                  >
+                    {branchOptions.map((branch) => (
+                      <option key={branch} value={branch}>
+                        {branch}
+                      </option>
+                    ))}
+                  </select>
+                )}
+                {branchesError && (
+                  <p className="mt-1 text-[11px] text-[var(--vk-red)]">{branchesError}</p>
+                )}
+              </label>
+
+              <label className="block">
+                <span className="mb-1.5 block text-[12px] text-[var(--vk-text-muted)]">Agent</span>
+                <select
+                  value={agent}
+                  onChange={(event) => setAgent(event.target.value)}
+                  className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-[var(--vk-bg-panel)] px-2 text-[14px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+                >
+                  {orderedAgentOptions.map((item) => (
+                    <option key={item} value={item} className="bg-[var(--vk-bg-panel)] text-[var(--vk-text-normal)]">
+                      {getAgentLabel(item)}
+                    </option>
+                  ))}
+                </select>
+              </label>
+            </div>
+
+            <label className="flex items-start gap-2 rounded-[4px] border border-[var(--vk-border)] px-2 py-2 text-[13px] text-[var(--vk-text-normal)]">
+              <input
+                type="checkbox"
+                checked={useWorktree}
+                onChange={(event) => setUseWorktree(event.target.checked)}
+                className="mt-0.5 h-4 w-4 rounded border border-[var(--vk-border)] bg-transparent accent-[var(--vk-orange)]"
+              />
+              <span>
+                Use worktree isolation
+                <span className="block text-[11px] text-[var(--vk-text-muted)]">
+                  If unchecked, sessions run directly on the selected branch in the local repo.
+                </span>
+              </span>
+            </label>
+
+            {error && <p className="text-[12px] text-[var(--vk-red)]">{error}</p>}
+          </div>
+
+          <footer className="flex flex-wrap items-center justify-end gap-2 border-t border-[var(--vk-border)] px-4 py-3">
+            <button
+              type="button"
+              onClick={onClose}
+              disabled={creating}
+              className="inline-flex h-9 items-center rounded-[4px] border border-[var(--vk-border)] px-3 text-[13px] text-[var(--vk-text-normal)] hover:bg-[var(--vk-bg-hover)] disabled:opacity-50"
+            >
+              Cancel
+            </button>
+            <button
+              type="submit"
+              disabled={!canSubmit || creating}
+              className="inline-flex h-9 items-center rounded-[4px] bg-[var(--vk-bg-active)] px-3 text-[13px] text-[var(--vk-text-strong)] hover:bg-[var(--vk-bg-hover)] disabled:opacity-50"
+            >
+              {creating ? (
+                <>
+                  <Loader2 className="mr-1.5 h-3.5 w-3.5 animate-spin" />
+                  Adding...
+                </>
+              ) : "Add Workspace"}
+              </button>
+            </footer>
+        </form>
+      </div>
+
+      <FolderPickerDialog
+        open={folderPickerOpen}
+        initialPath={path}
+        title={folderPickerTarget === "local" ? "Select Local Repository" : "Select Clone Target Folder"}
+        description={folderPickerTarget === "local"
+          ? "Choose the local repository folder."
+          : "Choose where the git repository should be cloned."}
+        onClose={() => setFolderPickerOpen(false)}
+        onSelect={(selectedPath) => {
+          setFolderPickerOpen(false);
+          if (!selectedPath) return;
+          setPath(selectedPath);
+          if (mode === "local" || folderPickerTarget === "local") {
+            void handleDetectBranches({ path: selectedPath });
+          }
+        }}
+      />
+    </>
+  );
+}
+
+function FolderPickerDialog({
+  open,
+  initialPath,
+  title,
+  description,
+  onClose,
+  onSelect,
+}: {
+  open: boolean;
+  initialPath?: string;
+  title: string;
+  description: string;
+  onClose: () => void;
+  onSelect: (path: string | null) => void;
+}) {
+  const [currentPath, setCurrentPath] = useState("");
+  const [manualPath, setManualPath] = useState(initialPath ?? "");
+  const [entries, setEntries] = useState<DirectoryEntry[]>([]);
+  const [search, setSearch] = useState("");
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    if (!open) return;
+    setSearch("");
+    setManualPath(initialPath ?? "");
+    const targetPath = initialPath && initialPath.trim().length > 0 ? initialPath.trim() : undefined;
+    const query = targetPath ? `?path=${encodeURIComponent(targetPath)}` : "";
+    setLoading(true);
+    setError(null);
+    fetch(`/api/filesystem/directory${query}`)
+      .then(async (res) => {
+        const data = (await res.json().catch(() => null)) as
+          | { currentPath?: string; entries?: DirectoryEntry[]; error?: string }
+          | null;
+        if (!res.ok) {
+          throw new Error(data?.error ?? `Failed to load directory (${res.status})`);
+        }
+        setCurrentPath(typeof data?.currentPath === "string" ? data.currentPath : "");
+        setEntries(Array.isArray(data?.entries) ? data.entries : []);
+      })
+      .catch((err) => {
+        setError(err instanceof Error ? err.message : "Failed to load directory");
+        setEntries([]);
+      })
+      .finally(() => {
+        setLoading(false);
+      });
+  }, [initialPath, open]);
+
+  const filteredEntries = useMemo(() => {
+    if (search.trim().length === 0) return entries;
+    const query = search.trim().toLowerCase();
+    return entries.filter((entry) => entry.name.toLowerCase().includes(query));
+  }, [entries, search]);
+
+  const loadDirectory = async (path?: string) => {
+    setLoading(true);
+    setError(null);
+    try {
+      const query = path && path.trim().length > 0
+        ? `?path=${encodeURIComponent(path.trim())}`
+        : "";
+      const res = await fetch(`/api/filesystem/directory${query}`);
+      const data = (await res.json().catch(() => null)) as
+        | { currentPath?: string; entries?: DirectoryEntry[]; error?: string }
+        | null;
+      if (!res.ok) {
+        throw new Error(data?.error ?? `Failed to load directory (${res.status})`);
+      }
+      const nextPath = typeof data?.currentPath === "string" ? data.currentPath : "";
+      setCurrentPath(nextPath);
+      setEntries(Array.isArray(data?.entries) ? data.entries : []);
+      setManualPath(nextPath);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : "Failed to load directory");
+      setEntries([]);
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  const handleGoParent = () => {
+    if (!currentPath) return;
+    const normalized = currentPath.replace(/\\/g, "/");
+    if (normalized === "/") return;
+    const parts = normalized.split("/").filter(Boolean);
+    const parent = parts.length > 1 ? `/${parts.slice(0, -1).join("/")}` : "/";
+    void loadDirectory(parent);
+  };
+
+  if (!open) return null;
+
+  return (
+    <div
+      className="fixed inset-0 z-[95] flex items-start justify-center overflow-y-auto bg-black/70 px-3 py-3 sm:items-center sm:py-0"
+      onClick={() => {
+        onClose();
+        onSelect(null);
+      }}
+      role="presentation"
+    >
+      <div
+        className="flex max-h-[calc(100dvh-1.5rem)] w-full max-w-[760px] flex-col overflow-hidden rounded-[6px] border border-[var(--vk-border)] bg-[var(--vk-bg-panel)] shadow-[0_24px_80px_rgba(0,0,0,0.55)]"
+        onClick={(event) => event.stopPropagation()}
+      >
+        <header className="border-b border-[var(--vk-border)] px-4 py-3">
+          <h3 className="text-[16px] text-[var(--vk-text-strong)]">{title}</h3>
+          <p className="pt-1 text-[12px] text-[var(--vk-text-muted)]">{description}</p>
+        </header>
+
+        <div className="flex min-h-0 flex-1 flex-col gap-3 px-4 py-3">
+          <div className="flex flex-wrap items-center gap-2">
+            <input
+              value={manualPath}
+              onChange={(event) => setManualPath(event.target.value)}
+              placeholder="/path/to/repository"
+              className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 text-[13px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+            />
+            <button
+              type="button"
+              onClick={() => {
+                void loadDirectory(manualPath);
+              }}
+              className="inline-flex h-9 items-center rounded-[4px] border border-[var(--vk-border)] px-2 text-[12px] text-[var(--vk-text-normal)] hover:bg-[var(--vk-bg-hover)]"
+            >
+              Open
+            </button>
+          </div>
+
+          <div className="flex flex-wrap items-center gap-2">
+            <button
+              type="button"
+              onClick={() => {
+                void loadDirectory();
+              }}
+              className="inline-flex h-8 items-center rounded-[4px] border border-[var(--vk-border)] px-2 text-[12px] text-[var(--vk-text-normal)] hover:bg-[var(--vk-bg-hover)]"
+            >
+              Home
+            </button>
+            <button
+              type="button"
+              onClick={handleGoParent}
+              className="inline-flex h-8 items-center rounded-[4px] border border-[var(--vk-border)] px-2 text-[12px] text-[var(--vk-text-normal)] hover:bg-[var(--vk-bg-hover)]"
+            >
+              Up
+            </button>
+            <div className="truncate text-[12px] text-[var(--vk-text-muted)]">{currentPath || "Home"}</div>
+          </div>
+
+          <div className="relative">
+            <Search className="pointer-events-none absolute left-2 top-1/2 h-3.5 w-3.5 -translate-y-1/2 text-[var(--vk-text-muted)]" />
+            <input
+              value={search}
+              onChange={(event) => setSearch(event.target.value)}
+              placeholder="Filter folders"
+              className="h-8 w-full rounded-[4px] border border-[var(--vk-border)] bg-transparent pl-7 pr-2 text-[12px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+            />
+          </div>
+
+          <div className="min-h-0 flex-1 overflow-auto rounded-[4px] border border-[var(--vk-border)]">
+            {loading ? (
+              <div className="px-3 py-3 text-[12px] text-[var(--vk-text-muted)]">Loading...</div>
+            ) : error ? (
+              <div className="px-3 py-3 text-[12px] text-[var(--vk-red)]">{error}</div>
+            ) : filteredEntries.length === 0 ? (
+              <div className="px-3 py-3 text-[12px] text-[var(--vk-text-muted)]">No folders found.</div>
+            ) : (
+              <div className="p-1">
+                {filteredEntries.map((entry) => (
+                  <button
+                    key={entry.path}
+                    type="button"
+                    onClick={() => {
+                      if (!entry.isDirectory) return;
+                      void loadDirectory(entry.path);
+                    }}
+                    className={`mb-1 flex w-full items-center gap-2 rounded-[4px] px-2 py-2 text-left text-[12px] ${
+                      entry.isDirectory
+                        ? "text-[var(--vk-text-normal)] hover:bg-[var(--vk-bg-hover)]"
+                        : "cursor-default text-[var(--vk-text-muted)]"
+                    }`}
+                  >
+                    <FolderOpen className="h-4 w-4 shrink-0" />
+                    <span className="truncate">{entry.name}</span>
+                    {entry.isGitRepo && (
+                      <span className="ml-auto rounded-[999px] border border-[var(--vk-border)] px-1.5 py-0.5 text-[10px]">
+                        git
+                      </span>
+                    )}
+                  </button>
+                ))}
+              </div>
+            )}
+          </div>
+        </div>
+
+        <footer className="flex items-center justify-end gap-2 border-t border-[var(--vk-border)] px-4 py-3">
+          <button
+            type="button"
+            onClick={() => {
+              onClose();
+              onSelect(null);
+            }}
+            className="inline-flex h-9 items-center rounded-[4px] border border-[var(--vk-border)] px-3 text-[13px] text-[var(--vk-text-normal)] hover:bg-[var(--vk-bg-hover)]"
+          >
+            Cancel
+          </button>
+          <button
+            type="button"
+            onClick={() => {
+              const selectedPath = manualPath.trim().length > 0 ? manualPath.trim() : currentPath;
+              onClose();
+              onSelect(selectedPath || null);
+            }}
+            className="inline-flex h-9 items-center rounded-[4px] bg-[var(--vk-bg-active)] px-3 text-[13px] text-[var(--vk-text-strong)] hover:bg-[var(--vk-bg-hover)]"
+          >
+            Use this folder
+          </button>
+        </footer>
+      </div>
+    </div>
+  );
+}
+
+const CreateWorkspacePanel = memo(function CreateWorkspacePanel({
+  prompt,
+  setPrompt,
+  selectedAgent,
+  setSelectedAgent,
+  agentStates,
+  modelSelection,
+  setModelSelection,
+  modelAccess,
+  runtimeModelCatalogs,
+  agentOptions,
+  projects,
+  selectedProjectId,
+  onSelectProject,
+  projectLabel,
+  hasProject,
+  creating,
+  error,
+  onOpenAddWorkspace,
+  onOpenAgentSetup,
+  onCreate,
+}: {
+  prompt: string;
+  setPrompt: (value: string) => void;
+  selectedAgent: string;
+  setSelectedAgent: (value: string) => void;
+  agentStates: Record<string, AgentSetupState>;
+  modelSelection: ModelSelectionState;
+  setModelSelection: (next: ModelSelectionState) => void;
+  modelAccess: ModelAccessPreferences;
+  runtimeModelCatalogs: Record<string, RuntimeAgentModelCatalog>;
+  agentOptions: string[];
+  projects: ConfigProject[];
+  selectedProjectId: string | null;
+  onSelectProject: (projectId: string | null) => void;
+  projectLabel: string;
+  hasProject: boolean;
+  creating: boolean;
+  error: string | null;
+  onOpenAddWorkspace: () => void;
+  onOpenAgentSetup: (agent: string) => void;
+  onCreate: (options?: CreateSessionOptions) => void;
+}) {
+  const orderedAgentOptions = useMemo(() => {
+    const rankMap = new Map(EXECUTOR_ORDER.map((name, index) => [name, index]));
+    return [...agentOptions].sort((left, right) => {
+      const leftRank = rankMap.get(normalizeAgentName(left)) ?? Number.MAX_SAFE_INTEGER;
+      const rightRank = rankMap.get(normalizeAgentName(right)) ?? Number.MAX_SAFE_INTEGER;
+      if (leftRank !== rightRank) return leftRank - rightRank;
+      return getAgentLabel(left).localeCompare(getAgentLabel(right));
+    });
+  }, [agentOptions]);
+
+  const selectedAgentLabel = getAgentLabel(selectedAgent);
+  const selectedAgentState = agentStates[normalizeAgentName(selectedAgent)] ?? null;
+  const projectOptions = useMemo(
+    () => [...projects].sort((left, right) => left.id.localeCompare(right.id)),
+    [projects],
+  );
+  const effectiveProjectId = selectedProjectId ?? projectOptions[0]?.id ?? null;
+  const selectedProject = useMemo(
+    () => projectOptions.find((project) => project.id === effectiveProjectId) ?? null,
+    [effectiveProjectId, projectOptions],
+  );
+  const [branchOptions, setBranchOptions] = useState<string[]>([]);
+  const [branchLoading, setBranchLoading] = useState(false);
+  const [selectedBranch, setSelectedBranch] = useState("");
+  const [issueId, setIssueId] = useState("");
+  const [availableTasks, setAvailableTasks] = useState<LinkedBoardTask[]>([]);
+  const [taskLoading, setTaskLoading] = useState(false);
+  const [useWorktree, setUseWorktree] = useState(true);
+  const [permissionMode, setPermissionMode] = useState<CreatePermissionMode>("default");
+
+  useEffect(() => {
+    if (!selectedProject) {
+      setBranchOptions([]);
+      setSelectedBranch("");
+      return;
+    }
+
+    let cancelled = false;
+    const project = selectedProject;
+    const fallbackBranch = project.defaultBranch.trim() || "main";
+
+    async function loadBranches() {
+      if (!project.path?.trim()) {
+        setBranchOptions([fallbackBranch]);
+        setSelectedBranch(fallbackBranch);
+        return;
+      }
+
+      setBranchLoading(true);
+      try {
+        const params = new URLSearchParams({ path: project.path });
+        const res = await fetch(`/api/workspaces/branches?${params.toString()}`);
+        const data = (await res.json().catch(() => null)) as
+          | { branches?: string[]; defaultBranch?: string | null }
+          | null;
+
+        const branches = Array.isArray(data?.branches)
+          ? data.branches.filter((branch) => typeof branch === "string" && branch.trim().length > 0)
+          : [];
+        const resolvedDefault = typeof data?.defaultBranch === "string" && data.defaultBranch.trim().length > 0
+          ? data.defaultBranch.trim()
+          : fallbackBranch;
+        const nextBranches = branches.length > 0 ? branches : [resolvedDefault];
+
+        if (cancelled) return;
+        setBranchOptions(nextBranches);
+        setSelectedBranch((current) => current.trim().length > 0 && nextBranches.includes(current) ? current : resolvedDefault);
+      } catch {
+        if (cancelled) return;
+        setBranchOptions([fallbackBranch]);
+        setSelectedBranch(fallbackBranch);
+      } finally {
+        if (!cancelled) {
+          setBranchLoading(false);
+        }
+      }
+    }
+
+    void loadBranches();
+    return () => {
+      cancelled = true;
+    };
+  }, [selectedProject]);
+
+  useEffect(() => {
+    if (!effectiveProjectId) {
+      setAvailableTasks([]);
+      setIssueId("");
+      return;
+    }
+
+    let cancelled = false;
+
+    async function loadTasks() {
+      setTaskLoading(true);
+      try {
+        const res = await fetch(`/api/boards?projectId=${encodeURIComponent(effectiveProjectId)}`);
+        const payload = (await res.json().catch(() => null)) as LinkedBoardResponse | { error?: string } | null;
+        if (!res.ok) {
+          throw new Error((payload as { error?: string } | null)?.error ?? `Failed to load tasks: ${res.status}`);
+        }
+
+        const boardPayload = payload as LinkedBoardResponse | null;
+        const columns = Array.isArray(boardPayload?.columns) ? boardPayload.columns : [];
+        const nextTasks = columns.flatMap((column: { tasks?: LinkedBoardTask[] }) =>
+          Array.isArray(column.tasks) ? column.tasks : [],
+        );
+        const seen = new Set<string>();
+        const deduped = nextTasks.filter((task: LinkedBoardTask) => {
+          const key = getLinkedTaskValue(task);
+          if (!key || seen.has(key)) return false;
+          seen.add(key);
+          return true;
+        });
+
+        if (cancelled) return;
+        setAvailableTasks(deduped);
+        setIssueId((current) => deduped.some((task: LinkedBoardTask) => getLinkedTaskValue(task) === current) ? current : "");
+      } catch {
+        if (cancelled) return;
+        setAvailableTasks([]);
+        setIssueId("");
+      } finally {
+        if (!cancelled) {
+          setTaskLoading(false);
+        }
+      }
+    }
+
+    void loadTasks();
+    return () => {
+      cancelled = true;
+    };
+  }, [effectiveProjectId]);
+
+  const availableModels = useMemo(
+    () => getSelectableAgentModels(selectedAgent, modelAccess, runtimeModelCatalogs),
+    [modelAccess, runtimeModelCatalogs, selectedAgent],
+  );
+  const selectedTask = useMemo(
+    () => availableTasks.find((task) => getLinkedTaskValue(task) === issueId) ?? null,
+    [availableTasks, issueId],
+  );
+  const selectedModelValue = resolveModelSelectionValue(modelSelection) ?? "";
+  const modelMenuOptions = useMemo(() => {
+    const seen = new Set<string>();
+    const merged: AgentModelOption[] = [];
+    const currentModel = selectedModelValue.trim();
+
+    for (const option of availableModels) {
+      if (seen.has(option.id)) continue;
+      seen.add(option.id);
+      merged.push(option);
+    }
+
+    if (currentModel && !seen.has(currentModel)) {
+      seen.add(currentModel);
+      merged.unshift({
+        id: currentModel,
+        label: formatCurrentModelLabel(selectedAgent, currentModel),
+        description: "Current selected model.",
+        access: [],
+      });
+    }
+
+    return merged;
+  }, [availableModels, selectedAgent, selectedModelValue]);
+  const selectedModelLabel = useMemo(() => {
+    if (selectedAgentState && !selectedAgentState.ready && !selectedModelValue) return "Setup required";
+    if (!selectedModelValue) return "Default";
+    return modelMenuOptions.find((option) => option.id === selectedModelValue)?.label ?? selectedModelValue;
+  }, [modelMenuOptions, selectedAgentState, selectedModelValue]);
+  const lightMenuClass = "z-50 min-w-[240px] rounded-[4px] border border-[var(--vk-border)] bg-[var(--vk-bg-panel)] p-2 shadow-[0_18px_50px_rgba(0,0,0,0.35)]";
+  const scrollMenuClass = `${lightMenuClass} max-h-[min(360px,50vh)] overflow-y-auto`;
+  const lightMenuItemClass = "flex min-h-[36px] cursor-default items-center gap-2 rounded-[3px] px-3 py-2 text-[14px] leading-[21px] text-[var(--vk-text-normal)] outline-none hover:bg-[var(--vk-bg-hover)] focus:bg-[var(--vk-bg-hover)]";
+  const permissionOptions: Array<{ id: CreatePermissionMode; label: string; icon: LucideIcon }> = [
+    { id: "default", label: "Default", icon: SlidersHorizontal },
+    { id: "auto", label: "Auto", icon: ChevronsRight },
+    { id: "ask", label: "Ask", icon: Hand },
+    { id: "plan", label: "Plan", icon: List },
+  ];
+  const selectedPermission = permissionOptions.find((option) => option.id === permissionMode) ?? permissionOptions[0];
+  const getProjectDisplayName = (project: ConfigProject): string => {
+    const repo = project.repo?.trim();
+    if (repo) {
+      const parts = repo.split("/").filter(Boolean);
+      const label = parts[parts.length - 1]?.replace(/\.git$/i, "");
+      if (label) return label;
+    }
+    return project.id;
+  };
+  const selectedProjectLabel = selectedProject ? getProjectDisplayName(selectedProject) : null;
+  const currentProjectLabel = selectedProject
+    ? `${selectedProjectLabel} · ${selectedBranch || selectedProject.defaultBranch || "main"}`
+    : hasProject
+      ? projectLabel
+      : "Select project";
+  const selectedTaskLabel = selectedTask?.taskRef?.trim() || "Link task";
+  const selectedTaskSubtitle = selectedTask ? getLinkedTaskTitle(selectedTask.text) : "Choose a task, bug, or issue from this project's board";
+
+  return (
+    <section className="flex h-full min-h-0 items-start justify-center overflow-auto bg-[var(--vk-bg-main)] px-3 py-4 sm:items-center sm:px-6 sm:py-6">
+      <div className="w-full max-w-[768px]">
+        <h1 className="pb-4 text-center text-[30px] font-medium leading-[34px] tracking-[-0.7px] text-[var(--vk-text-strong)] sm:text-[36px] sm:leading-[40px] sm:tracking-[-0.9px]">
+          What would you like to work on?
+        </h1>
+
+        <div className="mx-auto w-full rounded-[3px] border border-[var(--vk-border)] bg-[var(--vk-bg-panel)] p-px">
+          <div className="flex flex-wrap items-center gap-2 border-b border-[var(--vk-border)] px-2 pb-[9px] pt-2">
+            <AgentTileIcon seed={{ label: selectedAgent }} className="h-[25px] w-[25px] border-none bg-transparent" />
+            <DropdownMenu.Root>
+              <DropdownMenu.Trigger asChild>
+                <button
+                  type="button"
+                  className="inline-flex h-[31px] max-w-[70vw] items-center rounded-[3px] border border-[var(--vk-border)] bg-[var(--vk-bg-panel)] px-[9px] py-[5px] text-[14px] leading-[21px] text-[var(--vk-text-normal)] outline-none hover:bg-[var(--vk-bg-hover)] data-[state=open]:bg-[var(--vk-bg-hover)] sm:max-w-none"
+                  aria-label="Select agent"
+                >
+                  <span className="truncate pr-1">{selectedAgentLabel}</span>
+                  <ChevronDown className="h-3 w-3 text-[var(--vk-text-muted)]" />
+                </button>
+              </DropdownMenu.Trigger>
+
+              <DropdownMenu.Portal>
+                <DropdownMenu.Content
+                  align="start"
+                  sideOffset={6}
+                  className={lightMenuClass}
+                >
+                  <p className="px-3 pb-1 text-[14px] font-semibold leading-[21px] text-[var(--vk-text-muted)]">
+                    Agents
+                  </p>
+
+                  {orderedAgentOptions.map((agent) => {
+                    const isSelected = agent === selectedAgent;
+                    const agentState = agentStates[normalizeAgentName(agent)] ?? null;
+                    return (
+                      <DropdownMenu.Item
+                        key={agent}
+                        onSelect={() => setSelectedAgent(agent)}
+                        className={lightMenuItemClass}
+                      >
+                        <AgentTileIcon seed={{ label: agent }} className="h-6 w-6 border-none bg-transparent" />
+                        <div className="min-w-0 flex-1">
+                          <div>{getAgentLabel(agent)}</div>
+                          {!agentState?.ready ? (
+                            <div className="truncate text-[12px] leading-[16px] text-[var(--vk-text-muted)]">
+                              {agentState?.installed ? "Setup required" : "Not installed"}
+                            </div>
+                          ) : null}
+                        </div>
+                        <span className="ml-auto inline-flex h-4 w-4 items-center justify-center text-[var(--vk-text-strong)]">
+                          {isSelected ? <Check className="h-4 w-4" /> : null}
+                        </span>
+                      </DropdownMenu.Item>
+                    );
+                  })}
+                </DropdownMenu.Content>
+              </DropdownMenu.Portal>
+            </DropdownMenu.Root>
+
+            <DropdownMenu.Root>
+              <DropdownMenu.Trigger asChild>
+                <button
+                  type="button"
+                  disabled={!effectiveProjectId}
+                  className="ml-auto flex h-[31px] min-w-[220px] items-center rounded-[3px] border border-[var(--vk-border)] bg-[var(--vk-bg-panel)] px-[9px] py-[5px] text-left disabled:cursor-not-allowed disabled:opacity-50 sm:ml-0 sm:w-[286px]"
+                  aria-label="Link task"
+                >
+                  <span className="pr-2 text-[12px] uppercase tracking-[0.08em] text-[var(--vk-text-muted)]">Task</span>
+                  <span className="min-w-0 flex-1 truncate text-[14px] leading-[21px] text-[var(--vk-text-normal)]">
+                    {selectedTaskLabel}
+                  </span>
+                  <ChevronDown className="h-3 w-3 text-[var(--vk-text-muted)]" />
+                </button>
+              </DropdownMenu.Trigger>
+              <DropdownMenu.Portal>
+                <DropdownMenu.Content
+                  align="end"
+                  side="bottom"
+                  sideOffset={6}
+                  className={scrollMenuClass}
+                >
+                  <p className="px-3 pb-1 text-[14px] font-semibold leading-[21px] text-[var(--vk-text-muted)]">
+                    Link task
+                  </p>
+                  <p className="px-3 pb-2 text-[12px] leading-[16px] text-[var(--text-faint)]">
+                    {selectedTaskSubtitle}
+                  </p>
+                  <DropdownMenu.Item
+                    onSelect={() => setIssueId("")}
+                    className={lightMenuItemClass}
+                  >
+                    <span>No linked task</span>
+                    <span className="ml-auto inline-flex h-4 w-4 items-center justify-center text-[var(--vk-text-strong)]">
+                      {!issueId ? <Check className="h-4 w-4" /> : null}
+                    </span>
+                  </DropdownMenu.Item>
+                  {taskLoading ? (
+                    <div className="px-3 py-2 text-[12px] leading-[18px] text-[var(--vk-text-muted)]">
+                      Loading board tasks...
+                    </div>
+                  ) : availableTasks.length > 0 ? (
+                    availableTasks.map((task) => {
+                      const taskValue = getLinkedTaskValue(task);
+                      const title = getLinkedTaskTitle(task.text);
+                      const secondary = [task.type, task.priority].filter(Boolean).join(" · ");
+                      return (
+                        <DropdownMenu.Item
+                          key={taskValue}
+                          onSelect={() => setIssueId(taskValue)}
+                          className={`${lightMenuItemClass} min-w-[320px] items-start`}
+                        >
+                          <div className="min-w-0 flex-1">
+                            <div className="truncate">
+                              {task.taskRef?.trim() || title}
+                            </div>
+                            <div className="truncate text-[12px] leading-[16px] text-[var(--text-faint)]">
+                              {task.taskRef?.trim() ? title : taskValue}
+                              {secondary ? ` · ${secondary}` : ""}
+                            </div>
+                          </div>
+                          <span className="ml-auto inline-flex h-4 w-4 items-center justify-center text-[var(--vk-text-strong)]">
+                            {issueId === taskValue ? <Check className="h-4 w-4" /> : null}
+                          </span>
+                        </DropdownMenu.Item>
+                      );
+                    })
+                  ) : (
+                    <div className="px-3 py-2 text-[12px] leading-[18px] text-[var(--vk-text-muted)]">
+                      No existing tasks were found for this project.
+                    </div>
+                  )}
+                </DropdownMenu.Content>
+              </DropdownMenu.Portal>
+            </DropdownMenu.Root>
+          </div>
+
+          <div className="rounded-[3.5px]">
+            <div className="flex flex-col gap-3 p-2">
+              <div className="relative w-full">
+                <textarea
+                  value={prompt}
+                  onChange={(e) => setPrompt(e.target.value)}
+                  placeholder="Describe the task..."
+                  rows={1}
+                  className="min-h-[24px] w-full resize-none bg-transparent pr-8 text-[16px] leading-[24px] text-[var(--vk-text-normal)] outline-none placeholder:text-[var(--vk-text-muted)]"
+                />
+                <button
+                  type="button"
+                  aria-label="Preview"
+                  className="absolute right-0 top-0 inline-flex h-[24px] w-[24px] items-center justify-center rounded-[4px] text-[var(--vk-text-muted)] hover:bg-[var(--vk-bg-hover)]"
+                >
+                  <Eye className="h-[14px] w-[14px]" />
+                </button>
+              </div>
+
+              <div className="flex flex-col gap-3 sm:flex-row sm:items-end sm:justify-between">
+                <div className="flex min-w-0 flex-1 flex-wrap items-center gap-x-1 gap-y-2">
+                  <DropdownMenu.Root>
+                    <DropdownMenu.Trigger asChild>
+                      <button
+                        type="button"
+                        className="inline-flex h-[29px] w-[29px] items-center justify-center rounded-[3px] border border-[var(--vk-border)] bg-[var(--vk-bg-panel)] text-[var(--vk-text-normal)] hover:bg-[var(--vk-bg-hover)]"
+                        aria-label="Select workspace or project"
+                      >
+                        <SlidersHorizontal className="h-[15px] w-[15px]" />
+                      </button>
+                    </DropdownMenu.Trigger>
+                    <DropdownMenu.Portal>
+                      <DropdownMenu.Content align="start" sideOffset={6} className={lightMenuClass}>
+                        <p className="px-3 pb-1 text-[14px] font-semibold leading-[21px] text-[var(--vk-text-muted)]">Projects</p>
+                        {projectOptions.map((project) => {
+                          const displayName = getProjectDisplayName(project);
+                          const secondaryLabel = project.id !== displayName
+                            ? project.id
+                            : project.path?.trim() || project.repo?.trim() || null;
+                          return (
+                            <DropdownMenu.Item
+                              key={project.id}
+                              onSelect={() => onSelectProject(project.id)}
+                              className={`${lightMenuItemClass} min-w-[280px] items-start`}
+                            >
+                              <div className="min-w-0 flex-1">
+                                <div className="truncate">{displayName}</div>
+                                {secondaryLabel ? (
+                                  <div className="truncate text-[12px] leading-[16px] text-[var(--text-faint)]">
+                                    {secondaryLabel}
+                                  </div>
+                                ) : null}
+                              </div>
+                              <span className="ml-auto inline-flex h-4 w-4 items-center justify-center text-[var(--vk-text-strong)]">
+                                {project.id === effectiveProjectId ? <Check className="h-4 w-4" /> : null}
+                              </span>
+                            </DropdownMenu.Item>
+                          );
+                        })}
+                        <DropdownMenu.Separator className="my-1 h-px bg-[var(--vk-border)]" />
+                        <DropdownMenu.Item onSelect={onOpenAddWorkspace} className={lightMenuItemClass}>
+                          <FolderOpen className="h-4 w-4" />
+                          <span>Add Workspace</span>
+                        </DropdownMenu.Item>
+                      </DropdownMenu.Content>
+                    </DropdownMenu.Portal>
+                  </DropdownMenu.Root>
+
+                  <DropdownMenu.Root>
+                    <DropdownMenu.Trigger asChild>
+                      <button
+                        type="button"
+                        className="inline-flex h-[29px] items-center gap-[4px] rounded-[3px] border border-[var(--vk-border)] bg-[var(--vk-bg-panel)] px-[9px] py-[5px] text-[14px] leading-[21px] text-[var(--vk-text-normal)] hover:bg-[var(--vk-bg-hover)] disabled:cursor-not-allowed disabled:opacity-60"
+                      >
+                        <span>{selectedModelLabel}</span>
+                        <ChevronDown className="h-[10px] w-[10px] text-[var(--vk-text-muted)]" />
+                      </button>
+                    </DropdownMenu.Trigger>
+                    <DropdownMenu.Portal>
+                      <DropdownMenu.Content align="start" sideOffset={6} className={lightMenuClass}>
+                        <p className="px-3 pb-1 text-[14px] font-semibold leading-[21px] text-[var(--vk-text-muted)]">Model</p>
+                        <DropdownMenu.Item
+                          onSelect={() => setModelSelection(buildModelSelection(
+                            selectedAgent,
+                            modelAccess,
+                            runtimeModelCatalogs,
+                            selectedProject?.agentModel,
+                            selectedProject?.agentReasoningEffort,
+                          ))}
+                          className={lightMenuItemClass}
+                        >
+                          <span>Default</span>
+                          <span className="ml-auto inline-flex h-4 w-4 items-center justify-center text-[var(--vk-text-strong)]">
+                            {!selectedModelValue ? <Check className="h-4 w-4" /> : null}
+                          </span>
+                        </DropdownMenu.Item>
+                        {modelMenuOptions.map((option) => (
+                          <DropdownMenu.Item
+                            key={option.id}
+                            onSelect={() => setModelSelection({
+                              catalogModel: option.id,
+                              customModel: "",
+                              reasoningEffort: getSelectableDefaultReasoningEffort(
+                                selectedAgent,
+                                modelAccess,
+                                runtimeModelCatalogs,
+                                option.id,
+                              ),
+                            })}
+                            className={lightMenuItemClass}
+                          >
+                            <span>{option.label}</span>
+                            <span className="ml-auto inline-flex h-4 w-4 items-center justify-center text-[var(--vk-text-strong)]">
+                              {selectedModelValue === option.id ? <Check className="h-4 w-4" /> : null}
+                            </span>
+                          </DropdownMenu.Item>
+                        ))}
+                        {modelMenuOptions.length === 0 ? (
+                          <div className="px-3 py-2 text-[12px] leading-[18px] text-[var(--vk-text-muted)]">
+                            Models will appear here after the selected agent is installed and its runtime catalog is detected.
+                          </div>
+                        ) : null}
+                        {selectedAgentState && !selectedAgentState.ready ? (
+                          <>
+                            <DropdownMenu.Separator className="my-1 h-px bg-[var(--vk-border)]" />
+                            <button
+                              type="button"
+                              onClick={() => onOpenAgentSetup(selectedAgent)}
+                              className="flex w-full items-center rounded-[3px] px-3 py-2 text-left text-[13px] text-[var(--vk-orange)] transition hover:bg-[var(--vk-bg-hover)]"
+                            >
+                              {selectedAgentState.installed ? "Open setup" : "Open install guide"}
+                            </button>
+                          </>
+                        ) : null}
+                      </DropdownMenu.Content>
+                    </DropdownMenu.Portal>
+                  </DropdownMenu.Root>
+
+                  <div className="inline-flex h-[29px] w-[29px] items-center justify-center rounded-[3px] border border-[var(--vk-border)] bg-[var(--vk-bg-panel)] text-[var(--vk-text-normal)]">
+                    <ChevronsRight className="h-[15px] w-[15px]" />
+                  </div>
+
+                  <DropdownMenu.Root>
+                    <DropdownMenu.Trigger asChild>
+                      <button
+                        type="button"
+                        className="inline-flex h-[29px] items-center gap-[4px] rounded-[3px] border border-[var(--vk-border)] bg-[var(--vk-bg-panel)] px-[9px] py-[5px] text-[14px] leading-[21px] text-[var(--vk-text-normal)] hover:bg-[var(--vk-bg-hover)]"
+                      >
+                        <span>{selectedPermission.label}</span>
+                        <ChevronDown className="h-[10px] w-[10px] text-[var(--vk-text-muted)]" />
+                      </button>
+                    </DropdownMenu.Trigger>
+                    <DropdownMenu.Portal>
+                      <DropdownMenu.Content align="start" sideOffset={6} className={lightMenuClass}>
+                        <p className="px-3 pb-1 text-[14px] font-semibold leading-[21px] text-[var(--vk-text-muted)]">Permissions</p>
+                        {permissionOptions.map(({ id, label, icon: Icon }) => (
+                          <DropdownMenu.Item
+                            key={id}
+                            onSelect={() => setPermissionMode(id)}
+                            className={lightMenuItemClass}
+                          >
+                            <Icon className="h-4 w-4" />
+                            <span>{label}</span>
+                            <span className="ml-auto inline-flex h-4 w-4 items-center justify-center text-[var(--vk-text-strong)]">
+                              {permissionMode === id ? <Check className="h-4 w-4" /> : null}
+                            </span>
+                          </DropdownMenu.Item>
+                        ))}
+                      </DropdownMenu.Content>
+                    </DropdownMenu.Portal>
+                  </DropdownMenu.Root>
+
+                  <button
+                    type="button"
+                    onClick={onOpenAddWorkspace}
+                    className="inline-flex h-[29px] w-[20px] items-center justify-center text-[var(--vk-text-muted)] hover:text-[var(--vk-text-normal)]"
+                    aria-label="Add workspace"
+                  >
+                    <Paperclip className="h-[18px] w-[18px]" />
+                  </button>
+
+                  <DropdownMenu.Root>
+                    <DropdownMenu.Trigger asChild>
+                      <button
+                        type="button"
+                        disabled={!selectedProject}
+                        className="inline-flex min-h-[29px] max-w-[320px] items-center justify-center truncate text-[14px] leading-[21px] text-[var(--vk-text-normal)] hover:text-[var(--vk-text-strong)] disabled:cursor-not-allowed disabled:opacity-50"
+                      >
+                        {currentProjectLabel}
+                      </button>
+                    </DropdownMenu.Trigger>
+                    <DropdownMenu.Portal>
+                      <DropdownMenu.Content
+                        align="start"
+                        side="bottom"
+                        sideOffset={6}
+                        avoidCollisions={false}
+                        className={scrollMenuClass}
+                      >
+                        <p className="px-3 pb-1 text-[14px] font-semibold leading-[21px] text-[var(--vk-text-muted)]">Branch</p>
+                        {selectedProjectLabel ? (
+                          <p className="px-3 pb-2 text-[12px] leading-[16px] text-[var(--text-faint)]">
+                            {selectedProjectLabel}
+                          </p>
+                        ) : null}
+                        {branchLoading ? (
+                          <div className="px-3 py-2 text-[14px] leading-[21px] text-[var(--vk-text-muted)]">Loading branches...</div>
+                        ) : (
+                          branchOptions.map((branch) => (
+                            <DropdownMenu.Item
+                              key={branch}
+                              onSelect={() => setSelectedBranch(branch)}
+                              className={lightMenuItemClass}
+                            >
+                              <span>{branch}</span>
+                              <span className="ml-auto inline-flex h-4 w-4 items-center justify-center text-[var(--vk-text-strong)]">
+                                {selectedBranch === branch ? <Check className="h-4 w-4" /> : null}
+                              </span>
+                            </DropdownMenu.Item>
+                          ))
+                        )}
+                      </DropdownMenu.Content>
+                    </DropdownMenu.Portal>
+                  </DropdownMenu.Root>
+                </div>
+
+                <div className="flex w-full justify-end sm:w-auto">
+                  <button
+                    type="button"
+                    onClick={() => onCreate({
+                      projectId: effectiveProjectId ?? undefined,
+                      ...(useWorktree
+                        ? { baseBranch: selectedBranch || selectedProject?.defaultBranch || undefined }
+                        : { branch: selectedBranch || selectedProject?.defaultBranch || undefined }),
+                      issueId: issueId.trim() || undefined,
+                      useWorktree,
+                      permissionMode,
+                    })}
+                    disabled={creating || prompt.trim().length === 0 || !effectiveProjectId}
+                    className="inline-flex min-h-[29px] items-center justify-center rounded-[3px] bg-[var(--vk-bg-hover)] px-[8px] py-[6.5px] text-[16px] leading-[16px] text-[var(--vk-text-strong)] transition-colors hover:bg-[var(--vk-bg-active)] disabled:cursor-not-allowed disabled:opacity-50"
+                  >
+                    {creating ? <Loader2 className="h-4 w-4 animate-spin" /> : "Create"}
+                  </button>
+                </div>
+              </div>
+
+              {selectedAgentState && !selectedAgentState.ready ? (
+                <div className="rounded-[4px] border border-[var(--vk-border)] bg-[var(--vk-bg-main)] px-3 py-2 text-[13px] text-[var(--vk-text-normal)]">
+                  <div className="flex flex-col gap-2 sm:flex-row sm:items-center sm:justify-between">
+                    <div className="min-w-0">
+                      <p className="text-[13px] text-[var(--vk-text-strong)]">
+                        {selectedAgentLabel} is not ready on this machine.
+                      </p>
+                      <p className="pt-0.5 text-[12px] text-[var(--vk-text-muted)]">
+                        {selectedAgentState.installed
+                          ? "Finish login or local setup to load models and start streaming sessions."
+                          : "Install the CLI first, then its models and authentication state will appear here."}
+                      </p>
+                    </div>
+                    <button
+                      type="button"
+                      onClick={() => onOpenAgentSetup(selectedAgent)}
+                      className="inline-flex h-[29px] items-center justify-center rounded-[3px] border border-[var(--vk-border)] px-3 text-[12px] text-[var(--vk-orange)] hover:bg-[var(--vk-bg-hover)]"
+                    >
+                      {selectedAgentState.installed ? "Open setup" : "Open install"}
+                    </button>
+                  </div>
+                </div>
+              ) : null}
+
+              <label className="flex items-start gap-2 rounded-[4px] border border-[var(--vk-border)] bg-[var(--vk-bg-main)] px-2 py-2 text-[13px] text-[var(--vk-text-normal)]">
+                <input
+                  type="checkbox"
+                  checked={useWorktree}
+                  onChange={(event) => setUseWorktree(event.target.checked)}
+                  className="mt-0.5 h-4 w-4 rounded border border-[var(--vk-border)] bg-transparent accent-[var(--vk-orange)]"
+                />
+                <span>
+                  Use worktree isolation
+                  <span className="block text-[11px] text-[var(--vk-text-muted)]">
+                    If unchecked, the session runs directly on the selected branch in the local repo.
+                  </span>
+                </span>
+              </label>
+            </div>
+          </div>
+        </div>
+
+        {error && <p className="pt-2 text-[12px] text-[var(--status-error)]">{error}</p>}
+      </div>
+    </section>
+  );
+});
+
+function CopySnippetButton({
+  value,
+  idleLabel = "Copy",
+  copiedLabel = "Copied",
+}: {
+  value: string;
+  idleLabel?: string;
+  copiedLabel?: string;
+}) {
+  const [copied, setCopied] = useState(false);
+
+  async function handleCopy() {
+    await navigator.clipboard.writeText(value);
+    setCopied(true);
+    window.setTimeout(() => setCopied(false), 1400);
+  }
+
+  return (
+    <button
+      type="button"
+      onClick={() => void handleCopy()}
+      className="inline-flex h-8 items-center gap-1.5 rounded-[4px] border border-[var(--vk-border)] px-2 text-[12px] text-[var(--vk-text-normal)] hover:bg-[var(--vk-bg-hover)]"
+    >
+      {copied ? <Check className="h-3.5 w-3.5 text-[var(--vk-orange)]" /> : <Copy className="h-3.5 w-3.5" />}
+      <span>{copied ? copiedLabel : idleLabel}</span>
+    </button>
+  );
+}
+
+function SettingsDialog({
+  open,
+  mode,
+  creating,
+  error,
+  current,
+  projectCount,
+  agentOptions,
+  runtimeModelCatalogs,
+  onRepositoriesChanged,
+  onOnboardingComplete,
+  onClose,
+  onSave,
+}: {
+  open: boolean;
+  mode: PreferencesDialogMode;
+  creating: boolean;
+  error: string | null;
+  current: PreferencesPayload;
+  projectCount: number;
+  agentOptions: string[];
+  runtimeModelCatalogs: Record<string, RuntimeAgentModelCatalog>;
+  onRepositoriesChanged?: () => Promise<void>;
+  onOnboardingComplete?: (result: { needsProject: boolean }) => void;
+  onClose: () => void;
+  onSave: (next: PreferencesPayload, options?: { closeDialog?: boolean }) => Promise<boolean>;
+}) {
+  const [activeTab, setActiveTab] = useState<SettingsTabId>("preferences");
+  const [codingAgent, setCodingAgent] = useState(current.codingAgent);
+  const [ide, setIde] = useState(current.ide);
+  const [remoteSshHost, setRemoteSshHost] = useState(current.remoteSshHost);
+  const [remoteSshUser, setRemoteSshUser] = useState(current.remoteSshUser);
+  const [markdownEditor, setMarkdownEditor] = useState(current.markdownEditor);
+  const [modelAccess, setModelAccess] = useState<ModelAccessPreferences>(current.modelAccess);
+  const [soundEnabled, setSoundEnabled] = useState(current.notifications.soundEnabled);
+  const [soundFile, setSoundFile] = useState<string | null>(current.notifications.soundFile);
+  const [repositories, setRepositories] = useState<RepositorySettingsPayload[]>([]);
+  const [repositoriesLoading, setRepositoriesLoading] = useState(false);
+  const [repositoriesSaving, setRepositoriesSaving] = useState(false);
+  const [repositoriesError, setRepositoriesError] = useState<string | null>(null);
+  const [selectedRepositoryId, setSelectedRepositoryId] = useState("");
+  const [repositoryDraft, setRepositoryDraft] = useState<RepositorySettingsPayload | null>(null);
+  const [repositoryModelSelection, setRepositoryModelSelection] = useState<ModelSelectionState>(emptyModelSelection());
+  const [repositoryBranchOptions, setRepositoryBranchOptions] = useState<string[]>([]);
+  const [repositoryBranchesLoading, setRepositoryBranchesLoading] = useState(false);
+  const [repositoryBranchesError, setRepositoryBranchesError] = useState<string | null>(null);
+  const [repositoryFolderPickerOpen, setRepositoryFolderPickerOpen] = useState(false);
+  const [accessSettings, setAccessSettings] = useState<AccessSettingsPayload>(() => normalizeAccessSettings(null));
+  const [accessLoading, setAccessLoading] = useState(false);
+  const [accessSaving, setAccessSaving] = useState(false);
+  const [accessError, setAccessError] = useState<string | null>(null);
+
+  const isBusy = creating || repositoriesSaving || accessSaving;
+
+  function hydrateRepositoryDraft(value: RepositorySettingsPayload): RepositorySettingsPayload {
+    return {
+      ...value,
+      pathHealth: {
+        exists: value.pathHealth.exists,
+        isGitRepository: value.pathHealth.isGitRepository,
+        suggestedPath: value.pathHealth.suggestedPath,
+      },
+    };
+  }
+
+  function parseMultilineRoleList(value: string): string[] {
+    return value
+      .split(/\n+/g)
+      .map((item) => item.trim())
+      .filter(Boolean);
+  }
+
+  async function loadRepositories(preferredRepositoryId?: string): Promise<void> {
+    setRepositoriesLoading(true);
+    setRepositoriesError(null);
+    try {
+      const res = await fetch("/api/repositories");
+      const data = (await res.json().catch(() => null)) as
+        | { repositories?: RepositorySettingsPayload[]; error?: string }
+        | null;
+      if (!res.ok) {
+        throw new Error(data?.error ?? `Failed to load repositories (${res.status})`);
+      }
+      const items = Array.isArray(data?.repositories) ? data.repositories : [];
+      setRepositories(items);
+
+      const fallbackId = items[0]?.id ?? "";
+      const selectedId = preferredRepositoryId && items.some((item) => item.id === preferredRepositoryId)
+        ? preferredRepositoryId
+        : selectedRepositoryId && items.some((item) => item.id === selectedRepositoryId)
+          ? selectedRepositoryId
+          : fallbackId;
+
+      setSelectedRepositoryId(selectedId);
+    } catch (err) {
+      setRepositories([]);
+      setSelectedRepositoryId("");
+      setRepositoryDraft(null);
+      setRepositoryModelSelection(emptyModelSelection());
+      setRepositoriesError(err instanceof Error ? err.message : "Failed to load repositories");
+    } finally {
+      setRepositoriesLoading(false);
+    }
+  }
+
+  async function detectRepositoryBranches(pathOverride?: string, preferredBranch?: string): Promise<void> {
+    const repositoryPath = pathOverride ?? repositoryDraft?.path ?? "";
+    const trimmedPath = repositoryPath.trim();
+    if (trimmedPath.length === 0) {
+      setRepositoryBranchesError("Select a repository path first.");
+      setRepositoryBranchOptions([]);
+      return;
+    }
+
+    setRepositoryBranchesLoading(true);
+    setRepositoryBranchesError(null);
+    try {
+      const params = new URLSearchParams({ path: trimmedPath });
+      const res = await fetch(`/api/workspaces/branches?${params.toString()}`);
+      const data = (await res.json().catch(() => null)) as
+        | { branches?: string[]; defaultBranch?: string | null; error?: string }
+        | null;
+      if (!res.ok) {
+        throw new Error(data?.error ?? `Failed to detect branches (${res.status})`);
+      }
+
+      const branches = Array.isArray(data?.branches)
+        ? data.branches.filter((branch) => typeof branch === "string" && branch.trim().length > 0)
+        : [];
+      setRepositoryBranchOptions(branches);
+
+      const suggestedDefault = preferredBranch?.trim()
+        || (typeof data?.defaultBranch === "string" && data.defaultBranch.trim().length > 0
+          ? data.defaultBranch.trim()
+          : branches[0] ?? "");
+
+      if (!suggestedDefault) return;
+      setRepositoryDraft((prev) => {
+        if (!prev) return prev;
+        if (prev.defaultBranch.trim().length > 0 && branches.includes(prev.defaultBranch)) {
+          return prev;
+        }
+        return { ...prev, defaultBranch: suggestedDefault };
+      });
+    } catch (err) {
+      setRepositoryBranchOptions([]);
+      setRepositoryBranchesError(err instanceof Error ? err.message : "Failed to detect branches");
+    } finally {
+      setRepositoryBranchesLoading(false);
+    }
+  }
+
+  async function handleSaveRepository(): Promise<boolean> {
+    if (!repositoryDraft || repositoriesSaving) return false;
+    if (repositoryDraft.repo.trim().length === 0 || repositoryDraft.path.trim().length === 0) return false;
+
+    setRepositoriesSaving(true);
+    setRepositoriesError(null);
+    try {
+      const res = await fetch("/api/repositories", {
+        method: "PUT",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          id: repositoryDraft.id,
+          displayName: repositoryDraft.displayName,
+          repo: repositoryDraft.repo,
+          path: repositoryDraft.path,
+          agent: repositoryDraft.agent,
+          agentModel: resolveModelSelectionValue(repositoryModelSelection) ?? "",
+          agentReasoningEffort: resolveReasoningSelectionValue(repositoryModelSelection) ?? "",
+          defaultWorkingDirectory: repositoryDraft.defaultWorkingDirectory,
+          defaultBranch: repositoryDraft.defaultBranch,
+          devServerScript: repositoryDraft.devServerScript,
+          setupScript: repositoryDraft.setupScript,
+          runSetupInParallel: repositoryDraft.runSetupInParallel,
+          cleanupScript: repositoryDraft.cleanupScript,
+          archiveScript: repositoryDraft.archiveScript,
+          copyFiles: repositoryDraft.copyFiles,
+        }),
+      });
+
+      const data = (await res.json().catch(() => null)) as
+        | { repository?: RepositorySettingsPayload; error?: string }
+        | null;
+      if (!res.ok) {
+        throw new Error(data?.error ?? `Failed to save repository settings (${res.status})`);
+      }
+
+      const saved = data?.repository;
+      if (!saved) {
+        throw new Error("Repository saved but response is missing repository data");
+      }
+
+      setRepositories((prev) => prev.map((item) => (item.id === saved.id ? saved : item)));
+      setRepositoryDraft(hydrateRepositoryDraft(saved));
+      setSelectedRepositoryId(saved.id);
+      setRepositoryBranchesError(null);
+
+      await detectRepositoryBranches(saved.path, saved.defaultBranch);
+
+      if (onRepositoriesChanged) {
+        await onRepositoriesChanged();
+      }
+      return true;
+    } catch (err) {
+      setRepositoriesError(err instanceof Error ? err.message : "Failed to save repository settings");
+      return false;
+    } finally {
+      setRepositoriesSaving(false);
+    }
+  }
+
+  async function loadAccessSettings(): Promise<void> {
+    setAccessLoading(true);
+    setAccessError(null);
+    try {
+      const res = await fetch("/api/access");
+      const data = (await res.json().catch(() => null)) as
+        | { access?: unknown; current?: unknown; error?: string }
+        | null;
+      if (!res.ok) {
+        throw new Error(data?.error ?? `Failed to load organization settings (${res.status})`);
+      }
+      setAccessSettings(normalizeAccessSettings(data?.access, data?.current));
+    } catch (err) {
+      setAccessSettings(normalizeAccessSettings(null));
+      setAccessError(err instanceof Error ? err.message : "Failed to load organization settings");
+    } finally {
+      setAccessLoading(false);
+    }
+  }
+
+  async function handleSaveAccess(): Promise<boolean> {
+    if (accessSaving) return false;
+
+    setAccessSaving(true);
+    setAccessError(null);
+    try {
+      const res = await fetch("/api/access", {
+        method: "PUT",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          requireAuth: accessSettings.requireAuth,
+          defaultRole: accessSettings.defaultRole,
+          trustedHeaders: {
+            enabled: accessSettings.trustedHeaders.enabled,
+            provider: accessSettings.trustedHeaders.provider,
+            emailHeader: accessSettings.trustedHeaders.emailHeader,
+            jwtHeader: accessSettings.trustedHeaders.jwtHeader,
+            teamDomain: accessSettings.trustedHeaders.teamDomain,
+            audience: accessSettings.trustedHeaders.audience,
+          },
+          roles: {
+            viewers: parseMultilineRoleList(accessSettings.roles.viewers),
+            operators: parseMultilineRoleList(accessSettings.roles.operators),
+            admins: parseMultilineRoleList(accessSettings.roles.admins),
+            viewerDomains: parseMultilineRoleList(accessSettings.roles.viewerDomains),
+            operatorDomains: parseMultilineRoleList(accessSettings.roles.operatorDomains),
+            adminDomains: parseMultilineRoleList(accessSettings.roles.adminDomains),
+          },
+        }),
+      });
+      const data = (await res.json().catch(() => null)) as
+        | { access?: unknown; current?: unknown; error?: string }
+        | null;
+      if (!res.ok) {
+        throw new Error(data?.error ?? `Failed to save organization settings (${res.status})`);
+      }
+
+      setAccessSettings(normalizeAccessSettings(data?.access, data?.current));
+      return true;
+    } catch (err) {
+      setAccessError(err instanceof Error ? err.message : "Failed to save organization settings");
+      return false;
+    } finally {
+      setAccessSaving(false);
+    }
+  }
+
+  useEffect(() => {
+    if (!open) return;
+    setActiveTab(mode === "onboarding" ? "preferences" : "general");
+    setCodingAgent(current.codingAgent);
+    setIde(current.ide);
+    setRemoteSshHost(current.remoteSshHost);
+    setRemoteSshUser(current.remoteSshUser);
+    setMarkdownEditor(current.markdownEditor);
+    setModelAccess(current.modelAccess);
+    setSoundEnabled(current.notifications.soundEnabled);
+    setSoundFile(current.notifications.soundFile);
+    setRepositoryBranchOptions([]);
+    setRepositoryBranchesError(null);
+    setRepositoriesError(null);
+    setRepositoryModelSelection(emptyModelSelection());
+    setAccessError(null);
+  }, [mode, open]);
+
+  useEffect(() => {
+    if (!open) return;
+    if (mode === "settings" || activeTab === "repositories") {
+      void loadRepositories();
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [activeTab, mode, open]);
+
+  useEffect(() => {
+    if (!open || mode === "onboarding") return;
+    void loadAccessSettings();
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [mode, open]);
+
+  useEffect(() => {
+    if (!open) return;
+    if (!selectedRepositoryId) {
+      setRepositoryDraft(null);
+      setRepositoryModelSelection(emptyModelSelection());
+      return;
+    }
+    const selected = repositories.find((item) => item.id === selectedRepositoryId);
+    if (!selected) return;
+    setRepositoryDraft(hydrateRepositoryDraft(selected));
+    setRepositoryModelSelection(
+      buildModelSelection(
+        selected.agent,
+        modelAccess,
+        runtimeModelCatalogs,
+        selected.agentModel,
+        selected.agentReasoningEffort,
+      ),
+    );
+    setRepositoryBranchOptions([]);
+    setRepositoryBranchesError(null);
+    if (selected.path.trim().length > 0) {
+      void detectRepositoryBranches(selected.path, selected.defaultBranch);
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [modelAccess, open, repositories, runtimeModelCatalogs, selectedRepositoryId]);
+
+  const onboardingShouldShowRepositoryStep = mode === "onboarding" && projectCount > 0;
+
+  const visibleTabs = useMemo(() => {
+    if (mode === "onboarding") {
+      return onboardingShouldShowRepositoryStep
+        ? ONBOARDING_TABS
+        : ONBOARDING_TABS.filter((tab) => tab.id === "preferences");
+    }
+    return SETTINGS_TABS.filter((tab) => tab.implemented);
+  }, [mode, onboardingShouldShowRepositoryStep]);
+
+  const activeTabItem = visibleTabs.find((tab) => tab.id === activeTab) ?? visibleTabs[0] ?? SETTINGS_TABS[0];
+  const isOnboarding = mode === "onboarding";
+  const isPreferencesTab = activeTabItem.id === "preferences";
+  const isGeneralTab = activeTabItem.id === "general";
+  const isRemoteAccessTab = activeTabItem.id === "remote_access";
+  const isAgentsTab = activeTabItem.id === "agents";
+  const isPreferenceFormTab = isPreferencesTab || isGeneralTab || isRemoteAccessTab || isAgentsTab;
+  const isRepositoriesTab = activeTabItem.id === "repositories";
+  const isOrganizationTab = activeTabItem.id === "organization";
+  const onboardingStepIndex = visibleTabs.findIndex((tab) => tab.id === activeTabItem.id) + 1;
+  const onboardingHasRepositoryStep = visibleTabs.some((tab) => tab.id === "repositories");
+  const accessCanEdit = accessSettings.current.role === "admin";
+
+  const orderedAgentOptions = useMemo(() => {
+    const opts = new Set(agentOptions);
+    if (codingAgent.trim().length > 0) {
+      opts.add(codingAgent);
+    }
+    if (opts.size === 0) {
+      opts.add("qwen-code");
+    }
+    const rankMap = new Map(EXECUTOR_ORDER.map((name, index) => [name, index]));
+    return [...opts].sort((left, right) => {
+      const leftRank = rankMap.get(normalizeAgentName(left)) ?? Number.MAX_SAFE_INTEGER;
+      const rightRank = rankMap.get(normalizeAgentName(right)) ?? Number.MAX_SAFE_INTEGER;
+      if (leftRank !== rightRank) return leftRank - rightRank;
+      return getAgentLabel(left).localeCompare(getAgentLabel(right));
+    });
+  }, [agentOptions, codingAgent]);
+
+  function handleModelAccessChange(agent: string, nextAccess: string) {
+    const catalog = getAgentModelCatalog(agent);
+    if (!catalog) return;
+
+    setModelAccess((prev) => ({
+      ...prev,
+      [catalog.accessKey]: nextAccess,
+    } as ModelAccessPreferences));
+  }
+
+  if (!open) return null;
+
+  const canSubmitPreferences = codingAgent.trim().length > 0
+    && ide.trim().length > 0
+    && markdownEditor.trim().length > 0;
+  const canSaveRepository = !!repositoryDraft
+    && repositoryDraft.displayName.trim().length > 0
+    && repositoryDraft.repo.trim().length > 0
+    && repositoryDraft.path.trim().length > 0
+    && repositoryDraft.defaultBranch.trim().length > 0;
+  const canSaveAccess = accessCanEdit && !accessLoading && (
+    !accessSettings.trustedHeaders.enabled
+    || accessSettings.trustedHeaders.provider === "generic"
+    || (
+      accessSettings.trustedHeaders.teamDomain.trim().length > 0
+      && accessSettings.trustedHeaders.audience.trim().length > 0
+    )
+  );
+  const dialogError = isRepositoriesTab
+    ? repositoriesError
+    : isOrganizationTab
+      ? accessError
+      : error;
+  const accessRoleFields: Array<{
+    label: string;
+    key: keyof AccessSettingsPayload["roles"];
+    placeholder: string;
+  }> = [
+    { label: "Viewer Emails", key: "viewers", placeholder: "alice@example.com" },
+    { label: "Operator Emails", key: "operators", placeholder: "builder@example.com" },
+    { label: "Admin Emails", key: "admins", placeholder: "owner@example.com" },
+    { label: "Viewer Domains", key: "viewerDomains", placeholder: "guests.example.com" },
+    { label: "Operator Domains", key: "operatorDomains", placeholder: "eng.example.com" },
+    { label: "Admin Domains", key: "adminDomains", placeholder: "admins.example.com" },
+  ];
+  const repositoryBootstrapCommand = repositoryDraft
+    ? buildRepositoryBootstrapCommand({
+        ...repositoryDraft,
+        agentModel: resolveModelSelectionValue(repositoryModelSelection) ?? "",
+        agentReasoningEffort: resolveReasoningSelectionValue(repositoryModelSelection) ?? "",
+      }, {
+        ide,
+        markdownEditor,
+      })
+    : "";
+
+  function buildNextPreferences(acknowledgeOnboarding: boolean): PreferencesPayload {
+    const resolvedSoundFile = soundEnabled
+      ? soundFile ?? NOTIFICATION_SOUND_OPTIONS[0]?.id ?? "abstract-sound-4"
+      : null;
+
+    return {
+      onboardingAcknowledged: acknowledgeOnboarding ? true : current.onboardingAcknowledged,
+      codingAgent: codingAgent.trim(),
+      ide: ide.trim(),
+      remoteSshHost: remoteSshHost.trim(),
+      remoteSshUser: remoteSshUser.trim(),
+      markdownEditor: markdownEditor.trim(),
+      modelAccess,
+      notifications: {
+        soundEnabled,
+        soundFile: resolvedSoundFile,
+      },
+    };
+  }
+
+  async function handleSubmitPreferences(
+    acknowledgeOnboarding: boolean,
+    options?: { closeDialog?: boolean },
+  ): Promise<boolean> {
+    if (!canSubmitPreferences || creating) return false;
+    return onSave(buildNextPreferences(acknowledgeOnboarding), options);
+  }
+
+  async function handleOnboardingContinue() {
+    if (repositoriesLoading) return;
+    if (!onboardingHasRepositoryStep) {
+      const saved = await handleSubmitPreferences(true, { closeDialog: true });
+      if (!saved) return;
+      onOnboardingComplete?.({ needsProject: projectCount === 0 });
+      return;
+    }
+
+    const saved = await handleSubmitPreferences(false, { closeDialog: false });
+    if (!saved) return;
+    setActiveTab("repositories");
+  }
+
+  async function handleFinishOnboarding() {
+    if (isRepositoriesTab) {
+      const saved = await handleSaveRepository();
+      if (!saved) return;
+    }
+
+    const saved = await handleSubmitPreferences(true, { closeDialog: true });
+    if (!saved) return;
+    onOnboardingComplete?.({ needsProject: false });
+  }
+
+  return (
+    <>
+      <div
+        className="fixed inset-0 z-[90] flex items-start justify-center overflow-y-auto bg-black/70 px-3 py-3 sm:items-center"
+        onClick={() => {
+          if (isBusy || mode === "onboarding" || repositoryFolderPickerOpen) return;
+          onClose();
+        }}
+        role="presentation"
+      >
+        <div
+          className="flex max-h-[calc(100dvh-1.5rem)] w-full max-w-[1120px] flex-col overflow-hidden rounded-[6px] border border-[var(--vk-border)] bg-[var(--vk-bg-panel)] shadow-[0_24px_80px_rgba(0,0,0,0.55)] sm:h-[min(92vh,760px)] sm:flex-row"
+          onClick={(event) => event.stopPropagation()}
+        >
+          <aside className="flex w-full shrink-0 flex-col border-b border-[var(--vk-border)] bg-[rgba(28,28,28,0.8)] sm:w-[224px] sm:border-b-0 sm:border-r">
+            <header className="border-b border-[var(--vk-border)] px-4 py-3 sm:py-4">
+              <h2 className="text-[22px] leading-[24px] text-[var(--vk-text-strong)] sm:text-[27px] sm:leading-[27px]">
+                {isOnboarding ? "Setup" : "Settings"}
+              </h2>
+            </header>
+            <nav className="flex gap-1 overflow-x-auto p-2 sm:block sm:space-y-1 sm:overflow-auto">
+              {visibleTabs.map((tab) => {
+                const Icon = tab.icon;
+                const selected = activeTabItem.id === tab.id;
+                return (
+                  <button
+                    key={tab.id}
+                    type="button"
+                    onClick={() => setActiveTab(tab.id)}
+                    disabled={isBusy}
+                    className={`flex shrink-0 items-center gap-3 rounded-[3px] px-3 py-2 text-left text-[14px] leading-[21px] transition-colors sm:w-full ${
+                      selected
+                        ? "bg-[rgba(234,122,42,0.1)] text-[var(--vk-orange)]"
+                        : "text-[var(--vk-text-normal)] hover:bg-[var(--vk-bg-hover)]"
+                    } disabled:opacity-50`}
+                  >
+                    <Icon className="h-4 w-4 shrink-0" />
+                    <span>{tab.label}</span>
+                  </button>
+                );
+              })}
+            </nav>
+          </aside>
+
+          <div className="flex min-w-0 flex-1 flex-col">
+            <header className="flex items-center justify-between border-b border-[var(--vk-border)] px-4 py-3 sm:py-4">
+              <div>
+                <h3 className="text-[20px] leading-[24px] text-[var(--vk-text-strong)] sm:text-[27px] sm:leading-[27px]">
+                  {isOnboarding
+                    ? isPreferencesTab
+                      ? "Choose your preferences"
+                      : "Review repository defaults"
+                    : activeTabItem.label}
+                </h3>
+                {isOnboarding && (
+                  <p className="mt-1 text-[12px] text-[var(--vk-text-muted)]">
+                    Step {onboardingStepIndex} of {visibleTabs.length}
+                  </p>
+                )}
+              </div>
+              <button
+                type="button"
+                onClick={onClose}
+                disabled={isBusy || mode === "onboarding"}
+                aria-label="Close settings"
+                className="inline-flex h-7 w-7 items-center justify-center rounded-[4px] text-[var(--vk-text-muted)] hover:bg-[var(--vk-bg-hover)] disabled:opacity-40"
+              >
+                <X className="h-4 w-4" />
+              </button>
+            </header>
+
+            <div className="min-h-0 flex-1 overflow-auto px-4 py-3 sm:px-6 sm:py-4">
+              {isPreferenceFormTab ? (
+                <div className="space-y-5">
+                  {isOnboarding && (
+                    <section className="rounded-[6px] border border-[var(--vk-border)] bg-[rgba(234,122,42,0.08)] px-4 py-3">
+                      <p className="text-[13px] leading-5 text-[var(--vk-text-normal)]">
+                        Conductor is already running locally. Finish setup here in the dashboard, then you can start using
+                        chat and boards immediately.
+                      </p>
+                    </section>
+                  )}
+
+                  {(isPreferencesTab || isAgentsTab) && (
+                    <>
+                  <section className="space-y-2">
+                    <h4 className="text-[15px] font-medium text-[var(--vk-text-strong)]">Choose Your Coding Agent</h4>
+                    <p className="text-[12px] text-[var(--vk-text-muted)]">Select the default coding agent configuration.</p>
+                    <div className="grid gap-2">
+                      {orderedAgentOptions.map((agent) => {
+                        const selected = codingAgent === agent;
+                        return (
+                          <button
+                            key={agent}
+                            type="button"
+                            onClick={() => setCodingAgent(agent)}
+                            className={`flex items-center gap-2 rounded-[4px] border px-3 py-2 text-left ${
+                              selected
+                                ? "border-[var(--vk-orange)] bg-[var(--vk-bg-hover)]"
+                                : "border-[var(--vk-border)] hover:bg-[var(--vk-bg-hover)]"
+                            }`}
+                          >
+                            <AgentTileIcon seed={{ label: agent }} className="h-5 w-5 border-none bg-transparent" />
+                            <span className="flex-1 text-[13px] text-[var(--vk-text-normal)]">{getAgentLabel(agent)}</span>
+                            {selected && <Check className="h-3.5 w-3.5 text-[var(--vk-orange)]" />}
+                          </button>
+                        );
+                      })}
+                    </div>
+                  </section>
+
+                  <section className="space-y-3">
+                    <div className="space-y-1">
+                      <h4 className="text-[15px] font-medium text-[var(--vk-text-strong)]">Model Access</h4>
+                      <p className="text-[12px] text-[var(--vk-text-muted)]">
+                        Tell Conductor which account mode each agent is using so the model dropdown only shows options
+                        that make sense for that login path.
+                      </p>
+                    </div>
+                    <div className="grid gap-3">
+                      {orderedAgentOptions.filter((agent) => supportsAgentModelSelection(agent)).map((agent) => {
+                        const catalog = getAgentModelCatalog(agent);
+                        if (!catalog) return null;
+                        const selectedAccess = resolveAgentModelAccess(agent, modelAccess) ?? catalog.defaultAccess;
+                        return (
+                          <label key={agent} className="block rounded-[4px] border border-[var(--vk-border)] px-3 py-3">
+                            <span className="mb-1 block text-[13px] font-medium text-[var(--vk-text-normal)]">
+                              {catalog.label}
+                            </span>
+                            <select
+                              value={selectedAccess}
+                              onChange={(event) => handleModelAccessChange(agent, event.target.value)}
+                              className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-[var(--vk-bg-panel)] px-2 text-[13px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+                            >
+                              {catalog.accessOptions.map((option) => (
+                                <option key={option.id} value={option.id}>
+                                  {option.label}
+                                </option>
+                              ))}
+                            </select>
+                            <p className="mt-1.5 text-[11px] text-[var(--vk-text-muted)]">
+                              {catalog.accessOptions.find((option) => option.id === selectedAccess)?.description}
+                            </p>
+                          </label>
+                        );
+                      })}
+                    </div>
+                  </section>
+                    </>
+                  )}
+
+                  {(isPreferencesTab || isGeneralTab) && (
+                    <>
+
+                  <section className="space-y-2">
+                    <h4 className="text-[15px] font-medium text-[var(--vk-text-strong)]">Choose Your Code Editor</h4>
+                    <p className="text-[12px] text-[var(--vk-text-muted)]">This editor will be used when opening attempts and files.</p>
+                    <div className="grid gap-2 sm:grid-cols-2">
+                      {IDE_OPTIONS.map((option) => {
+                        const selected = ide === option.id;
+                        return (
+                          <button
+                            key={option.id}
+                            type="button"
+                            onClick={() => setIde(option.id)}
+                            className={`flex items-center gap-2 rounded-[4px] border px-3 py-2 text-left ${
+                              selected
+                                ? "border-[var(--vk-orange)] bg-[var(--vk-bg-hover)]"
+                                : "border-[var(--vk-border)] hover:bg-[var(--vk-bg-hover)]"
+                            }`}
+                          >
+                            <CodeEditorIcon editorId={option.id} label={option.label} />
+                            <span className="flex-1 text-[13px] text-[var(--vk-text-normal)]">{option.label}</span>
+                            {selected && <Check className="h-3.5 w-3.5 text-[var(--vk-orange)]" />}
+                          </button>
+                        );
+                      })}
+                    </div>
+                  </section>
+
+                  {isPreferencesTab && (
+                  <section className="space-y-3">
+                    <div className="space-y-1">
+                      <h4 className="text-[15px] font-medium text-[var(--vk-text-strong)]">Remote Access</h4>
+                      <p className="text-[12px] text-[var(--vk-text-muted)]">
+                        Use your local Remote-SSH editor to jump straight into a remote worktree. This complements
+                        ngrok or Cloudflare Tunnel for dashboard access; it does not replace the tunnel.
+                      </p>
+                    </div>
+
+                    <div className="grid gap-3 sm:grid-cols-2">
+                      <label className="block">
+                        <span className="mb-1.5 block text-[12px] font-medium text-[var(--vk-text-normal)]">SSH Host or Alias</span>
+                        <input
+                          value={remoteSshHost}
+                          onChange={(event) => setRemoteSshHost(event.target.value)}
+                          placeholder="e.g., conductor-dev or 203.0.113.10"
+                          className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 text-[14px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+                        />
+                      </label>
+
+                      <label className="block">
+                        <span className="mb-1.5 block text-[12px] font-medium text-[var(--vk-text-normal)]">SSH User (optional)</span>
+                        <input
+                          value={remoteSshUser}
+                          onChange={(event) => setRemoteSshUser(event.target.value)}
+                          placeholder="e.g., ubuntu"
+                          className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 text-[14px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+                        />
+                      </label>
+                    </div>
+
+                    <p className="text-[12px] text-[var(--vk-text-muted)]">
+                      One-click remote open currently supports VS Code and VS Code Insiders. Other editors will still
+                      save as your preference, but they will not get a remote launch button yet.
+                    </p>
+                  </section>
+                  )}
+
+                  <section className="space-y-2">
+                    <h4 className="text-[15px] font-medium text-[var(--vk-text-strong)]">Markdown Editor</h4>
+                    <p className="text-[12px] text-[var(--vk-text-muted)]">
+                      Used as your second-brain markdown source when feeding context into tasks.
+                    </p>
+                    <div className="grid gap-2 sm:grid-cols-2">
+                      {MARKDOWN_EDITOR_OPTIONS.map((option) => {
+                        const selected = markdownEditor === option.id;
+                        return (
+                          <button
+                            key={option.id}
+                            type="button"
+                            onClick={() => setMarkdownEditor(option.id)}
+                            className={`flex items-center gap-2 rounded-[4px] border px-3 py-2 text-left ${
+                              selected
+                                ? "border-[var(--vk-orange)] bg-[var(--vk-bg-hover)]"
+                                : "border-[var(--vk-border)] hover:bg-[var(--vk-bg-hover)]"
+                            }`}
+                          >
+                            <MarkdownEditorIcon editorId={option.id} />
+                            <span className="flex-1 text-[13px] text-[var(--vk-text-normal)]">{option.label}</span>
+                            {selected && <Check className="h-3.5 w-3.5 text-[var(--vk-orange)]" />}
+                          </button>
+                        );
+                      })}
+                    </div>
+                  </section>
+
+                  <section className="space-y-2">
+                    <h4 className="text-[15px] font-medium text-[var(--vk-text-strong)]">Notification Sound</h4>
+                    <p className="text-[12px] text-[var(--vk-text-muted)]">Pick a sound for notifications, or disable sound.</p>
+                    <div className="grid gap-2 sm:grid-cols-2">
+                      {NOTIFICATION_SOUND_OPTIONS.map((option) => {
+                        const selected = soundEnabled && soundFile === option.id;
+                        return (
+                          <button
+                            key={option.id}
+                            type="button"
+                            onClick={() => {
+                              setSoundEnabled(true);
+                              setSoundFile(option.id);
+                            }}
+                            className={`flex items-center gap-2 rounded-[4px] border px-3 py-2 text-left ${
+                              selected
+                                ? "border-[var(--vk-orange)] bg-[var(--vk-bg-hover)]"
+                                : "border-[var(--vk-border)] hover:bg-[var(--vk-bg-hover)]"
+                            }`}
+                          >
+                            <Volume2 className="h-4 w-4 text-[var(--vk-text-muted)]" />
+                            <span className="flex-1 text-[13px] text-[var(--vk-text-normal)]">{option.label}</span>
+                            {selected && <Check className="h-3.5 w-3.5 text-[var(--vk-orange)]" />}
+                          </button>
+                        );
+                      })}
+                      <button
+                        type="button"
+                        onClick={() => setSoundEnabled(false)}
+                        className={`flex items-center gap-2 rounded-[4px] border px-3 py-2 text-left ${
+                          !soundEnabled
+                            ? "border-[var(--vk-orange)] bg-[var(--vk-bg-hover)]"
+                            : "border-[var(--vk-border)] hover:bg-[var(--vk-bg-hover)]"
+                        }`}
+                      >
+                        <VolumeX className="h-4 w-4 text-[var(--vk-text-muted)]" />
+                        <span className="flex-1 text-[13px] text-[var(--vk-text-normal)]">No sound</span>
+                        {!soundEnabled && <Check className="h-3.5 w-3.5 text-[var(--vk-orange)]" />}
+                      </button>
+                    </div>
+                  </section>
+                    </>
+                  )}
+
+                  {isRemoteAccessTab && (
+                  <section className="space-y-3">
+                    <div className="space-y-1">
+                      <h4 className="text-[15px] font-medium text-[var(--vk-text-strong)]">Remote Access</h4>
+                      <p className="text-[12px] text-[var(--vk-text-muted)]">
+                        Use your local Remote-SSH editor to jump straight into a remote worktree. This complements
+                        ngrok or Cloudflare Tunnel for dashboard access; it does not replace the tunnel.
+                      </p>
+                    </div>
+
+                    <div className="grid gap-3 sm:grid-cols-2">
+                      <label className="block">
+                        <span className="mb-1.5 block text-[12px] font-medium text-[var(--vk-text-normal)]">SSH Host or Alias</span>
+                        <input
+                          value={remoteSshHost}
+                          onChange={(event) => setRemoteSshHost(event.target.value)}
+                          placeholder="e.g., conductor-dev or 203.0.113.10"
+                          className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 text-[14px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+                        />
+                      </label>
+
+                      <label className="block">
+                        <span className="mb-1.5 block text-[12px] font-medium text-[var(--vk-text-normal)]">SSH User (optional)</span>
+                        <input
+                          value={remoteSshUser}
+                          onChange={(event) => setRemoteSshUser(event.target.value)}
+                          placeholder="e.g., ubuntu"
+                          className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 text-[14px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+                        />
+                      </label>
+                    </div>
+
+                    <p className="text-[12px] text-[var(--vk-text-muted)]">
+                      One-click remote open currently supports VS Code and VS Code Insiders. Other editors will still
+                      save as your preference, but they will not get a remote launch button yet.
+                    </p>
+                  </section>
+                  )}
+                </div>
+              ) : isRepositoriesTab ? (
+                <div className="space-y-5">
+                  <section className="space-y-1">
+                    <h4 className="text-[24px] leading-[24px] text-[var(--vk-text-strong)]">
+                      {isOnboarding ? "Repository Defaults" : "Repository Configuration"}
+                    </h4>
+                    <p className="text-[14px] text-[var(--vk-text-muted)]">
+                      {isOnboarding
+                        ? "Review the repository Conductor will use for this workspace. You can edit advanced scripts later from Settings."
+                        : "Configure scripts and defaults used whenever this repository is selected for workspaces."}
+                    </p>
+                  </section>
+
+                  {(mode === "settings" || repositories.length > 1) && (
+                    <section className="space-y-2">
+                      <label className="block">
+                        <span className="mb-1.5 block text-[12px] font-medium text-[var(--vk-text-normal)]">Select Repository</span>
+                        <select
+                          value={selectedRepositoryId}
+                          onChange={(event) => setSelectedRepositoryId(event.target.value)}
+                          disabled={repositoriesLoading || repositories.length === 0 || isBusy}
+                          className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-[var(--vk-bg-panel)] px-2 text-[13px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)] disabled:opacity-60"
+                        >
+                          {repositories.length === 0 && <option value="">No repositories configured</option>}
+                          {repositories.map((repository) => (
+                            <option key={repository.id} value={repository.id}>
+                              {repository.displayName}
+                            </option>
+                          ))}
+                        </select>
+                      </label>
+                      <p className="text-[12px] text-[var(--vk-text-muted)]">
+                        Select a repository to view and edit its configuration.
+                      </p>
+                      {repositoriesLoading && (
+                        <p className="text-[12px] text-[var(--vk-text-muted)]">Loading repositories...</p>
+                      )}
+                    </section>
+                  )}
+
+                  {isOnboarding && repositories.length === 1 && repositoryDraft && (
+                    <label className="block">
+                      <span className="mb-1.5 block text-[12px] font-medium text-[var(--vk-text-normal)]">Detected Repository</span>
+                      <div className="rounded-[4px] border border-[var(--vk-border)] bg-[rgba(15,15,15,0.52)] px-3 py-3 text-[13px] text-[var(--vk-text-normal)]">
+                        {repositoryDraft.displayName}
+                        <span className="ml-2 text-[var(--vk-text-muted)]">{repositoryDraft.path}</span>
+                      </div>
+                    </label>
+                  )}
+
+                  {repositoryDraft && (
+                    <>
+                      {mode === "settings" && (
+                        <section className="space-y-3 border-t border-[var(--vk-border)] pt-4">
+                        <div className="space-y-1">
+                          <h5 className="text-[22px] leading-[22px] text-[var(--vk-text-strong)]">Repo-Preseed Bootstrap</h5>
+                          <p className="text-[13px] text-[var(--vk-text-muted)]">
+                            Use this when you already know the target repository and want one command to prefill it. The
+                            default first-run path is still `npx conductor-oss@latest`, which opens the dashboard and lets
+                            the user choose preferences before adding a project.
+                          </p>
+                        </div>
+
+                        <div className="flex flex-wrap gap-2 text-[11px] text-[var(--vk-text-muted)]">
+                          <span className="rounded-[999px] border border-[var(--vk-border)] px-2 py-1">
+                            Workspace: {repositoryDraft.workspaceMode}
+                          </span>
+                          <span className="rounded-[999px] border border-[var(--vk-border)] px-2 py-1">
+                            Runtime: {repositoryDraft.runtimeMode}
+                          </span>
+                          <span className="rounded-[999px] border border-[var(--vk-border)] px-2 py-1">
+                            SCM: {repositoryDraft.scmMode}
+                          </span>
+                        </div>
+
+                        <div className="rounded-[4px] border border-[var(--vk-border)] bg-[rgba(15,15,15,0.72)] p-3">
+                          <pre className="overflow-x-auto whitespace-pre-wrap break-all text-[12px] leading-5 text-[var(--vk-text-normal)]">
+                            {repositoryBootstrapCommand}
+                          </pre>
+                        </div>
+
+                        <div className="flex flex-wrap items-center justify-between gap-2">
+                          <p className="text-[12px] text-[var(--vk-text-muted)]">
+                            This command uses your selected agent, editor, and notes app. Best on macOS with Homebrew.
+                            GitHub sign-in still opens a browser so the user can approve access.
+                          </p>
+                          <CopySnippetButton value={repositoryBootstrapCommand} idleLabel="Copy Setup Command" />
+                        </div>
+                        </section>
+                      )}
+
+                      <section className="space-y-3 border-t border-[var(--vk-border)] pt-4">
+                        <h5 className="text-[22px] leading-[22px] text-[var(--vk-text-strong)]">General Settings</h5>
+                        <p className="text-[13px] text-[var(--vk-text-muted)]">Configure basic repository information.</p>
+
+                        <label className="block">
+                          <span className="mb-1.5 block text-[12px] font-medium text-[var(--vk-text-normal)]">Display Name</span>
+                          <input
+                            value={repositoryDraft.displayName}
+                            onChange={(event) => setRepositoryDraft((prev) => prev ? { ...prev, displayName: event.target.value } : prev)}
+                            className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 text-[14px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+                          />
+                          <p className="mt-1 text-[12px] text-[var(--vk-text-muted)]">A friendly name for this repository.</p>
+                        </label>
+
+                        <label className="block">
+                          <span className="mb-1.5 block text-[12px] font-medium text-[var(--vk-text-normal)]">Repository Slug</span>
+                          <input
+                            value={repositoryDraft.repo}
+                            onChange={(event) => setRepositoryDraft((prev) => prev ? { ...prev, repo: event.target.value } : prev)}
+                            placeholder="e.g., your-org/your-repo"
+                            className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 text-[14px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+                          />
+                          <p className="mt-1 text-[12px] text-[var(--vk-text-muted)]">Used for PR tracking, GitHub links, and onboarding defaults.</p>
+                        </label>
+
+                        <label className="block">
+                          <span className="mb-1.5 block text-[12px] font-medium text-[var(--vk-text-normal)]">Default Agent</span>
+                          <select
+                            value={repositoryDraft.agent}
+                            onChange={(event) => {
+                              const nextAgent = event.target.value;
+                              setRepositoryDraft((prev) => prev ? { ...prev, agent: nextAgent } : prev);
+                              setRepositoryModelSelection(buildModelSelection(nextAgent, modelAccess, runtimeModelCatalogs, null));
+                            }}
+                            className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-[var(--vk-bg-panel)] px-2 text-[13px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+                          >
+                            {orderedAgentOptions.map((agent) => (
+                              <option key={agent} value={agent}>
+                                {getAgentLabel(agent)}
+                              </option>
+                            ))}
+                          </select>
+                          <p className="mt-1 text-[12px] text-[var(--vk-text-muted)]">Used by the one-line bootstrap and as the project default when tasks dispatch.</p>
+                        </label>
+
+                        {supportsAgentModelSelection(repositoryDraft.agent) && (
+                          <div className="rounded-[4px] border border-[var(--vk-border)] px-3 py-3">
+                            <AgentModelSelector
+                              agent={repositoryDraft.agent}
+                              modelAccess={modelAccess}
+                              runtimeModelCatalogs={runtimeModelCatalogs}
+                              selection={repositoryModelSelection}
+                              onChange={setRepositoryModelSelection}
+                            />
+                          </div>
+                        )}
+
+                        <label className="block">
+                          <span className="mb-1.5 block text-[12px] font-medium text-[var(--vk-text-normal)]">Repository Path</span>
+                          <div className="flex items-center gap-2">
+                            <input
+                              value={repositoryDraft.path}
+                              readOnly
+                              onClick={() => setRepositoryFolderPickerOpen(true)}
+                              placeholder="Use Browse to select a repository folder"
+                              className="h-9 w-full cursor-pointer rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 text-[13px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+                            />
+                            <button
+                              type="button"
+                              onClick={() => setRepositoryFolderPickerOpen(true)}
+                              disabled={isBusy}
+                              className="inline-flex h-9 items-center rounded-[4px] border border-[var(--vk-border)] px-2 text-[12px] text-[var(--vk-text-normal)] hover:bg-[var(--vk-bg-hover)] disabled:opacity-60"
+                            >
+                              <FolderOpen className="h-4 w-4" />
+                            </button>
+                          </div>
+                          {!repositoryDraft.pathHealth.exists && (
+                            <p className="mt-1 text-[12px] text-[var(--vk-red)]">Configured path does not exist on disk.</p>
+                          )}
+                          {repositoryDraft.pathHealth.exists && !repositoryDraft.pathHealth.isGitRepository && (
+                            <p className="mt-1 text-[12px] text-[var(--vk-red)]">Configured path exists but is not a git repository.</p>
+                          )}
+                          {repositoryDraft.pathHealth.suggestedPath && (
+                            <button
+                              type="button"
+                              onClick={() => {
+                                const suggestedPath = repositoryDraft.pathHealth.suggestedPath ?? "";
+                                if (!suggestedPath) return;
+                                setRepositoryDraft((prev) => prev
+                                  ? {
+                                      ...prev,
+                                      path: suggestedPath,
+                                      pathHealth: {
+                                        ...prev.pathHealth,
+                                        exists: true,
+                                        isGitRepository: true,
+                                        suggestedPath: null,
+                                      },
+                                    }
+                                  : prev);
+                                void detectRepositoryBranches(suggestedPath);
+                              }}
+                              className="mt-1 inline-flex h-7 items-center rounded-[4px] border border-[var(--vk-border)] px-2 text-[11px] text-[var(--vk-text-normal)] hover:bg-[var(--vk-bg-hover)]"
+                            >
+                              Use detected git repo path
+                            </button>
+                          )}
+                        </label>
+
+                        <label className="block">
+                          <span className="mb-1.5 block text-[12px] font-medium text-[var(--vk-text-normal)]">Default Working Directory</span>
+                          <input
+                            value={repositoryDraft.defaultWorkingDirectory}
+                            onChange={(event) => setRepositoryDraft((prev) => prev ? { ...prev, defaultWorkingDirectory: event.target.value } : prev)}
+                            placeholder="e.g., packages/frontend"
+                            className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 text-[14px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+                          />
+                          <p className="mt-1 text-[12px] text-[var(--vk-text-muted)]">
+                            Subdirectory relative to the repository root where the coding agent starts.
+                          </p>
+                        </label>
+
+                        <label className="block">
+                          <span className="mb-1.5 block text-[12px] font-medium text-[var(--vk-text-normal)]">Default Target Branch</span>
+                          <div className="flex items-center gap-2">
+                            <input
+                              value={repositoryDraft.defaultBranch}
+                              onChange={(event) => setRepositoryDraft((prev) => prev ? { ...prev, defaultBranch: event.target.value } : prev)}
+                              placeholder="Select a branch"
+                              className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 text-[14px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+                            />
+                            <button
+                              type="button"
+                              onClick={() => {
+                                void detectRepositoryBranches();
+                              }}
+                              disabled={repositoryBranchesLoading}
+                              className="inline-flex h-9 items-center rounded-[4px] border border-[var(--vk-border)] px-2 text-[12px] text-[var(--vk-text-normal)] hover:bg-[var(--vk-bg-hover)] disabled:opacity-60"
+                              title="Detect branches"
+                            >
+                              {repositoryBranchesLoading ? (
+                                <Loader2 className="h-3.5 w-3.5 animate-spin" />
+                              ) : (
+                                <RefreshCcw className="h-3.5 w-3.5" />
+                              )}
+                            </button>
+                          </div>
+                          {repositoryBranchOptions.length > 0 && (
+                            <select
+                              value={repositoryDraft.defaultBranch}
+                              onChange={(event) => setRepositoryDraft((prev) => prev ? { ...prev, defaultBranch: event.target.value } : prev)}
+                              className="mt-2 h-8 w-full rounded-[4px] border border-[var(--vk-border)] bg-[var(--vk-bg-panel)] px-2 text-[12px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+                            >
+                              {repositoryBranchOptions.map((branch) => (
+                                <option key={branch} value={branch}>
+                                  {branch}
+                                </option>
+                              ))}
+                            </select>
+                          )}
+                          {repositoryBranchesError && (
+                            <p className="mt-1 text-[12px] text-[var(--vk-red)]">{repositoryBranchesError}</p>
+                          )}
+                        </label>
+                      </section>
+
+                      {mode === "settings" && (
+                        <section className="space-y-3 border-t border-[var(--vk-border)] pt-4">
+                        <h5 className="text-[22px] leading-[22px] text-[var(--vk-text-strong)]">Scripts & Configuration</h5>
+                        <p className="text-[13px] text-[var(--vk-text-muted)]">
+                          Configure dev server, setup, cleanup, archive, and file-copy behavior for this repository.
+                        </p>
+
+                        <label className="block">
+                          <span className="mb-1.5 block text-[12px] font-medium text-[var(--vk-text-normal)]">Dev Server Script</span>
+                          <textarea
+                            rows={3}
+                            value={repositoryDraft.devServerScript}
+                            onChange={(event) => setRepositoryDraft((prev) => prev ? { ...prev, devServerScript: event.target.value } : prev)}
+                            placeholder="npm run dev"
+                            className="w-full rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 py-2 text-[13px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+                          />
+                          <p className="mt-1 text-[12px] text-[var(--vk-text-muted)]">Starts a development server for this repository.</p>
+                        </label>
+
+                        <label className="block">
+                          <span className="mb-1.5 block text-[12px] font-medium text-[var(--vk-text-normal)]">Setup Script</span>
+                          <textarea
+                            rows={4}
+                            value={repositoryDraft.setupScript}
+                            onChange={(event) => setRepositoryDraft((prev) => prev ? { ...prev, setupScript: event.target.value } : prev)}
+                            placeholder="npm install"
+                            className="w-full rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 py-2 text-[13px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+                          />
+                          <p className="mt-1 text-[12px] text-[var(--vk-text-muted)]">
+                            Runs in the worktree after creation and before/with coding-agent startup.
+                          </p>
+                        </label>
+
+                        <label className="flex items-start gap-2 rounded-[4px] border border-[var(--vk-border)] px-3 py-2 text-[13px] text-[var(--vk-text-normal)]">
+                          <input
+                            type="checkbox"
+                            checked={repositoryDraft.runSetupInParallel}
+                            onChange={(event) => setRepositoryDraft((prev) => prev ? { ...prev, runSetupInParallel: event.target.checked } : prev)}
+                            className="mt-0.5 h-4 w-4 rounded border border-[var(--vk-border)] bg-transparent accent-[var(--vk-orange)]"
+                          />
+                          <span>Run setup script in parallel with coding agent</span>
+                        </label>
+
+                        <label className="block">
+                          <span className="mb-1.5 block text-[12px] font-medium text-[var(--vk-text-normal)]">Cleanup Script</span>
+                          <textarea
+                            rows={4}
+                            value={repositoryDraft.cleanupScript}
+                            onChange={(event) => setRepositoryDraft((prev) => prev ? { ...prev, cleanupScript: event.target.value } : prev)}
+                            placeholder="Runs when the workspace is archived and changes exist"
+                            className="w-full rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 py-2 text-[13px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+                          />
+                        </label>
+
+                        <label className="block">
+                          <span className="mb-1.5 block text-[12px] font-medium text-[var(--vk-text-normal)]">Archive Script</span>
+                          <textarea
+                            rows={4}
+                            value={repositoryDraft.archiveScript}
+                            onChange={(event) => setRepositoryDraft((prev) => prev ? { ...prev, archiveScript: event.target.value } : prev)}
+                            placeholder="Runs when the workspace/session is archived"
+                            className="w-full rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 py-2 text-[13px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+                          />
+                        </label>
+
+                        <label className="block">
+                          <span className="mb-1.5 block text-[12px] font-medium text-[var(--vk-text-normal)]">Copy Files</span>
+                          <input
+                            value={repositoryDraft.copyFiles}
+                            onChange={(event) => setRepositoryDraft((prev) => prev ? { ...prev, copyFiles: event.target.value } : prev)}
+                            placeholder=".env, config/*.json"
+                            className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 text-[13px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)]"
+                          />
+                          <p className="mt-1 text-[12px] text-[var(--vk-text-muted)]">
+                            Comma-separated relative file paths or glob patterns copied from the repo to each worktree.
+                          </p>
+                        </label>
+                        </section>
+                      )}
+                    </>
+                  )}
+                </div>
+              ) : isOrganizationTab ? (
+                <div className="space-y-5">
+                  <section className="rounded-[6px] border border-[var(--vk-border)] bg-[rgba(234,122,42,0.06)] px-4 py-3">
+                    <h4 className="text-[15px] font-medium text-[var(--vk-text-strong)]">Security-First Remote Access</h4>
+                    <p className="mt-1 text-[12px] leading-5 text-[var(--vk-text-muted)]">
+                      The dashboard stays bound to localhost. For phone and team access, put a verified edge
+                      identity layer like Cloudflare Access in front of it, then map authenticated users into
+                      viewer, operator, or admin roles here.
+                    </p>
+                  </section>
+
+                  {accessLoading ? (
+                    <section className="flex items-center gap-2 rounded-[6px] border border-[var(--vk-border)] px-4 py-4 text-[13px] text-[var(--vk-text-muted)]">
+                      <Loader2 className="h-4 w-4 animate-spin" />
+                      Loading organization access settings...
+                    </section>
+                  ) : (
+                    <>
+                      <section className="grid gap-3 lg:grid-cols-3">
+                        <div className="rounded-[6px] border border-[var(--vk-border)] px-4 py-3">
+                          <span className="text-[11px] uppercase tracking-[0.12em] text-[var(--vk-text-muted)]">
+                            Current Identity
+                          </span>
+                          <p className="mt-2 text-[14px] text-[var(--vk-text-normal)]">
+                            {accessSettings.current.email ?? "Anonymous local session"}
+                          </p>
+                        </div>
+                        <div className="rounded-[6px] border border-[var(--vk-border)] px-4 py-3">
+                          <span className="text-[11px] uppercase tracking-[0.12em] text-[var(--vk-text-muted)]">
+                            Effective Role
+                          </span>
+                          <p className="mt-2 text-[14px] text-[var(--vk-text-normal)]">
+                            {accessSettings.current.role ?? "No access"}
+                          </p>
+                        </div>
+                        <div className="rounded-[6px] border border-[var(--vk-border)] px-4 py-3">
+                          <span className="text-[11px] uppercase tracking-[0.12em] text-[var(--vk-text-muted)]">
+                            Auth Provider
+                          </span>
+                          <p className="mt-2 text-[14px] text-[var(--vk-text-normal)]">
+                            {accessSettings.current.provider ?? "Local only"}
+                          </p>
+                        </div>
+                      </section>
+
+                      {!accessCanEdit && (
+                        <section className="rounded-[6px] border border-[var(--vk-border)] bg-[rgba(80,80,80,0.18)] px-4 py-3">
+                          <p className="text-[12px] leading-5 text-[var(--vk-text-muted)]">
+                            You can review organization security here, but only an admin session can save changes.
+                            Use the built-in unlock link, a local admin session, or an admin identity from your edge
+                            auth provider to modify access rules.
+                          </p>
+                        </section>
+                      )}
+
+                      <section className="space-y-3 rounded-[6px] border border-[var(--vk-border)] px-4 py-4">
+                        <div className="space-y-1">
+                          <h5 className="text-[18px] leading-[20px] text-[var(--vk-text-strong)]">Baseline Access Rules</h5>
+                          <p className="text-[12px] text-[var(--vk-text-muted)]">
+                            Require authentication for every dashboard request and decide what authenticated users get
+                            by default before explicit role bindings are applied.
+                          </p>
+                        </div>
+
+                        <label className="flex items-start gap-2 rounded-[4px] border border-[var(--vk-border)] px-3 py-2 text-[13px] text-[var(--vk-text-normal)]">
+                          <input
+                            type="checkbox"
+                            checked={accessSettings.requireAuth}
+                            onChange={(event) => setAccessSettings((prev) => ({
+                              ...prev,
+                              requireAuth: event.target.checked,
+                            }))}
+                            disabled={!accessCanEdit || accessSaving}
+                            className="mt-0.5 h-4 w-4 rounded border border-[var(--vk-border)] bg-transparent accent-[var(--vk-orange)]"
+                          />
+                          <span>Require authentication even on localhost</span>
+                        </label>
+
+                        <label className="block">
+                          <span className="mb-1.5 block text-[12px] font-medium text-[var(--vk-text-normal)]">Default Role</span>
+                          <select
+                            value={accessSettings.defaultRole}
+                            onChange={(event) => setAccessSettings((prev) => ({
+                              ...prev,
+                              defaultRole: event.target.value as DashboardRole,
+                            }))}
+                            disabled={!accessCanEdit || accessSaving}
+                            className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-[var(--vk-bg-panel)] px-2 text-[13px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)] disabled:opacity-60"
+                          >
+                            <option value="viewer">Viewer</option>
+                            <option value="operator">Operator</option>
+                            <option value="admin">Admin</option>
+                          </select>
+                          <p className="mt-1 text-[12px] text-[var(--vk-text-muted)]">
+                            This applies after identity verification when no explicit email or domain binding matches.
+                          </p>
+                        </label>
+                      </section>
+
+                      <section className="space-y-3 rounded-[6px] border border-[var(--vk-border)] px-4 py-4">
+                        <div className="space-y-1">
+                          <h5 className="text-[18px] leading-[20px] text-[var(--vk-text-strong)]">Verified Edge Auth</h5>
+                          <p className="text-[12px] text-[var(--vk-text-muted)]">
+                            Recommended for secure public phone access and free team collaboration. Conductor verifies
+                            the Cloudflare Access JWT instead of trusting a raw email header.
+                          </p>
+                        </div>
+
+                        <label className="flex items-start gap-2 rounded-[4px] border border-[var(--vk-border)] px-3 py-2 text-[13px] text-[var(--vk-text-normal)]">
+                          <input
+                            type="checkbox"
+                            checked={accessSettings.trustedHeaders.enabled}
+                            onChange={(event) => setAccessSettings((prev) => ({
+                              ...prev,
+                              trustedHeaders: {
+                                ...prev.trustedHeaders,
+                                enabled: event.target.checked,
+                              },
+                            }))}
+                            disabled={!accessCanEdit || accessSaving}
+                            className="mt-0.5 h-4 w-4 rounded border border-[var(--vk-border)] bg-transparent accent-[var(--vk-orange)]"
+                          />
+                          <span>Enable verified Cloudflare Access authentication</span>
+                        </label>
+
+                        <div className="grid gap-3 lg:grid-cols-2">
+                          <label className="block">
+                            <span className="mb-1.5 block text-[12px] font-medium text-[var(--vk-text-normal)]">Provider</span>
+                            <select
+                              value={accessSettings.trustedHeaders.provider}
+                              onChange={(event) => setAccessSettings((prev) => ({
+                                ...prev,
+                                trustedHeaders: {
+                                  ...prev.trustedHeaders,
+                                  provider: event.target.value as TrustedHeaderAccessProvider,
+                                },
+                              }))}
+                              disabled={!accessCanEdit || accessSaving}
+                              className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-[var(--vk-bg-panel)] px-2 text-[13px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)] disabled:opacity-60"
+                            >
+                              <option value="cloudflare-access">Cloudflare Access (verified JWT)</option>
+                              <option value="generic">Generic header passthrough (advanced)</option>
+                            </select>
+                          </label>
+
+                          <label className="block">
+                            <span className="mb-1.5 block text-[12px] font-medium text-[var(--vk-text-normal)]">Identity Email Header</span>
+                            <input
+                              value={accessSettings.trustedHeaders.emailHeader}
+                              onChange={(event) => setAccessSettings((prev) => ({
+                                ...prev,
+                                trustedHeaders: {
+                                  ...prev.trustedHeaders,
+                                  emailHeader: event.target.value,
+                                },
+                              }))}
+                              disabled={!accessCanEdit || accessSaving}
+                              className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 text-[13px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)] disabled:opacity-60"
+                            />
+                          </label>
+
+                          <label className="block">
+                            <span className="mb-1.5 block text-[12px] font-medium text-[var(--vk-text-normal)]">JWT Assertion Header</span>
+                            <input
+                              value={accessSettings.trustedHeaders.jwtHeader}
+                              onChange={(event) => setAccessSettings((prev) => ({
+                                ...prev,
+                                trustedHeaders: {
+                                  ...prev.trustedHeaders,
+                                  jwtHeader: event.target.value,
+                                },
+                              }))}
+                              disabled={!accessCanEdit || accessSaving}
+                              className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 text-[13px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)] disabled:opacity-60"
+                            />
+                          </label>
+
+                          <label className="block">
+                            <span className="mb-1.5 block text-[12px] font-medium text-[var(--vk-text-normal)]">Cloudflare Team Domain</span>
+                            <input
+                              value={accessSettings.trustedHeaders.teamDomain}
+                              onChange={(event) => setAccessSettings((prev) => ({
+                                ...prev,
+                                trustedHeaders: {
+                                  ...prev.trustedHeaders,
+                                  teamDomain: event.target.value,
+                                },
+                              }))}
+                              disabled={!accessCanEdit || accessSaving}
+                              placeholder="your-team.cloudflareaccess.com"
+                              className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 text-[13px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)] disabled:opacity-60"
+                            />
+                          </label>
+
+                          <label className="block lg:col-span-2">
+                            <span className="mb-1.5 block text-[12px] font-medium text-[var(--vk-text-normal)]">Cloudflare Access Audience</span>
+                            <input
+                              value={accessSettings.trustedHeaders.audience}
+                              onChange={(event) => setAccessSettings((prev) => ({
+                                ...prev,
+                                trustedHeaders: {
+                                  ...prev.trustedHeaders,
+                                  audience: event.target.value,
+                                },
+                              }))}
+                              disabled={!accessCanEdit || accessSaving}
+                              placeholder="Copy the AUD value from your Cloudflare Access application"
+                              className="h-9 w-full rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 text-[13px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)] disabled:opacity-60"
+                            />
+                          </label>
+                        </div>
+
+                        {accessSettings.trustedHeaders.provider === "generic" && (
+                          <p className="rounded-[4px] border border-[var(--vk-red)]/35 bg-[var(--vk-red)]/10 px-3 py-2 text-[12px] leading-5 text-[var(--vk-red)]">
+                            Generic header passthrough is only safe when your reverse proxy strips user-supplied headers
+                            and injects identity itself. Conductor blocks this mode by default unless
+                            `CONDUCTOR_ALLOW_INSECURE_TRUSTED_HEADERS=true` is also set.
+                          </p>
+                        )}
+                      </section>
+
+                      <section className="space-y-3 rounded-[6px] border border-[var(--vk-border)] px-4 py-4">
+                        <div className="space-y-1">
+                          <h5 className="text-[18px] leading-[20px] text-[var(--vk-text-strong)]">Role Bindings</h5>
+                          <p className="text-[12px] text-[var(--vk-text-muted)]">
+                            Map verified team identities into least-privilege roles. `viewer` can inspect work, `operator`
+                            can control agents, and `admin` can change global settings.
+                          </p>
+                        </div>
+
+                        <div className="grid gap-3 lg:grid-cols-2">
+                          {accessRoleFields.map(({ label, key, placeholder }) => (
+                            <label key={key} className="block">
+                              <span className="mb-1.5 block text-[12px] font-medium text-[var(--vk-text-normal)]">{label}</span>
+                              <textarea
+                                rows={4}
+                                value={accessSettings.roles[key]}
+                                onChange={(event) => setAccessSettings((prev) => ({
+                                  ...prev,
+                                  roles: {
+                                    ...prev.roles,
+                                    [key]: event.target.value,
+                                  },
+                                }))}
+                                disabled={!accessCanEdit || accessSaving}
+                                placeholder={placeholder}
+                                className="w-full rounded-[4px] border border-[var(--vk-border)] bg-transparent px-2 py-2 text-[13px] text-[var(--vk-text-normal)] outline-none focus:border-[var(--vk-orange)] disabled:opacity-60"
+                              />
+                              <p className="mt-1 text-[11px] text-[var(--vk-text-muted)]">One entry per line.</p>
+                            </label>
+                          ))}
+                        </div>
+                      </section>
+                    </>
+                  )}
+                </div>
+              ) : (
+                <section className="space-y-3">
+                  <h4 className="text-[16px] font-medium text-[var(--vk-text-strong)]">{activeTabItem.label}</h4>
+                  <p className="text-[14px] text-[var(--vk-text-muted)]">
+                    This section is queued for implementation. General, Agents, Remote Access, and repository settings are available now.
+                  </p>
+                  <button
+                    type="button"
+                    onClick={() => setActiveTab("general")}
+                    className="inline-flex h-9 items-center rounded-[4px] border border-[var(--vk-border)] px-3 text-[13px] text-[var(--vk-text-normal)] hover:bg-[var(--vk-bg-hover)]"
+                  >
+                    Open General
+                  </button>
+                </section>
+              )}
+            </div>
+
+            <footer className="flex flex-col gap-3 border-t border-[var(--vk-border)] px-4 py-3 sm:flex-row sm:items-center sm:justify-between sm:gap-2">
+              <div className="min-w-0">
+                {dialogError && (
+                  <p className="truncate rounded-[4px] border border-[var(--vk-red)]/35 bg-[var(--vk-red)]/10 px-2 py-1 text-[12px] text-[var(--vk-red)]">
+                    {dialogError}
+                  </p>
+                )}
+                {!dialogError && isPreferenceFormTab && (
+                  <p className="text-[11px] text-[var(--vk-text-muted)]">
+                    {isOnboarding
+                      ? "Finish setup once here. You can change these preferences any time from Settings."
+                      : "Preferences are saved to your conductor config and applied immediately."}
+                  </p>
+                )}
+                {!dialogError && isRepositoriesTab && (
+                  <p className="text-[11px] text-[var(--vk-text-muted)]">
+                    {isOnboarding
+                      ? "These defaults will be used the first time workspaces and tasks are created for this repo."
+                      : "Repository settings are saved to your conductor config and used for future workspaces."}
+                  </p>
+                )}
+                {!dialogError && isOrganizationTab && (
+                  <p className="text-[11px] text-[var(--vk-text-muted)]">
+                    Organization access settings are written into `conductor.yaml`. Use admin role bindings for full
+                    control, operator bindings for day-to-day agent usage, and viewer bindings for read-only access.
+                  </p>
+                )}
+              </div>
+              <div className="flex w-full flex-wrap items-center justify-end gap-2 sm:w-auto">
+                {!isOnboarding && (
+                  <button
+                    type="button"
+                    onClick={onClose}
+                    disabled={isBusy}
+                    className="inline-flex h-9 items-center rounded-[4px] border border-[var(--vk-border)] px-3 text-[13px] text-[var(--vk-text-normal)] hover:bg-[var(--vk-bg-hover)] disabled:opacity-50"
+                  >
+                    Close
+                  </button>
+                )}
+                {isOnboarding && isRepositoriesTab && (
+                  <button
+                    type="button"
+                    onClick={() => setActiveTab("preferences")}
+                    disabled={isBusy}
+                    className="inline-flex h-9 items-center rounded-[4px] border border-[var(--vk-border)] px-3 text-[13px] text-[var(--vk-text-normal)] hover:bg-[var(--vk-bg-hover)] disabled:opacity-50"
+                  >
+                    Back
+                  </button>
+                )}
+                {isPreferenceFormTab && !isOnboarding && (
+                  <button
+                    type="button"
+                    onClick={() => {
+                      void handleSubmitPreferences(current.onboardingAcknowledged, { closeDialog: true });
+                    }}
+                    disabled={!canSubmitPreferences || creating}
+                    className="inline-flex h-9 items-center rounded-[4px] bg-[var(--vk-bg-active)] px-3 text-[13px] text-[var(--vk-text-strong)] hover:bg-[var(--vk-bg-hover)] disabled:opacity-50"
+                  >
+                    {creating ? (
+                      <>
+                        <Loader2 className="mr-1.5 h-3.5 w-3.5 animate-spin" />
+                        Saving...
+                      </>
+                    ) : "Save"}
+                  </button>
+                )}
+                {isRepositoriesTab && !isOnboarding && (
+                  <button
+                    type="button"
+                    onClick={() => {
+                      void handleSaveRepository();
+                    }}
+                    disabled={!canSaveRepository || repositoriesSaving || repositoriesLoading}
+                    className="inline-flex h-9 items-center rounded-[4px] bg-[var(--vk-bg-active)] px-3 text-[13px] text-[var(--vk-text-strong)] hover:bg-[var(--vk-bg-hover)] disabled:opacity-50"
+                  >
+                    {repositoriesSaving ? (
+                      <>
+                        <Loader2 className="mr-1.5 h-3.5 w-3.5 animate-spin" />
+                        Saving...
+                      </>
+                    ) : "Save Repository"}
+                  </button>
+                )}
+                {isOrganizationTab && !isOnboarding && (
+                  <button
+                    type="button"
+                    onClick={() => {
+                      void handleSaveAccess();
+                    }}
+                    disabled={!canSaveAccess || accessSaving}
+                    className="inline-flex h-9 items-center rounded-[4px] bg-[var(--vk-bg-active)] px-3 text-[13px] text-[var(--vk-text-strong)] hover:bg-[var(--vk-bg-hover)] disabled:opacity-50"
+                  >
+                    {accessSaving ? (
+                      <>
+                        <Loader2 className="mr-1.5 h-3.5 w-3.5 animate-spin" />
+                        Saving...
+                      </>
+                    ) : "Save Access"}
+                  </button>
+                )}
+                {isOnboarding && (
+                  <button
+                    type="button"
+                    onClick={() => {
+                      void (isPreferencesTab ? handleOnboardingContinue() : handleFinishOnboarding());
+                    }}
+                    disabled={
+                      isPreferencesTab
+                        ? !canSubmitPreferences || creating || repositoriesLoading
+                        : !canSaveRepository || isBusy
+                    }
+                    className="inline-flex h-9 items-center rounded-[4px] bg-[var(--vk-bg-active)] px-3 text-[13px] text-[var(--vk-text-strong)] hover:bg-[var(--vk-bg-hover)] disabled:opacity-50"
+                  >
+                    {isBusy || (isPreferencesTab && repositoriesLoading) ? (
+                      <>
+                        <Loader2 className="mr-1.5 h-3.5 w-3.5 animate-spin" />
+                        {isPreferencesTab && repositoriesLoading ? "Loading..." : "Saving..."}
+                      </>
+                    ) : isPreferencesTab ? (
+                      onboardingHasRepositoryStep ? "Continue" : "Finish Setup"
+                    ) : (
+                      "Finish Setup"
+                    )}
+                  </button>
+                )}
+              </div>
+            </footer>
+          </div>
+        </div>
+      </div>
+
+      <FolderPickerDialog
+        open={repositoryFolderPickerOpen}
+        initialPath={repositoryDraft?.path}
+        title="Select Repository Path"
+        description="Choose the local git repository folder."
+        onClose={() => setRepositoryFolderPickerOpen(false)}
+        onSelect={(selectedPath) => {
+          setRepositoryFolderPickerOpen(false);
+          if (!selectedPath) return;
+          setRepositoryDraft((prev) => prev
+            ? {
+                ...prev,
+                path: selectedPath,
+                pathHealth: {
+                  ...prev.pathHealth,
+                  exists: true,
+                  isGitRepository: true,
+                  suggestedPath: null,
+                },
+              }
+            : prev);
+          void detectRepositoryBranches(selectedPath);
+        }}
+      />
+    </>
+  );
+}