@geminilight/mindos 0.1.9 → 0.2.1

package/README.md

@@ -82,6 +82,7 @@ Static documents are hard to synchronize and weak as execution systems in real h
 - **Reference Sync**: keep cross-file status and context aligned via links/backlinks.
 - **Knowledge Graph**: visualize relationships and dependencies across notes.
 - **Git Time Machine**: track every edit, audit history, and roll back safely.
+- **Cross-Device Sync**: auto-commit, push, and pull via Git — edits on one device appear on all others within minutes.
 
 <details>
 <summary><strong>Coming Soon</strong></summary>
@@ -125,18 +126,17 @@ npm link   # registers the `mindos` command globally
 ### 2. Interactive Setup
 
 ```bash
-mindos onboard --install-daemon
+mindos onboard
 ```
 
-> `--install-daemon`: after setup, automatically installs and starts MindOS as a background OS service (survives terminal close, auto-restarts on crash).
-
 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)
 5. Web UI password (optional)
 6. AI Provider (Anthropic / OpenAI) + API Key — or **skip** to configure later via `mindos config set`
+7. Start mode — **Background service** (recommended, auto-starts on boot) or Foreground
 
 Config is saved to `~/.mindos/config.json` automatically.
 
@@ -153,34 +153,50 @@ 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": "",
   "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
   }
 }
 ```
 
 | 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. |
 | `webPassword` | — | Optional. Protects the web UI with a login page. For browser access. Independent from `authToken`. |
+| `startMode` | `start` | Start mode: `daemon` (background service, auto-starts on boot), `start` (foreground), or `dev`. |
 | `ai.provider` | `anthropic` | Active provider: `anthropic` or `openai`. |
 | `ai.providers.anthropic.apiKey` | — | Anthropic API key. |
 | `ai.providers.anthropic.model` | `claude-sonnet-4-6` | Anthropic model ID. |
 | `ai.providers.openai.apiKey` | — | OpenAI API key. |
 | `ai.providers.openai.model` | `gpt-5.4` | OpenAI model ID. |
 | `ai.providers.openai.baseUrl` | — | Optional. Custom endpoint for proxy or OpenAI-compatible APIs. |
+| `sync.enabled` | `false` | Enable/disable automatic Git sync. |
+| `sync.provider` | `git` | Sync provider (currently only `git`). |
+| `sync.remote` | `origin` | Git remote name. |
+| `sync.branch` | `main` | Git branch to sync. |
+| `sync.autoCommitInterval` | `30` | Seconds after file change to auto-commit+push. |
+| `sync.autoPullInterval` | `300` | Seconds between auto-pull from remote. |
 
 Multiple providers can be configured simultaneously — switch between them by changing `ai.provider`. Shell env vars (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, etc.) take precedence over config file values.
 
@@ -190,7 +206,13 @@ Multiple providers can be configured simultaneously — switch between them by c
 > If you want the MindOS GUI to be reachable from other devices, make sure the port is open in firewall/security-group settings and bound to an accessible host/network interface.
 
 > [!TIP]
-> With `--install-daemon`, MindOS is installed as a background OS service and starts automatically — no need to run `mindos start` manually. If you skipped the flag, run `mindos start` to start manually, or `mindos update` to upgrade to the latest version.
+> If you chose "Background service" during onboard, MindOS is installed as a background OS service and starts automatically — no need to run `mindos start` manually. Run `mindos update` to upgrade to the latest version.
+
+Open the Web UI in your browser:
+
+```bash
+mindos open
+```
 
 ### 3. Inject Your Personal Mind with MindOS Agent
 
@@ -386,12 +408,13 @@ MindOS/
 ├── mcp/              # MCP Server — HTTP adapter that maps tools to App API
 ├── skills/           # MindOS Skills (`mindos`, `mindos-zh`) — Workflow guides for Agents
 ├── templates/        # Preset templates (`en/`, `zh/`, `empty/`) — copied to knowledge base on onboard
-├── bin/              # CLI entry point (`mindos onboard`, `mindos start`, `mindos dev`, `mindos token`)
+├── bin/              # CLI entry point (`mindos onboard`, `mindos start`, `mindos open`, `mindos sync`, `mindos token`)
 ├── scripts/          # Setup wizard and helper scripts
 └── README.md
 
 ~/.mindos/            # User data directory (outside project, never committed)
-├── config.json       # All configuration (AI keys, port, auth token, knowledge base path)
+├── config.json       # All configuration (AI keys, port, auth token, sync settings)
+├── sync-state.json   # Sync state (last sync time, conflicts)
 └── my-mind/          # Your private knowledge base (default path, customizable on onboard)
 ```
 
