@geminilight/mindos 0.2.0 → 0.3.0

package/app/lib/agent/tools.ts

@@ -5,6 +5,7 @@ import {
   saveFileContent, createFile, appendToFile, insertAfterHeading, updateSection,
 } from '@/lib/fs';
 import { assertNotProtected } from '@/lib/core';
+import { logAgentOp } from './log';
 
 // Max chars per file to avoid token overflow (~100k chars ≈ ~25k tokens)
 const MAX_FILE_CHARS = 20_000;
@@ -19,47 +20,67 @@ export function assertWritable(filePath: string): void {
   assertNotProtected(filePath, 'modified by AI agent');
 }
 
+/** Helper: wrap a tool execute fn with agent-op logging */
+function logged<P extends Record<string, unknown>>(
+  toolName: string,
+  fn: (params: P) => Promise<string>,
+): (params: P) => Promise<string> {
+  return async (params: P) => {
+    const ts = new Date().toISOString();
+    try {
+      const result = await fn(params);
+      const isError = result.startsWith('Error:');
+      logAgentOp({ ts, tool: toolName, params, result: isError ? 'error' : 'ok', message: result.slice(0, 200) });
+      return result;
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      logAgentOp({ ts, tool: toolName, params, result: 'error', message: msg.slice(0, 200) });
+      throw e;
+    }
+  };
+}
+
 // ─── Knowledge base tools ─────────────────────────────────────────────────────
 
 export const knowledgeBaseTools = {
   list_files: tool({
     description: 'List the full file tree of the knowledge base. Use this to browse what files exist.',
     inputSchema: z.object({}),
-    execute: async () => {
+    execute: logged('list_files', async () => {
       const tree = getFileTree();
       return JSON.stringify(tree, null, 2);
-    },
+    }),
   }),
 
   read_file: tool({
     description: 'Read the content of a file by its relative path. Always read a file before modifying it.',
     inputSchema: z.object({ path: z.string().describe('Relative file path, e.g. "Profile/👤 Identity.md"') }),
-    execute: async ({ path }) => {
+    execute: logged('read_file', async ({ path }) => {
       try {
         return truncate(getFileContent(path));
       } catch (e: unknown) {
         return `Error: ${e instanceof Error ? e.message : String(e)}`;
       }
-    },
+    }),
   }),
 
   search: tool({
     description: 'Full-text search across all files in the knowledge base. Returns matching files with context snippets.',
     inputSchema: z.object({ query: z.string().describe('Search query (case-insensitive)') }),
-    execute: async ({ query }) => {
+    execute: logged('search', async ({ query }) => {
       const results = searchFiles(query);
       if (results.length === 0) return 'No results found.';
       return results.map(r => `- **${r.path}**: ${r.snippet}`).join('\n');
-    },
+    }),
   }),
 
   get_recent: tool({
     description: 'Get the most recently modified files in the knowledge base.',
     inputSchema: z.object({ limit: z.number().min(1).max(50).default(10).describe('Number of files to return') }),
-    execute: async ({ limit }) => {
+    execute: logged('get_recent', async ({ limit }) => {
       const files = getRecentlyModified(limit);
       return files.map(f => `- ${f.path} (${new Date(f.mtime).toISOString()})`).join('\n');
-    },
+    }),
   }),
 
   write_file: tool({
@@ -68,7 +89,7 @@ export const knowledgeBaseTools = {
       path: z.string().describe('Relative file path'),
       content: z.string().describe('New full content'),
     }),
-    execute: async ({ path, content }) => {
+    execute: logged('write_file', async ({ path, content }) => {
       try {
         assertWritable(path);
         saveFileContent(path, content);
@@ -76,7 +97,7 @@ export const knowledgeBaseTools = {
       } catch (e: unknown) {
         return `Error: ${e instanceof Error ? e.message : String(e)}`;
       }
-    },
+    }),
   }),
 
   create_file: tool({
@@ -85,7 +106,7 @@ export const knowledgeBaseTools = {
       path: z.string().describe('Relative file path (must end in .md or .csv)'),
       content: z.string().default('').describe('Initial file content'),
     }),
-    execute: async ({ path, content }) => {
+    execute: logged('create_file', async ({ path, content }) => {
       try {
         assertWritable(path);
         createFile(path, content);
@@ -93,7 +114,7 @@ export const knowledgeBaseTools = {
       } catch (e: unknown) {
         return `Error: ${e instanceof Error ? e.message : String(e)}`;
       }
-    },
+    }),
   }),
 
   append_to_file: tool({
@@ -102,7 +123,7 @@ export const knowledgeBaseTools = {
       path: z.string().describe('Relative file path'),
       content: z.string().describe('Content to append'),
     }),
-    execute: async ({ path, content }) => {
+    execute: logged('append_to_file', async ({ path, content }) => {
       try {
         assertWritable(path);
         appendToFile(path, content);
@@ -110,7 +131,7 @@ export const knowledgeBaseTools = {
       } catch (e: unknown) {
         return `Error: ${e instanceof Error ? e.message : String(e)}`;
       }
-    },
+    }),
   }),
 
   insert_after_heading: tool({
@@ -120,7 +141,7 @@ export const knowledgeBaseTools = {
       heading: z.string().describe('Heading text to find (e.g. "## Tasks" or just "Tasks")'),
       content: z.string().describe('Content to insert after the heading'),
     }),
-    execute: async ({ path, heading, content }) => {
+    execute: logged('insert_after_heading', async ({ path, heading, content }) => {
       try {
         assertWritable(path);
         insertAfterHeading(path, heading, content);
@@ -128,7 +149,7 @@ export const knowledgeBaseTools = {
       } catch (e: unknown) {
         return `Error: ${e instanceof Error ? e.message : String(e)}`;
       }
-    },
+    }),
   }),
 
   update_section: tool({
@@ -138,7 +159,7 @@ export const knowledgeBaseTools = {
       heading: z.string().describe('Heading text to find (e.g. "## Status")'),
       content: z.string().describe('New content for the section'),
     }),
-    execute: async ({ path, heading, content }) => {
+    execute: logged('update_section', async ({ path, heading, content }) => {
       try {
         assertWritable(path);
         updateSection(path, heading, content);
@@ -146,6 +167,6 @@ export const knowledgeBaseTools = {
       } catch (e: unknown) {
         return `Error: ${e instanceof Error ? e.message : String(e)}`;
       }
-    },
+    }),
   }),
 };

