@geminilight/mindos 0.2.0 → 0.3.0

package/README.md

@@ -130,7 +130,7 @@ mindos onboard
 ```
 
 The setup wizard will guide you through:
-1. Knowledge base path → default `~/.mindos/my-mind`
+1. Knowledge base path → default `~/MindOS`
 2. Choose template (en / zh / empty / custom)
 3. Ports (Web UI + MCP)
 4. Auth token (auto-generated or passphrase-seeded)
@@ -153,7 +153,7 @@ Or skip the wizard and edit `~/.mindos/config.json` manually (see Config Referen
 
 ```json
 {
-  "mindRoot": "~/.mindos/my-mind",
+  "mindRoot": "~/MindOS",
   "port": 3000,
   "mcpPort": 8787,
   "authToken": "",
@@ -179,7 +179,7 @@ Or skip the wizard and edit `~/.mindos/config.json` manually (see Config Referen
 
 | Field | Default | Description |
 | :--- | :--- | :--- |
-| `mindRoot` | `~/.mindos/my-mind` | **Required**. Absolute path to the knowledge base root. |
+| `mindRoot` | `~/MindOS` | **Required**. Absolute path to the knowledge base root. |
 | `port` | `3000` | Optional. Web app port. |
 | `mcpPort` | `8787` | Optional. MCP server port. |
 | `authToken` | — | Optional. Protects App `/api/*` and MCP `/mcp` with bearer token auth. For Agent / MCP clients. Recommended when exposed to a network. |

package/README_zh.md

@@ -82,6 +82,7 @@ MindOS 是一个**人机协同心智系统**——基于本地优先的协作知
 - **引用同步**：通过引用与反向链接保持跨文件状态一致。
 - **知识图谱**：可视化笔记间关系与依赖。
 - **Git 时光机**：记录修改历史，支持审计与安全回滚。
+- **跨设备同步**：通过 Git 自动 commit、push、pull —— 一台设备的编辑几分钟内同步到所有设备。
 
 <details>
 <summary><strong>即将到来</strong></summary>
@@ -131,12 +132,13 @@ mindos onboard --install-daemon
 > `--install-daemon`：配置完成后，自动将 MindOS 安装为后台 OS 服务（关闭终端仍运行，崩溃自动重启）。
 
 配置向导将引导你完成：
-1. 知识库路径 → 默认 `~/.mindos/my-mind`
+1. 知识库路径 → 默认 `~/MindOS`
 2. 选择模板（en / zh / empty / custom）
 3. 端口配置（Web UI + MCP）
 4. Auth token（自动生成或口令派生）
 5. Web UI 访问密码（可选）
 6. 配置 AI Provider（Anthropic / OpenAI）+ API Key — 或选择 **skip**，稍后通过 `mindos config set` 补填
+7. 启动模式 — **后台服务**（推荐，开机自启）或前台运行
 
 配置自动保存到 `~/.mindos/config.json`。
 
@@ -153,34 +155,50 @@ mindos onboard --install-daemon
 
 ```json
 {
-  "mindRoot": "~/.mindos/my-mind",
+  "mindRoot": "~/MindOS",
   "port": 3000,
   "mcpPort": 8787,
   "authToken": "",
   "webPassword": "",
+  "startMode": "daemon",
   "ai": {
     "provider": "anthropic",
     "providers": {
       "anthropic": { "apiKey": "sk-ant-...", "model": "claude-sonnet-4-6" },
       "openai":    { "apiKey": "sk-...",     "model": "gpt-5.4", "baseUrl": "" }
     }
+  },
+  "sync": {
+    "enabled": true,
+    "provider": "git",
+    "remote": "origin",
+    "branch": "main",
+    "autoCommitInterval": 30,
+    "autoPullInterval": 300
   }
 }
 ```
 
 | 字段 | 默认值 | 说明 |
 | :--- | :--- | :--- |
-| `mindRoot` | `~/.mindos/my-mind` | **必填**。知识库根目录的绝对路径 |
+| `mindRoot` | `~/MindOS` | **必填**。知识库根目录的绝对路径 |
 | `port` | `3000` | 可选。Web 服务端口 |
 | `mcpPort` | `8787` | 可选。MCP 服务端口 |
 | `authToken` | — | 可选。保护 App `/api/*` 和 MCP `/mcp` 的 Bearer Token 认证。供 Agent / MCP 客户端使用，暴露到网络时建议设置 |
 | `webPassword` | — | 可选。为 Web UI 添加登录密码保护。供浏览器访问，与 `authToken` 相互独立 |
+| `startMode` | `start` | 启动模式：`daemon`（后台服务，开机自启）、`start`（前台）或 `dev` |
 | `ai.provider` | `anthropic` | 当前使用的 provider：`anthropic` 或 `openai` |
 | `ai.providers.anthropic.apiKey` | — | Anthropic API Key |
 | `ai.providers.anthropic.model` | `claude-sonnet-4-6` | Anthropic 模型 ID |
 | `ai.providers.openai.apiKey` | — | OpenAI API Key |
 | `ai.providers.openai.model` | `gpt-5.4` | OpenAI 模型 ID |
 | `ai.providers.openai.baseUrl` | — | 可选。用于代理或 OpenAI 兼容 API 的自定义接口地址 |
+| `sync.enabled` | `false` | 启用/禁用 Git 自动同步 |
+| `sync.provider` | `git` | 同步方式（目前仅支持 `git`） |
+| `sync.remote` | `origin` | Git 远程仓库名 |
+| `sync.branch` | `main` | 同步分支 |
+| `sync.autoCommitInterval` | `30` | 文件变更后自动 commit+push 的延迟秒数 |
+| `sync.autoPullInterval` | `300` | 自动从远程 pull 的间隔秒数 |
 
 多个 provider 可以同时配置，切换时只需修改 `ai.provider` 字段，无需重新填写 API Key。Shell 环境变量（`ANTHROPIC_API_KEY`、`OPENAI_API_KEY` 等）优先级高于配置文件。
 
@@ -192,6 +210,12 @@ mindos onboard --install-daemon
 > [!TIP]
 > 使用 `--install-daemon` 时，MindOS 会作为后台 OS 服务安装并自动启动，无需手动执行 `mindos start`。如果跳过了该参数，运行 `mindos start` 手动启动，或运行 `mindos update` 升级到最新版本。
 
+在浏览器中打开 Web UI：
+
+```bash
+mindos open
+```
+
 ### 3. 通过 MindOS Agent 注入你的个人心智
 
 1. 打开 MindOS GUI 中内置的 Agent 对话面板。
@@ -386,12 +410,13 @@ MindOS/
 ├── mcp/              # MCP Server — 将工具映射到 App API 的 HTTP 适配器
 ├── skills/           # MindOS Skills（`mindos`、`mindos-zh`）— Agent 工作流指南
 ├── templates/        # 预设模板（`en/`、`zh/`、`empty/`）— onboard 时复制到知识库目录
-├── bin/              # CLI 入口（`mindos onboard`、`mindos start`、`mindos dev`、`mindos token`）
+├── bin/              # CLI 入口（`mindos onboard`、`mindos start`、`mindos open`、`mindos sync`、`mindos token`）
 ├── scripts/          # 配置向导与辅助脚本
 └── README.md
 
 ~/.mindos/            # 用户数据目录（项目外，不会被提交）
-├── config.json       # 所有配置（AI 密钥、端口、Auth token、知识库路径）
+├── config.json       # 所有配置（AI 密钥、端口、Auth token、同步设置）
+├── sync-state.json   # 同步状态（最后同步时间、冲突文件）
 └── my-mind/          # 你的私有知识库（默认路径，onboard 时可自定义）
 ```
 
@@ -407,11 +432,19 @@ MindOS/
 | `mindos start --daemon` | 安装并以后台 OS 服务方式启动（关闭终端仍运行，崩溃自动重启） |
 | `mindos dev` | 启动 app + MCP 服务（开发模式，热更新） |
 | `mindos dev --turbopack` | 开发模式 + Turbopack（更快的 HMR） |
+| `mindos open` | 在默认浏览器中打开 Web UI |
 | `mindos stop` | 停止正在运行的 MindOS 进程 |
 | `mindos restart` | 停止后重新启动 |
 | `mindos build` | 手动构建生产版本 |
 | `mindos mcp` | 仅启动 MCP 服务 |
 | `mindos token` | 查看当前 Auth token 及 MCP 配置片段 |
+| `mindos sync` | 查看同步状态（`sync status` 的别名） |
+| `mindos sync init` | 交互式配置 Git 远程同步 |
+| `mindos sync status` | 查看同步状态：最后同步时间、未推送提交、冲突 |
+| `mindos sync now` | 手动触发完整同步（commit + push + pull） |
+| `mindos sync on` | 启用自动同步 |
+| `mindos sync off` | 禁用自动同步 |
+| `mindos sync conflicts` | 列出未解决的冲突文件 |
 | `mindos gateway install` | 安装后台服务（Linux 用 systemd，macOS 用 LaunchAgent） |
 | `mindos gateway uninstall` | 卸载后台服务 |
 | `mindos gateway start` | 启动后台服务 |

package/app/README.md

@@ -16,7 +16,7 @@ mindos dev      # or: mindos start
 
 ```bash
 npm install
-MIND_ROOT=~/.mindos/my-mind ANTHROPIC_API_KEY=sk-ant-... npm run dev
+MIND_ROOT=~/MindOS ANTHROPIC_API_KEY=sk-ant-... npm run dev
 # Or copy .env.local.example to app/.env.local and fill in values
 ```
 

package/app/app/api/init/route.ts

@@ -0,0 +1,22 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { getMindRoot } from '@/lib/fs';
+import { applyTemplate } from '@/lib/template';
+
+export async function POST(req: NextRequest) {
+  try {
+    const body = await req.json();
+    const template = body.template as string;
+
+    const mindRoot = getMindRoot();
+    applyTemplate(template, mindRoot);
+
+    return NextResponse.json({ ok: true, template });
+  } catch (e) {
+    console.error('[/api/init] Error:', e);
+    const msg = e instanceof Error ? e.message : String(e);
+    const status = msg.startsWith('Invalid template') ? 400
+      : msg.includes('not found') ? 404
+      : 500;
+    return NextResponse.json({ error: msg }, { status });
+  }
+}

package/app/app/api/settings/route.ts

@@ -112,6 +112,9 @@ export async function POST(req: NextRequest) {
       mindRoot: body.mindRoot ?? current.mindRoot,
       webPassword: resolvedWebPassword,
       authToken: resolvedAuthToken,
+      port: typeof body.port === 'number' ? body.port : current.port,
+      mcpPort: typeof body.mcpPort === 'number' ? body.mcpPort : current.mcpPort,
+      startMode: body.startMode ?? current.startMode,
     };
 
     writeSettings(next);

package/app/app/api/setup/generate-token/route.ts

@@ -0,0 +1,23 @@
+export const dynamic = 'force-dynamic';
+import { NextResponse } from 'next/server';
+import { randomBytes, createHash } from 'crypto';
+
+export async function POST(req: Request) {
+  try {
+    const { seed } = await req.json().catch(() => ({} as { seed?: string }));
+    let raw: string;
+    if (seed && typeof seed === 'string' && seed.trim()) {
+      raw = createHash('sha256').update(seed.trim()).digest('hex').slice(0, 24);
+    } else {
+      raw = randomBytes(12).toString('hex'); // 24 hex chars
+    }
+    // Format as xxxx-xxxx-xxxx-xxxx-xxxx-xxxx
+    const token = raw.match(/.{4}/g)!.join('-');
+    return NextResponse.json({ token });
+  } catch (e) {
+    return NextResponse.json(
+      { error: e instanceof Error ? e.message : String(e) },
+      { status: 500 },
+    );
+  }
+}

package/app/app/api/setup/route.ts

@@ -0,0 +1,81 @@
+export const dynamic = 'force-dynamic';
+import { NextRequest, NextResponse } from 'next/server';
+import fs from 'fs';
+import os from 'os';
+import { readSettings, writeSettings, ServerSettings } from '@/lib/settings';
+import { applyTemplate } from '@/lib/template';
+
+function expandHome(p: string): string {
+  if (p.startsWith('~/')) return p.replace('~', os.homedir());
+  if (p === '~') return os.homedir();
+  return p;
+}
+
+export async function POST(req: NextRequest) {
+  try {
+    const body = await req.json();
+    const { mindRoot, template, port, mcpPort, authToken, webPassword, ai } = body;
+
+    // Validate required fields
+    if (!mindRoot || typeof mindRoot !== 'string') {
+      return NextResponse.json({ error: 'mindRoot is required' }, { status: 400 });
+    }
+
+    const resolvedRoot = expandHome(mindRoot.trim());
+
+    // Validate ports
+    const webPort = typeof port === 'number' ? port : 3000;
+    const mcpPortNum = typeof mcpPort === 'number' ? mcpPort : 8787;
+    if (webPort < 1024 || webPort > 65535) {
+      return NextResponse.json({ error: `Invalid web port: ${webPort}` }, { status: 400 });
+    }
+    if (mcpPortNum < 1024 || mcpPortNum > 65535) {
+      return NextResponse.json({ error: `Invalid MCP port: ${mcpPortNum}` }, { status: 400 });
+    }
+
+    // Apply template if mindRoot doesn't exist or is empty
+    const dirExists = fs.existsSync(resolvedRoot);
+    let dirEmpty = true;
+    if (dirExists) {
+      try {
+        const entries = fs.readdirSync(resolvedRoot).filter(e => !e.startsWith('.'));
+        dirEmpty = entries.length === 0;
+      } catch { /* treat as empty */ }
+    }
+
+    if (template && (!dirExists || dirEmpty)) {
+      applyTemplate(template, resolvedRoot);
+    } else if (!dirExists) {
+      fs.mkdirSync(resolvedRoot, { recursive: true });
+    }
+
+    // Read current running port for portChanged detection
+    const current = readSettings();
+    const currentPort = current.port ?? 3000;
+
+    // Build config
+    const config: ServerSettings = {
+      ai: ai ?? current.ai,
+      mindRoot: resolvedRoot,
+      port: webPort,
+      mcpPort: mcpPortNum,
+      authToken: authToken ?? current.authToken,
+      webPassword: webPassword ?? '',
+      startMode: current.startMode,
+      setupPending: false,  // clear the flag
+    };
+
+    writeSettings(config);
+
+    return NextResponse.json({
+      ok: true,
+      portChanged: webPort !== currentPort,
+    });
+  } catch (e) {
+    console.error('[/api/setup] Error:', e);
+    return NextResponse.json(
+      { error: e instanceof Error ? e.message : String(e) },
+      { status: 500 },
+    );
+  }
+}

package/app/app/layout.tsx

@@ -6,6 +6,7 @@ import ShellLayout from '@/components/ShellLayout';
 import { TooltipProvider } from '@/components/ui/tooltip';
 import { LocaleProvider } from '@/lib/LocaleContext';
 import ErrorBoundary from '@/components/ErrorBoundary';
+import RegisterSW from './register-sw';
 
 const geistSans = Geist({
   variable: '--font-geist-sans',
@@ -39,7 +40,13 @@ const lora = Lora({
 export const metadata: Metadata = {
   title: 'MindOS',
   description: 'Personal knowledge base',
-  icons: { icon: '/logo-square.svg' },
+  icons: { icon: '/logo-square.svg', apple: '/icons/icon-192.png' },
+  manifest: '/manifest.json',
+  other: {
+    'mobile-web-app-capable': 'yes',
+    'apple-mobile-web-app-capable': 'yes',
+    'apple-mobile-web-app-status-bar-style': 'black-translucent',
+  },
 };
 
 export const viewport = {
@@ -63,6 +70,7 @@ export default function RootLayout({
   return (
     <html lang="en" suppressHydrationWarning>
       <head>
+        <meta name="theme-color" content="#c8871e" />
         {/* Patch Node.removeChild/insertBefore to swallow errors caused by browser
             extensions (translators, Grammarly, etc.) that mutate the DOM between SSR
             and hydration. See: https://github.com/facebook/react/issues/17256 */}
@@ -90,6 +98,7 @@ export default function RootLayout({
               </ShellLayout>
             </ErrorBoundary>
           </TooltipProvider>
+          <RegisterSW />
         </LocaleProvider>
       </body>
     </html>

package/app/app/page.tsx

@@ -1,7 +1,12 @@
+import { redirect } from 'next/navigation';
+import { readSettings } from '@/lib/settings';
 import { getRecentlyModified } from '@/lib/fs';
 import HomeContent from '@/components/HomeContent';
 
 export default function HomePage() {
+  const settings = readSettings();
+  if (settings.setupPending) redirect('/setup');
+
   let recent: { path: string; mtime: number }[] = [];
   try {
     recent = getRecentlyModified(15);

package/app/app/register-sw.tsx

@@ -0,0 +1,15 @@
+'use client';
+
+import { useEffect } from 'react';
+
+export default function RegisterSW() {
+  useEffect(() => {
+    if ('serviceWorker' in navigator) {
+      navigator.serviceWorker.register('/sw.js').catch((err) => {
+        console.warn('[SW] Registration failed:', err);
+      });
+    }
+  }, []);
+
+  return null;
+}

package/app/app/setup/page.tsx

@@ -0,0 +1,9 @@
+import { redirect } from 'next/navigation';
+import { readSettings } from '@/lib/settings';
+import SetupWizard from '@/components/SetupWizard';
+
+export default function SetupPage() {
+  const settings = readSettings();
+  if (!settings.setupPending) redirect('/');
+  return <SetupWizard />;
+}

package/app/components/HomeContent.tsx

@@ -1,12 +1,13 @@
 'use client';
 
 import Link from 'next/link';
-import { FileText, Table, Clock, Sparkles, Puzzle, ArrowRight, FilePlus, Search, ChevronDown } from 'lucide-react';
+import { FileText, Table, Clock, Sparkles, Puzzle, ArrowRight, FilePlus, Search, ChevronDown, Terminal } from 'lucide-react';
 import { useState } from 'react';
 import { useLocale } from '@/lib/LocaleContext';
 import { encodePath, relativeTime } from '@/lib/utils';
 import { getAllRenderers } from '@/lib/renderers/registry';
 import '@/lib/renderers/index'; // registers all renderers
+import OnboardingView from './OnboardingView';
 
 interface RecentFile {
   path: string;
@@ -21,7 +22,7 @@ const RENDERER_ENTRY: Record<string, string> = {
   timeline: 'CHANGELOG.md',
   backlinks: 'BACKLINKS.md',
   summary: 'DAILY.md',
-  'agent-inspector': 'Agent-Audit.md',
+  'agent-inspector': '.agent-log.json',
   workflow: 'Workflow.md',
   'diff-viewer': 'Agent-Diff.md',
   'config-panel': 'CONFIG.json',
@@ -45,6 +46,11 @@ export default function HomeContent({ recent }: { recent: RecentFile[] }) {
   const { t } = useLocale();
   const [showAll, setShowAll] = useState(false);
 
+  // Empty knowledge base → show onboarding
+  if (recent.length === 0) {
+    return <OnboardingView />;
+  }
+
   const formatTime = (mtime: number) => relativeTime(mtime, t.home.relativeTime);
 
   const renderers = getAllRenderers();

package/app/components/OnboardingView.tsx

@@ -0,0 +1,161 @@
+'use client';
+
+import { useState } from 'react';
+import { useRouter } from 'next/navigation';
+import { Sparkles, Globe, BookOpen, FileText, Loader2, GitBranch } from 'lucide-react';
+import { useLocale } from '@/lib/LocaleContext';
+
+type Template = 'en' | 'zh' | 'empty';
+
+const TEMPLATES: Array<{
+  id: Template;
+  icon: React.ReactNode;
+  dirs: string[];
+}> = [
+  {
+    id: 'en',
+    icon: <Globe size={20} />,
+    dirs: ['Profile/', 'Connections/', 'Notes/', 'Workflows/', 'Resources/', 'Projects/'],
+  },
+  {
+    id: 'zh',
+    icon: <BookOpen size={20} />,
+    dirs: ['画像/', '关系/', '笔记/', '流程/', '资源/', '项目/'],
+  },
+  {
+    id: 'empty',
+    icon: <FileText size={20} />,
+    dirs: ['README.md', 'CONFIG.json', 'INSTRUCTION.md'],
+  },
+];
+
+export default function OnboardingView() {
+  const { t } = useLocale();
+  const router = useRouter();
+  const [loading, setLoading] = useState<Template | null>(null);
+
+  const ob = t.onboarding;
+
+  async function handleSelect(template: Template) {
+    setLoading(template);
+    try {
+      const res = await fetch('/api/init', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ template }),
+      });
+      if (!res.ok) {
+        const data = await res.json().catch(() => ({}));
+        throw new Error(data.error || `HTTP ${res.status}`);
+      }
+      router.refresh();
+    } catch (e) {
+      console.error('[Onboarding] init failed:', e);
+      setLoading(null);
+    }
+  }
+
+  return (
+    <div className="content-width px-4 md:px-6 py-12 md:py-20">
+      {/* Header */}
+      <div className="text-center mb-10">
+        <div className="inline-flex items-center gap-2 mb-4">
+          <Sparkles size={18} style={{ color: 'var(--amber)' }} />
+          <h1
+            className="text-2xl font-semibold tracking-tight"
+            style={{ fontFamily: "'IBM Plex Mono', monospace", color: 'var(--foreground)' }}
+          >
+            MindOS
+          </h1>
+        </div>
+        <p
+          className="text-sm leading-relaxed max-w-md mx-auto"
+          style={{ color: 'var(--muted-foreground)' }}
+        >
+          {ob.subtitle}
+        </p>
+      </div>
+
+      {/* Template cards */}
+      <div className="grid grid-cols-1 sm:grid-cols-3 gap-4 max-w-2xl mx-auto mb-10">
+        {TEMPLATES.map((tpl) => {
+          const isLoading = loading === tpl.id;
+          const isDisabled = loading !== null;
+          return (
+            <button
+              key={tpl.id}
+              disabled={isDisabled}
+              onClick={() => handleSelect(tpl.id)}
+              className="group relative flex flex-col items-start gap-3 p-5 rounded-xl border text-left transition-all duration-150 hover:border-amber-500/50 hover:bg-amber-500/5 disabled:opacity-60 disabled:cursor-not-allowed"
+              style={{ background: 'var(--card)', borderColor: 'var(--border)' }}
+            >
+              {/* Icon + title */}
+              <div className="flex items-center gap-2.5 w-full">
+                <span style={{ color: 'var(--amber)' }}>{tpl.icon}</span>
+                <span
+                  className="text-sm font-semibold"
+                  style={{ color: 'var(--foreground)', fontFamily: "'IBM Plex Sans', sans-serif" }}
+                >
+                  {ob.templates[tpl.id].title}
+                </span>
+                {isLoading && (
+                  <Loader2 size={14} className="animate-spin ml-auto" style={{ color: 'var(--amber)' }} />
+                )}
+              </div>
+
+              {/* Description */}
+              <p className="text-xs leading-relaxed" style={{ color: 'var(--muted-foreground)' }}>
+                {ob.templates[tpl.id].desc}
+              </p>
+
+              {/* Directory preview */}
+              <div
+                className="w-full rounded-lg px-3 py-2 text-[11px] leading-relaxed"
+                style={{
+                  background: 'var(--muted)',
+                  fontFamily: "'IBM Plex Mono', monospace",
+                  color: 'var(--muted-foreground)',
+                  opacity: 0.8,
+                }}
+              >
+                {tpl.dirs.map((d) => (
+                  <div key={d}>{d}</div>
+                ))}
+              </div>
+            </button>
+          );
+        })}
+      </div>
+
+      {/* Import hint */}
+      <p
+        className="text-center text-xs leading-relaxed max-w-sm mx-auto"
+        style={{ color: 'var(--muted-foreground)', opacity: 0.6, fontFamily: "'IBM Plex Mono', monospace" }}
+      >
+        {ob.importHint}
+      </p>
+
+      {/* Sync hint card */}
+      <div
+        className="max-w-md mx-auto mt-6 flex items-center gap-3 px-4 py-3 rounded-lg border text-left"
+        style={{ borderColor: 'var(--border)', background: 'var(--card)' }}
+      >
+        <GitBranch size={16} style={{ color: 'var(--muted-foreground)', flexShrink: 0 }} />
+        <div className="min-w-0">
+          <p className="text-xs" style={{ color: 'var(--muted-foreground)' }}>
+            {ob.syncHint ?? 'Want cross-device sync? Run'}
+            {' '}
+            <code
+              className="font-mono px-1 py-0.5 rounded select-all"
+              style={{ background: 'var(--muted)', fontSize: '11px' }}
+            >
+              mindos sync init
+            </code>
+            {' '}
+            {ob.syncHintSuffix ?? 'in the terminal after setup.'}
+          </p>
+        </div>
+      </div>
+    </div>
+  );
+}

package/app/components/SettingsModal.tsx

@@ -18,9 +18,10 @@ import { SyncTab } from './settings/SyncTab';
 interface SettingsModalProps {
   open: boolean;
   onClose: () => void;
+  initialTab?: Tab;
 }
 
-export default function SettingsModal({ open, onClose }: SettingsModalProps) {
+export default function SettingsModal({ open, onClose, initialTab }: SettingsModalProps) {
   const [tab, setTab] = useState<Tab>('ai');
   const [data, setData] = useState<SettingsData | null>(null);
   const [saving, setSaving] = useState(false);
@@ -48,6 +49,11 @@ export default function SettingsModal({ open, onClose }: SettingsModalProps) {
     setStatus('idle');
   }, [open]);
 
+  // Switch to requested tab when opening with initialTab
+  useEffect(() => {
+    if (open && initialTab) setTab(initialTab);
+  }, [open, initialTab]);
+
   // Apply font immediately
   useEffect(() => {
     const fontMap: Record<string, string> = {