@@ -401,17 +424,24 @@ MindOS/
 
 | Command | Description |
 | :--- | :--- |
-| `mindos onboard` | Interactive setup (config, template selection) |
-| `mindos onboard --install-daemon` | Setup + install & start as background OS service |
+| `mindos onboard` | Interactive setup (config, template, start mode) |
 | `mindos start` | Start app + MCP server (foreground, production mode) |
 | `mindos start --daemon` | Install + start as a background OS service (survives terminal close, auto-restarts on crash) |
 | `mindos dev` | Start app + MCP server (dev mode, hot reload) |
 | `mindos dev --turbopack` | Dev mode with Turbopack (faster HMR) |
+| `mindos open` | Open the Web UI in the default browser |
 | `mindos stop` | Stop running MindOS processes |
 | `mindos restart` | Stop then start again |
 | `mindos build` | Manually build for production |
 | `mindos mcp` | Start MCP server only |
-| `mindos token` | Show current auth token and MCP config snippet |
+| `mindos token` | Show auth token and per-agent MCP config snippets |
+| `mindos sync` | Show sync status (alias for `sync status`) |
+| `mindos sync init` | Interactive setup for Git remote sync |
+| `mindos sync status` | Show sync status: last sync, unpushed commits, conflicts |
+| `mindos sync now` | Manually trigger a full sync (commit + push + pull) |
+| `mindos sync on` | Enable automatic sync |
+| `mindos sync off` | Disable automatic sync |
+| `mindos sync conflicts` | List unresolved conflict files |
 | `mindos gateway install` | Install background service (systemd on Linux, LaunchAgent on macOS) |
 | `mindos gateway uninstall` | Remove background service |
 | `mindos gateway start` | Start the background service |

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,56 @@
+import { NextRequest, NextResponse } from 'next/server';
+import fs from 'fs';
+import path from 'path';
+import { getMindRoot } from '@/lib/fs';
+
+function copyRecursive(src: string, dest: string) {
+  const stat = fs.statSync(src);
+  if (stat.isDirectory()) {
+    if (!fs.existsSync(dest)) fs.mkdirSync(dest, { recursive: true });
+    for (const entry of fs.readdirSync(src)) {
+      copyRecursive(path.join(src, entry), path.join(dest, entry));
+    }
+  } else {
+    // Skip if file already exists
+    if (fs.existsSync(dest)) return;
+    // Ensure parent directory exists
+    const dir = path.dirname(dest);
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+    fs.copyFileSync(src, dest);
+  }
+}
+
+export async function POST(req: NextRequest) {
+  try {
+    const body = await req.json();
+    const template = body.template as string;
+
+    if (!['en', 'zh', 'empty'].includes(template)) {
+      return NextResponse.json({ error: 'Invalid template' }, { status: 400 });
+    }
+
+    // Resolve template source directory
+    // templates/ is at the repo root (sibling of app/)
+    const repoRoot = path.resolve(process.cwd(), '..');
+    const templateDir = path.join(repoRoot, 'templates', template);
+
+    if (!fs.existsSync(templateDir)) {
+      return NextResponse.json({ error: `Template "${template}" not found` }, { status: 404 });
+    }
+
+    const mindRoot = getMindRoot();
+    if (!fs.existsSync(mindRoot)) {
+      fs.mkdirSync(mindRoot, { recursive: true });
+    }
+
+    copyRecursive(templateDir, mindRoot);
+
+    return NextResponse.json({ ok: true, template });
+  } catch (e) {
+    console.error('[/api/init] Error:', e);
+    return NextResponse.json(
+      { error: e instanceof Error ? e.message : String(e) },
+      { status: 500 },
+    );
+  }
+}

package/app/app/api/sync/route.ts