package/app/lib/i18n.ts

@@ -36,6 +36,22 @@ export const messages = {
       settingsTitle: 'Settings (⌘,)',
       collapseTitle: 'Collapse sidebar',
       expandTitle: 'Expand sidebar',
+      sync: {
+        synced: 'Synced',
+        unpushed: 'awaiting push',
+        unpushedHint: 'commit(s) not yet pushed to remote — will sync automatically',
+        conflicts: 'conflicts',
+        conflictsHint: 'file(s) have merge conflicts — open Settings > Sync to resolve',
+        syncError: 'Sync error',
+        syncOff: 'Sync off',
+        syncing: 'Syncing...',
+        syncNow: 'Sync now',
+        syncDone: 'Sync complete',
+        syncFailed: 'Sync failed',
+        syncRestored: 'Sync restored',
+        enableSync: 'Enable sync',
+        enableHint: 'Set up cross-device sync',
+      },
     },
     search: {
       placeholder: 'Search files...',
@@ -125,6 +141,18 @@ export const messages = {
         authTokenResetConfirm: 'Regenerate token? All existing MCP clients will need to update their config.',
         authTokenMcpPort: 'MCP port',
       },
+      sync: {
+        emptyTitle: 'Cross-device Sync',
+        emptyDesc: 'Automatically sync your knowledge base across devices via Git.',
+        emptyStepsTitle: 'Setup',
+        emptyStep1: 'Create a private Git repo (GitHub, GitLab, etc.) or use an existing one.',
+        emptyStep2: 'Run this command in your terminal:',
+        emptyStep3: 'Follow the prompts to connect your repo. Sync starts automatically.',
+        featureAutoCommit: 'Auto-commit on save',
+        featureAutoPull: 'Auto-pull from remote',
+        featureConflict: 'Conflict detection',
+        featureMultiDevice: 'Works across devices',
+      },
       plugins: {
         title: 'Installed Renderers',
         builtinBadge: 'built-in',
@@ -138,6 +166,17 @@ export const messages = {
       saved: 'Saved',
       saveFailed: 'Save failed',
     },
+    onboarding: {
+      subtitle: 'Your knowledge base is empty. Pick a starter template to get going.',
+      templates: {
+        en: { title: 'English', desc: 'Pre-built structure with Profile, Notes, Projects, and more.' },
+        zh: { title: '中文', desc: '预置画像、笔记、项目等中文目录结构。' },
+        empty: { title: 'Empty', desc: 'Just the essentials — README, CONFIG, and INSTRUCTION.' },
+      },
+      importHint: 'Already have notes? Set MIND_ROOT to your existing directory in Settings.',
+      syncHint: 'Want cross-device sync? Run',
+      syncHintSuffix: 'in the terminal after setup.',
+    },
     shortcuts: [
       { keys: ['⌘', 'K'], description: 'Search' },
       { keys: ['⌘', '/'], description: 'Ask AI' },
@@ -147,6 +186,52 @@ export const messages = {
       { keys: ['Esc'], description: 'Cancel edit / close modal' },
       { keys: ['@'], description: 'Attach file in Ask AI' },
     ],
+    setup: {
+      stepTitles: ['Knowledge Base', 'AI Provider', 'Ports', 'Security', 'Review'],
+      // Step 1
+      kbPath: 'Knowledge base path',
+      kbPathHint: 'Absolute path to your notes directory.',
+      kbPathDefault: '~/MindOS',
+      template: 'Starter template',
+      templateSkip: 'Skip (directory already has files)',
+      // Step 2
+      aiProvider: 'AI Provider',
+      aiProviderHint: 'Choose your preferred AI service.',
+      aiSkip: 'Skip — configure later',
+      apiKey: 'API Key',
+      model: 'Model',
+      baseUrl: 'Base URL',
+      baseUrlHint: 'Optional. For proxies or OpenAI-compatible APIs.',
+      // Step 3
+      webPort: 'Web UI port',
+      mcpPort: 'MCP server port',
+      portHint: 'Valid range: 1024–65535',
+      portRestartWarning: 'Port changes take effect after server restart.',
+      // Step 4
+      authToken: 'Auth Token',
+      authTokenHint: 'Bearer token for MCP / API clients. Auto-generated.',
+      authTokenSeed: 'Custom seed (optional)',
+      authTokenSeedHint: 'Enter a passphrase to derive a deterministic token.',
+      generateToken: 'Generate',
+      copyToken: 'Copy',
+      copiedToken: 'Copied!',
+      webPassword: 'Web UI Password',
+      webPasswordHint: 'Optional. Protect browser access with a password.',
+      // Step 5
+      reviewTitle: 'Review Configuration',
+      reviewHint: 'Verify your settings before completing setup.',
+      keyMasked: (key: string) => key.slice(0, 6) + '•••' + key.slice(-3),
+      portChanged: 'Port changed — please restart the server for it to take effect.',
+      // Buttons
+      back: 'Back',
+      next: 'Next',
+      complete: 'Complete Setup',
+      skip: 'Skip',
+      // Status
+      completing: 'Saving...',
+      completeDone: 'Setup complete!',
+      completeFailed: 'Setup failed. Please try again.',
+    },
   },
   zh: {
     common: {
@@ -183,6 +268,22 @@ export const messages = {
       settingsTitle: '设置 (⌘,)',
       collapseTitle: '收起侧栏',
       expandTitle: '展开侧栏',
+      sync: {
+        synced: '已同步',
+        unpushed: '待推送',
+        unpushedHint: '个提交尚未推送到远程 — 将自动同步',
+        conflicts: '冲突',
+        conflictsHint: '个文件存在合并冲突 — 前往 设置 > 同步 解决',
+        syncError: '同步出错',
+        syncOff: '同步关闭',
+        syncing: '同步中...',
+        syncNow: '立即同步',
+        syncDone: '同步完成',
+        syncFailed: '同步失败',
+        syncRestored: '同步已恢复',
+        enableSync: '启用同步',
+        enableHint: '设置跨设备同步',
+      },
     },
     search: {
       placeholder: '搜索文件...',
@@ -272,6 +373,18 @@ export const messages = {
         authTokenResetConfirm: '重新生成令牌？所有 MCP 客户端配置都需要更新。',
         authTokenMcpPort: 'MCP 端口',
       },
+      sync: {
+        emptyTitle: '跨设备同步',
+        emptyDesc: '通过 Git 自动同步知识库到所有设备。',
+        emptyStepsTitle: '配置步骤',
+        emptyStep1: '创建一个私有 Git 仓库（GitHub、GitLab 等），或使用现有仓库。',
+        emptyStep2: '在终端中运行以下命令：',
+        emptyStep3: '按照提示连接仓库，同步将自动开始。',
+        featureAutoCommit: '保存时自动提交',
+        featureAutoPull: '自动拉取远程更新',
+        featureConflict: '冲突检测',
+        featureMultiDevice: '多设备同步',
+      },
       plugins: {
         title: '已安装渲染器',
         builtinBadge: '内置',
@@ -285,6 +398,17 @@ export const messages = {
       saved: '已保存',
       saveFailed: '保存失败',
     },
+    onboarding: {
+      subtitle: '知识库为空，选择一个模板快速开始。',
+      templates: {
+        en: { title: 'English', desc: '预置 Profile、Notes、Projects 等英文目录结构。' },
+        zh: { title: '中文', desc: '预置画像、笔记、项目等中文目录结构。' },
+        empty: { title: '空白', desc: '仅包含 README、CONFIG 和 INSTRUCTION 基础文件。' },
+      },
+      importHint: '已有笔记？在设置中将 MIND_ROOT 指向已有目录即可。',
+      syncHint: '需要跨设备同步？完成初始化后在终端运行',
+      syncHintSuffix: '即可。',
+    },
     shortcuts: [
       { keys: ['⌘', 'K'], description: '搜索' },
       { keys: ['⌘', '/'], description: '问 AI' },
@@ -294,6 +418,52 @@ export const messages = {
       { keys: ['Esc'], description: '取消编辑 / 关闭弹窗' },
       { keys: ['@'], description: '在 AI 对话中添加附件' },
     ],
+    setup: {
+      stepTitles: ['知识库', 'AI 服务商', '端口', '安全', '确认'],
+      // Step 1
+      kbPath: '知识库路径',
+      kbPathHint: '笔记目录的绝对路径。',
+      kbPathDefault: '~/MindOS',
+      template: '初始模板',
+      templateSkip: '跳过（目录已有文件）',
+      // Step 2
+      aiProvider: 'AI 服务商',
+      aiProviderHint: '选择你偏好的 AI 服务。',
+      aiSkip: '跳过 — 稍后配置',
+      apiKey: 'API 密钥',
+      model: '模型',
+      baseUrl: '接口地址',
+      baseUrlHint: '可选。用于代理或 OpenAI 兼容 API。',
+      // Step 3
+      webPort: 'Web UI 端口',
+      mcpPort: 'MCP 服务端口',
+      portHint: '有效范围：1024–65535',
+      portRestartWarning: '端口修改需重启服务后生效。',
+      // Step 4
+      authToken: 'Auth Token',
+      authTokenHint: 'MCP / API 客户端使用的 Bearer Token，自动生成。',
+      authTokenSeed: '自定义种子（可选）',
+      authTokenSeedHint: '输入口令短语生成确定性 Token。',
+      generateToken: '生成',
+      copyToken: '复制',
+      copiedToken: '已复制！',
+      webPassword: '网页访问密码',
+      webPasswordHint: '可选。设置后浏览器访问需要登录。',
+      // Step 5
+      reviewTitle: '确认配置',
+      reviewHint: '完成设置前请确认以下信息。',
+      keyMasked: (key: string) => key.slice(0, 6) + '•••' + key.slice(-3),
+      portChanged: '端口已变更 — 请重启服务以使其生效。',
+      // Buttons
+      back: '上一步',
+      next: '下一步',
+      complete: '完成设置',
+      skip: '跳过',
+      // Status
+      completing: '保存中...',
+      completeDone: '设置完成！',
+      completeFailed: '设置失败，请重试。',
+    },
   },
 } as const;
 

package/app/lib/renderers/index.ts

@@ -5,6 +5,7 @@ import { GraphRenderer } from '@/components/renderers/GraphRenderer';
 import { TimelineRenderer } from '@/components/renderers/TimelineRenderer';
 import { SummaryRenderer } from '@/components/renderers/SummaryRenderer';
 import { ConfigRenderer } from '@/components/renderers/ConfigRenderer';
+import { AgentInspectorRenderer } from '@/components/renderers/AgentInspectorRenderer';
 
 registerRenderer({
   id: 'todo',
@@ -77,3 +78,15 @@ registerRenderer({
   match: ({ filePath }) => /\b(SUMMARY|summary|Summary|BRIEFING|briefing|Briefing|DAILY|daily|Daily)\b.*\.md$/i.test(filePath),
   component: SummaryRenderer,
 });
+
+registerRenderer({
+  id: 'agent-inspector',
+  name: 'Agent Inspector',
+  description: 'Visualizes agent tool-call logs as a filterable timeline. Auto-activates on .agent-log.json (JSON Lines format).',
+  author: 'MindOS',
+  icon: '🔍',
+  tags: ['agent', 'inspector', 'log', 'mcp', 'tools'],
+  builtin: true,
+  match: ({ filePath }) => /\.agent-log\.json$/i.test(filePath),
+  component: AgentInspectorRenderer,
+});

package/app/lib/settings.ts

@@ -21,12 +21,12 @@ export interface AiConfig {
 export interface ServerSettings {
   ai: AiConfig;
   mindRoot: string;   // empty = use env var / default
-  // Fields managed by CLI only (not edited via GUI, preserved on write)
   port?: number;
   mcpPort?: number;
   authToken?: string;
   webPassword?: string;
   startMode?: 'dev' | 'start' | 'daemon';
+  setupPending?: boolean;  // true → / redirects to /setup
 }
 
 const DEFAULTS: ServerSettings = {
@@ -108,6 +108,9 @@ export function readSettings(): ServerSettings {
       webPassword: typeof parsed.webPassword === 'string' ? parsed.webPassword : undefined,
       authToken:   typeof parsed.authToken   === 'string' ? parsed.authToken   : undefined,
       mcpPort:     typeof parsed.mcpPort     === 'number' ? parsed.mcpPort     : undefined,
+      port:        typeof parsed.port        === 'number' ? parsed.port        : undefined,
+      startMode:   typeof parsed.startMode   === 'string' ? parsed.startMode as ServerSettings['startMode'] : undefined,
+      setupPending: parsed.setupPending === true ? true : undefined,
     };
   } catch {
     return { ...DEFAULTS, ai: { ...DEFAULTS.ai, providers: { ...DEFAULTS.ai.providers } } };
@@ -123,6 +126,14 @@ export function writeSettings(settings: ServerSettings): void {
   const merged: Record<string, unknown> = { ...existing, ai: settings.ai, mindRoot: settings.mindRoot };
   if (settings.webPassword !== undefined) merged.webPassword = settings.webPassword;
   if (settings.authToken   !== undefined) merged.authToken   = settings.authToken;
+  if (settings.port        !== undefined) merged.port        = settings.port;
+  if (settings.mcpPort     !== undefined) merged.mcpPort     = settings.mcpPort;
+  if (settings.startMode   !== undefined) merged.startMode   = settings.startMode;
+  // setupPending: false/undefined → remove the field (cleanup); true → set it
+  if ('setupPending' in settings) {
+    if (settings.setupPending) merged.setupPending = true;
+    else delete merged.setupPending;
+  }
   fs.writeFileSync(SETTINGS_PATH, JSON.stringify(merged, null, 2) + '\n', 'utf-8');
 }
 
@@ -146,5 +157,5 @@ export function effectiveAiConfig() {
 /** Effective MIND_ROOT — settings file can override, env var is fallback */
 export function effectiveSopRoot(): string {
   const s = readSettings();
-  return s.mindRoot || process.env.MIND_ROOT || path.join(os.homedir(), '.mindos', 'my-mind');
+  return s.mindRoot || process.env.MIND_ROOT || path.join(os.homedir(), 'MindOS');
 }

package/app/lib/template.ts

@@ -0,0 +1,45 @@
+import fs from 'fs';
+import path from 'path';
+
+/**
+ * Recursively copy `src` to `dest`, skipping files that already exist in dest.
+ */
+export 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;
+    const dir = path.dirname(dest);
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+    fs.copyFileSync(src, dest);
+  }
+}
+
+/**
+ * Apply a built-in template (en / zh / empty) to the given directory.
+ * Returns true on success, throws on error.
+ */
+export function applyTemplate(template: string, destDir: string): void {
+  if (!['en', 'zh', 'empty'].includes(template)) {
+    throw new Error(`Invalid template: ${template}`);
+  }
+
+  // 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)) {
+    throw new Error(`Template "${template}" not found at ${templateDir}`);
+  }
+
+  if (!fs.existsSync(destDir)) {
+    fs.mkdirSync(destDir, { recursive: true });
+  }
+
+  copyRecursive(templateDir, destDir);
+}

package/app/public/manifest.json

@@ -0,0 +1,26 @@
+{
+  "name": "MindOS",
+  "short_name": "MindOS",
+  "description": "Personal knowledge OS — browse, edit, and query your second brain.",
+  "start_url": "/",
+  "display": "standalone",
+  "background_color": "#0a0a0a",
+  "theme_color": "#c8871e",
+  "icons": [
+    {
+      "src": "/icons/icon-192.png",
+      "sizes": "192x192",
+      "type": "image/png"
+    },
+    {
+      "src": "/icons/icon-512.png",
+      "sizes": "512x512",
+      "type": "image/png"
+    },
+    {
+      "src": "/logo-square.svg",
+      "sizes": "any",
+      "type": "image/svg+xml"
+    }
+  ]
+}

package/app/public/sw.js

@@ -0,0 +1,66 @@
+// MindOS Service Worker — cache static assets, skip API/dynamic routes
+const CACHE_NAME = 'mindos-v1';
+
+const PRECACHE_URLS = [
+  '/',
+  '/logo-square.svg',
+  '/logo.svg',
+];
+
+self.addEventListener('install', (event) => {
+  event.waitUntil(
+    caches.open(CACHE_NAME).then((cache) => cache.addAll(PRECACHE_URLS))
+  );
+  self.skipWaiting();
+});
+
+self.addEventListener('activate', (event) => {
+  event.waitUntil(
+    caches.keys().then((keys) =>
+      Promise.all(
+        keys.filter((k) => k !== CACHE_NAME).map((k) => caches.delete(k))
+      )
+    )
+  );
+  self.clients.claim();
+});
+
+self.addEventListener('fetch', (event) => {
+  const url = new URL(event.request.url);
+
+  // Never cache API routes or Next.js internals
+  if (
+    url.pathname.startsWith('/api/') ||
+    url.pathname.startsWith('/_next/') ||
+    event.request.method !== 'GET'
+  ) {
+    return;
+  }
+
+  // Cache-first for static assets (images, fonts, SVGs)
+  if (
+    url.pathname.startsWith('/icons/') ||
+    url.pathname.endsWith('.svg') ||
+    url.pathname.endsWith('.png') ||
+    url.pathname.endsWith('.woff2')
+  ) {
+    event.respondWith(
+      caches.match(event.request).then((cached) => {
+        if (cached) return cached;
+        return fetch(event.request).then((response) => {
+          if (response.ok) {
+            const clone = response.clone();
+            caches.open(CACHE_NAME).then((cache) => cache.put(event.request, clone));
+          }
+          return response;
+        });
+      })
+    );
+    return;
+  }
+
+  // Network-first for HTML pages
+  event.respondWith(
+    fetch(event.request).catch(() => caches.match(event.request))
+  );
+});

package/bin/cli.js

@@ -445,6 +445,27 @@ ${dim('Shortcut: mindos start --daemon  →  install + start in one step')}
       }
     }
 
+    // 8. Sync status
+    if (config?.mindRoot) {
+      try {
+        const syncStatus = getSyncStatus(config.mindRoot);
+        if (!syncStatus.enabled) {
+          warn(`Cross-device sync is not configured  ${dim('(run `mindos sync init` to set up)')}`);
+        } else if (syncStatus.lastError) {
+          err(`Sync error: ${syncStatus.lastError}`);
+          hasError = true;
+        } else if (syncStatus.conflicts && syncStatus.conflicts.length > 0) {
+          warn(`Sync has ${syncStatus.conflicts.length} unresolved conflict(s)  ${dim('(run `mindos sync conflicts` to view)')}`);
+        } else {
+          const unpushed = parseInt(syncStatus.unpushed || '0', 10);
+          const extra = unpushed > 0 ? `  ${dim(`(${unpushed} unpushed commit(s))`)}` : '';
+          ok(`Sync enabled  ${dim(syncStatus.remote || 'origin')}${extra}`);
+        }
+      } catch {
+        warn('Could not check sync status');
+      }
+    }
+
     console.log(hasError
       ? `\n${red('Some checks failed.')} Run ${cyan('mindos onboard')} to reconfigure.\n`
       : `\n${green('All checks passed.')}\n`);