@@ -0,0 +1,124 @@
+export const dynamic = 'force-dynamic';
+import { NextRequest, NextResponse } from 'next/server';
+import { execSync } from 'child_process';
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+
+const MINDOS_DIR = join(homedir(), '.mindos');
+const CONFIG_PATH = join(MINDOS_DIR, 'config.json');
+const SYNC_STATE_PATH = join(MINDOS_DIR, 'sync-state.json');
+
+function loadConfig() {
+  try { return JSON.parse(readFileSync(CONFIG_PATH, 'utf-8')); } catch { return {}; }
+}
+
+function saveConfig(config: Record<string, unknown>) {
+  writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}
+
+function loadSyncState() {
+  try { return JSON.parse(readFileSync(SYNC_STATE_PATH, 'utf-8')); } catch { return {}; }
+}
+
+function getRemoteUrl(cwd: string) {
+  try { return execSync('git remote get-url origin', { cwd, encoding: 'utf-8', stdio: 'pipe' }).trim(); } catch { return null; }
+}
+
+function getBranch(cwd: string) {
+  try { return execSync('git rev-parse --abbrev-ref HEAD', { cwd, encoding: 'utf-8', stdio: 'pipe' }).trim(); } catch { return 'main'; }
+}
+
+function getUnpushedCount(cwd: string) {
+  try { return execSync('git rev-list --count @{u}..HEAD', { cwd, encoding: 'utf-8', stdio: 'pipe' }).trim(); } catch { return '?'; }
+}
+
+function isGitRepo(dir: string) {
+  return existsSync(join(dir, '.git'));
+}
+
+export async function GET() {
+  const config = loadConfig();
+  const syncConfig = config.sync || {};
+  const state = loadSyncState();
+  const mindRoot = config.mindRoot;
+
+  if (!syncConfig.enabled) {
+    return NextResponse.json({ enabled: false });
+  }
+
+  const remote = mindRoot && isGitRepo(mindRoot) ? getRemoteUrl(mindRoot) : null;
+  const branch = mindRoot && isGitRepo(mindRoot) ? getBranch(mindRoot) : null;
+  const unpushed = mindRoot && isGitRepo(mindRoot) ? getUnpushedCount(mindRoot) : '?';
+
+  return NextResponse.json({
+    enabled: true,
+    provider: syncConfig.provider || 'git',
+    remote: remote || '(not configured)',
+    branch: branch || 'main',
+    lastSync: state.lastSync || null,
+    lastPull: state.lastPull || null,
+    unpushed,
+    conflicts: state.conflicts || [],
+    lastError: state.lastError || null,
+    autoCommitInterval: syncConfig.autoCommitInterval || 30,
+    autoPullInterval: syncConfig.autoPullInterval || 300,
+  });
+}
+
+export async function POST(req: NextRequest) {
+  try {
+    const body = await req.json() as { action: string };
+    const config = loadConfig();
+    const mindRoot = config.mindRoot;
+
+    if (!mindRoot) {
+      return NextResponse.json({ error: 'No mindRoot configured' }, { status: 400 });
+    }
+
+    switch (body.action) {
+      case 'now': {
+        if (!isGitRepo(mindRoot)) {
+          return NextResponse.json({ error: 'Not a git repository' }, { status: 400 });
+        }
+        // Pull
+        try { execSync('git pull --rebase --autostash', { cwd: mindRoot, stdio: 'pipe' }); } catch {
+          try { execSync('git rebase --abort', { cwd: mindRoot, stdio: 'pipe' }); } catch {}
+          try { execSync('git pull --no-rebase', { cwd: mindRoot, stdio: 'pipe' }); } catch {}
+        }
+        // Commit + push
+        execSync('git add -A', { cwd: mindRoot, stdio: 'pipe' });
+        const status = execSync('git status --porcelain', { cwd: mindRoot, encoding: 'utf-8' }).trim();
+        if (status) {
+          const timestamp = new Date().toISOString().replace('T', ' ').slice(0, 19);
+          execSync(`git commit -m "auto-sync: ${timestamp}"`, { cwd: mindRoot, stdio: 'pipe' });
+          execSync('git push', { cwd: mindRoot, stdio: 'pipe' });
+        }
+        const state = loadSyncState();
+        state.lastSync = new Date().toISOString();
+        writeFileSync(SYNC_STATE_PATH, JSON.stringify(state, null, 2) + '\n');
+        return NextResponse.json({ ok: true });
+      }
+
+      case 'on': {
+        if (!config.sync) config.sync = {};
+        config.sync.enabled = true;
+        saveConfig(config);
+        return NextResponse.json({ ok: true, enabled: true });
+      }
+
+      case 'off': {
+        if (!config.sync) config.sync = {};
+        config.sync.enabled = false;
+        saveConfig(config);
+        return NextResponse.json({ ok: true, enabled: false });
+      }
+
+      default:
+        return NextResponse.json({ error: `Unknown action: ${body.action}` }, { status: 400 });
+    }
+  } catch (err: unknown) {
+    const message = err instanceof Error ? err.message : 'Unknown error';
+    return NextResponse.json({ error: message }, { 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/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/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();