@geminilight/mindos 0.5.2 → 0.5.5

package/app/components/settings/McpTab.tsx

@@ -28,6 +28,7 @@ interface AgentInfo {
   configPath?: string;
   hasProjectScope: boolean;
   hasGlobalScope: boolean;
+  preferredTransport: 'stdio' | 'http';
 }
 
 interface SkillInfo {
@@ -133,13 +134,18 @@ function ServerStatus({ status, t }: { status: McpStatus | null; t: any }) {
 function AgentInstall({ agents, t, onRefresh }: { agents: AgentInfo[]; t: any; onRefresh: () => void }) {
   const m = t.settings?.mcp;
   const [selected, setSelected] = useState<Set<string>>(new Set());
-  const [transport, setTransport] = useState<'stdio' | 'http'>('stdio');
+  const [transport, setTransport] = useState<'auto' | 'stdio' | 'http'>('auto');
   const [httpUrl, setHttpUrl] = useState('http://localhost:8787/mcp');
   const [httpToken, setHttpToken] = useState('');
   const [scopes, setScopes] = useState<Record<string, 'project' | 'global'>>({});
   const [installing, setInstalling] = useState(false);
   const [message, setMessage] = useState<{ type: 'success' | 'error'; text: string } | null>(null);
 
+  const getEffectiveTransport = (agent: AgentInfo) => {
+    if (transport === 'auto') return agent.preferredTransport;
+    return transport;
+  };
+
   const toggle = (key: string) => {
     setSelected(prev => {
       const next = new Set(prev);
@@ -154,12 +160,21 @@ function AgentInstall({ agents, t, onRefresh }: { agents: AgentInfo[]; t: any; o
     setMessage(null);
     try {
       const payload = {
-        agents: [...selected].map(key => ({
-          key,
-          scope: scopes[key] || (agents.find(a => a.key === key)?.hasProjectScope ? 'project' : 'global'),
-        })),
+        agents: [...selected].map(key => {
+          const agent = agents.find(a => a.key === key);
+          const effectiveTransport = transport === 'auto'
+            ? (agent?.preferredTransport || 'stdio')
+            : transport;
+          return {
+            key,
+            scope: scopes[key] || (agents.find(a => a.key === key)?.hasProjectScope ? 'project' : 'global'),
+            transport: effectiveTransport,
+          };
+        }),
         transport,
         ...(transport === 'http' ? { url: httpUrl, token: httpToken } : {}),
+        // For auto mode, pass http settings for agents that need it
+        ...(transport === 'auto' ? { url: httpUrl, token: httpToken } : {}),
       };
       const res = await apiFetch<{ results: Array<{ agent: string; status: string; message?: string }> }>('/api/mcp/install', {
         method: 'POST',
@@ -183,6 +198,12 @@ function AgentInstall({ agents, t, onRefresh }: { agents: AgentInfo[]; t: any; o
     }
   };
 
+  // Show http fields if transport is 'http', or 'auto' with any http-preferred agent selected
+  const showHttpFields = transport === 'http' || (transport === 'auto' && [...selected].some(key => {
+    const agent = agents.find(a => a.key === key);
+    return agent?.preferredTransport === 'http';
+  }));
+
   return (
     <div className="space-y-3">
       <SectionLabel>{m?.agentsTitle ?? 'Agent Configuration'}</SectionLabel>
@@ -198,6 +219,10 @@ function AgentInstall({ agents, t, onRefresh }: { agents: AgentInfo[]; t: any; o
               className="rounded border-border accent-amber-500"
             />
             <span className="w-28 shrink-0 text-xs">{agent.name}</span>
+            <span className="text-[10px] px-1.5 py-0.5 rounded font-mono"
+              style={{ background: 'rgba(100,100,120,0.08)' }}>
+              {getEffectiveTransport(agent)}
+            </span>
             {agent.installed ? (
               <>
                 <span className="text-[10px] px-1.5 py-0.5 rounded bg-green-500/15 text-green-500 font-mono">
@@ -225,6 +250,16 @@ function AgentInstall({ agents, t, onRefresh }: { agents: AgentInfo[]; t: any; o
 
       {/* Transport selector */}
       <div className="flex items-center gap-4 text-xs pt-1">
+        <label className="flex items-center gap-1.5 cursor-pointer">
+          <input
+            type="radio"
+            name="transport"
+            checked={transport === 'auto'}
+            onChange={() => setTransport('auto')}
+            className="accent-amber-500"
+          />
+          {m?.transportAuto ?? 'auto (recommended)'}
+        </label>
         <label className="flex items-center gap-1.5 cursor-pointer">
           <input
             type="radio"
@@ -233,7 +268,7 @@ function AgentInstall({ agents, t, onRefresh }: { agents: AgentInfo[]; t: any; o
             onChange={() => setTransport('stdio')}
             className="accent-amber-500"
           />
-          {m?.transportStdio ?? 'stdio (recommended)'}
+          {m?.transportStdio ?? 'stdio'}
         </label>
         <label className="flex items-center gap-1.5 cursor-pointer">
           <input
@@ -248,7 +283,7 @@ function AgentInstall({ agents, t, onRefresh }: { agents: AgentInfo[]; t: any; o
       </div>
 
       {/* HTTP settings */}
-      {transport === 'http' && (
+      {showHttpFields && (
         <div className="space-y-2 pl-5 text-xs">
           <div className="space-y-1">
             <label className="text-muted-foreground">{m?.httpUrl ?? 'MCP URL'}</label>
@@ -379,6 +414,49 @@ function SkillsSection({ t }: { t: any }) {
     <div className="space-y-3">
       <SectionLabel>{m?.skillsTitle ?? 'Skills'}</SectionLabel>
 
+      {/* Skill language switcher */}
+      {(() => {
+        const mindosEnabled = skills.find(s => s.name === 'mindos')?.enabled ?? true;
+        const currentLang = mindosEnabled ? 'en' : 'zh';
+        const handleLangSwitch = async (lang: 'en' | 'zh') => {
+          if (lang === currentLang) return;
+          if (lang === 'en') {
+            await handleToggle('mindos', true);
+            await handleToggle('mindos-zh', false);
+          } else {
+            await handleToggle('mindos-zh', true);
+            await handleToggle('mindos', false);
+          }
+        };
+        return (
+          <div className="flex items-center gap-2 text-xs">
+            <span className="text-muted-foreground">{m?.skillLanguage ?? 'Skill Language'}</span>
+            <div className="flex rounded-md border border-border overflow-hidden">
+              <button
+                onClick={() => handleLangSwitch('en')}
+                className={`px-2.5 py-1 text-xs transition-colors ${
+                  currentLang === 'en'
+                    ? 'bg-amber-500/15 text-amber-600 font-medium'
+                    : 'text-muted-foreground hover:bg-muted'
+                }`}
+              >
+                {m?.skillLangEn ?? 'English'}
+              </button>
+              <button
+                onClick={() => handleLangSwitch('zh')}
+                className={`px-2.5 py-1 text-xs transition-colors border-l border-border ${
+                  currentLang === 'zh'
+                    ? 'bg-amber-500/15 text-amber-600 font-medium'
+                    : 'text-muted-foreground hover:bg-muted'
+                }`}
+              >
+                {m?.skillLangZh ?? '中文'}
+              </button>
+            </div>
+          </div>
+        );
+      })()}
+
       {skills.map(skill => (
         <div key={skill.name} className="border border-border rounded-lg overflow-hidden">
           <div

package/app/components/settings/PluginsTab.tsx

@@ -19,7 +19,8 @@ export function PluginsTab({ pluginStates, setPluginStates, t }: PluginsTabProps
       ) : (
         <div className="flex flex-col gap-3">
           {getAllRenderers().map(renderer => {
-            const enabled = pluginStates[renderer.id] ?? true;
+            const isCore = !!renderer.core;
+            const enabled = isCore ? true : (pluginStates[renderer.id] ?? true);
             return (
               <div
                 key={renderer.id}
@@ -31,7 +32,12 @@ export function PluginsTab({ pluginStates, setPluginStates, t }: PluginsTabProps
                     <div className="min-w-0">
                       <div className="flex items-center gap-2 flex-wrap">
                         <span className="text-sm font-medium text-foreground">{renderer.name}</span>
-                        {renderer.builtin && (
+                        {isCore && (
+                          <span className="text-[10px] px-1.5 py-0.5 rounded bg-amber-600/15 text-amber-600 font-mono">
+                            core
+                          </span>
+                        )}
+                        {renderer.builtin && !isCore && (
                           <span className="text-[10px] px-1.5 py-0.5 rounded bg-muted text-muted-foreground font-mono">
                             {t.settings.plugins.builtinBadge}
                           </span>
@@ -51,21 +57,30 @@ export function PluginsTab({ pluginStates, setPluginStates, t }: PluginsTabProps
                     </div>
                   </div>
 
-                  <button
-                    onClick={() => {
-                      const next = !enabled;
-                      setRendererEnabled(renderer.id, next);
-                      setPluginStates(s => ({ ...s, [renderer.id]: next }));
-                    }}
-                    role="switch"
-                    aria-checked={enabled}
-                    className={`shrink-0 w-9 h-5 rounded-full transition-colors relative ${enabled ? 'bg-amber-600' : 'bg-muted border border-border'}`}
-                    title={enabled ? t.settings.plugins.enabled : t.settings.plugins.disabled}
-                  >
+                  {isCore ? (
                     <span
-                      className={`absolute top-[3px] w-3.5 h-3.5 rounded-full shadow-sm transition-all ${enabled ? 'left-[18px] bg-white' : 'left-[3px] bg-muted-foreground/50'}`}
-                    />
-                  </button>
+                      className="shrink-0 w-9 h-5 rounded-full bg-amber-600 relative cursor-not-allowed opacity-60"
+                      title={t.settings.plugins.coreHint ?? 'Core renderer — always enabled'}
+                    >
+                      <span className="absolute top-[3px] left-[18px] w-3.5 h-3.5 rounded-full shadow-sm bg-white" />
+                    </span>
+                  ) : (
+                    <button
+                      onClick={() => {
+                        const next = !enabled;
+                        setRendererEnabled(renderer.id, next);
+                        setPluginStates(s => ({ ...s, [renderer.id]: next }));
+                      }}
+                      role="switch"
+                      aria-checked={enabled}
+                      className={`shrink-0 w-9 h-5 rounded-full transition-colors relative ${enabled ? 'bg-amber-600' : 'bg-muted border border-border'}`}
+                      title={enabled ? t.settings.plugins.enabled : t.settings.plugins.disabled}
+                    >
+                      <span
+                        className={`absolute top-[3px] w-3.5 h-3.5 rounded-full shadow-sm transition-all ${enabled ? 'left-[18px] bg-white' : 'left-[3px] bg-muted-foreground/50'}`}
+                      />
+                    </button>
+                  )}
                 </div>
               </div>
             );

package/app/lib/i18n.ts

@@ -171,6 +171,7 @@ export const messages = {
         enabled: 'Enabled',
         disabled: 'Disabled',
         matchHint: 'Auto-activates on',
+        coreHint: 'Core renderer — always enabled',
         noPlugins: 'No renderers installed.',
         comingSoon: 'Plugin marketplace coming soon.',
       },
@@ -198,6 +199,7 @@ export const messages = {
         notInstalled: 'Not installed',
         transportStdio: 'stdio (recommended)',
         transportHttp: 'http',
+        transportAuto: 'auto (recommended)',
         httpUrl: 'MCP URL',
         httpToken: 'Auth Token',
         installSelected: 'Install Selected',
@@ -221,8 +223,10 @@ export const messages = {
         skillContent: 'Content',
         skillNameConflict: 'A skill with this name already exists',
         skillDeleteConfirm: (name: string) => `Delete skill "${name}"? This cannot be undone.`,
-      },
-      save: 'Save',
+        skillLanguage: 'Skill Language',
+        skillLangEn: 'English',
+        skillLangZh: '中文',
+      },      save: 'Save',
       saved: 'Saved',
       saveFailed: 'Save failed',
       reconfigure: 'Reconfigure',
@@ -292,7 +296,7 @@ export const messages = {
       webPort: 'Web UI port',
       mcpPort: 'MCP server port',
       portHint: 'Valid range: 1024–65535',
-      portRestartWarning: 'Port changes take effect after server restart.',
+      portRestartWarning: 'The service will start on these ports after setup completes.',
       portInUse: (p: number) => `Port ${p} is already in use.`,
       portSuggest: (p: number) => `Use ${p}`,
       portChecking: 'Checking…',
@@ -324,6 +328,17 @@ export const messages = {
       agentStatusOk: 'configured',
       agentStatusError: 'failed',
       agentInstalling: 'Configuring…',
+      agentTransportAuto: 'Auto (recommended)',
+      agentTransportLabel: 'Transport',
+      agentVerified: 'verified',
+      agentUnverified: 'unverified',
+      agentVerifyNote: 'stdio agents are verified after restart',
+      // Skill auto-install
+      skillAutoHint: (name: string) => `Based on your template, the "${name}" skill will be installed to selected agents.`,
+      skillLabel: 'Skill',
+      skillInstalling: 'Installing skill…',
+      skillInstalled: 'Skill installed',
+      skillFailed: 'Skill install failed',
       // Step 2 — AI skip card
       aiSkipTitle: 'Skip for now',
       aiSkipDesc: 'You can add an API key later in Settings → AI.',
@@ -525,6 +540,7 @@ export const messages = {
         enabled: '已启用',
         disabled: '已禁用',
         matchHint: '自动匹配',
+        coreHint: '核心渲染器 — 始终启用',
         noPlugins: '暂无渲染器。',
         comingSoon: '插件市场即将上线。',
       },
@@ -552,6 +568,7 @@ export const messages = {
         notInstalled: '未安装',
         transportStdio: 'stdio（推荐）',
         transportHttp: 'http',
+        transportAuto: '自动（推荐）',
         httpUrl: 'MCP URL',
         httpToken: '认证 Token',
         installSelected: '安装选中',
@@ -575,8 +592,10 @@ export const messages = {
         skillContent: '内容',
         skillNameConflict: '同名 skill 已存在',
         skillDeleteConfirm: (name: string) => `确定删除「${name}」？此操作不可撤销。`,
-      },
-      save: '保存',
+        skillLanguage: 'Skill 语言',
+        skillLangEn: 'English',
+        skillLangZh: '中文',
+      },      save: '保存',
       saved: '已保存',
       saveFailed: '保存失败',
       reconfigure: '重新配置',
@@ -646,7 +665,7 @@ export const messages = {
       webPort: 'Web UI 端口',
       mcpPort: 'MCP 服务端口',
       portHint: '有效范围：1024–65535',
-      portRestartWarning: '端口修改需重启服务后生效。',
+      portRestartWarning: '完成配置后，服务将以这些端口启动。',
       portInUse: (p: number) => `端口 ${p} 已被占用。`,
       portSuggest: (p: number) => `使用 ${p}`,
       portChecking: '检测中…',
@@ -678,6 +697,17 @@ export const messages = {
       agentStatusOk: '已配置',
       agentStatusError: '失败',
       agentInstalling: '配置中…',
+      agentTransportAuto: '自动（推荐）',
+      agentTransportLabel: '传输方式',
+      agentVerified: '已验证',
+      agentUnverified: '未验证',
+      agentVerifyNote: 'stdio agent 需重启后验证',
+      // Skill auto-install
+      skillAutoHint: (name: string) => `根据您选择的模板，将向选中的 Agent 安装「${name}」Skill。`,
+      skillLabel: 'Skill',
+      skillInstalling: '正在安装 Skill…',
+      skillInstalled: 'Skill 已安装',
+      skillFailed: 'Skill 安装失败',
       // Step 2 — AI skip card
       aiSkipTitle: '暂时跳过',
       aiSkipDesc: '稍后可在 设置 → AI 中添加 API 密钥。',

package/app/lib/mcp-agents.ts

@@ -11,18 +11,19 @@ export interface AgentDef {
   project: string | null;
   global: string;
   key: string;
+  preferredTransport: 'stdio' | 'http';
 }
 
 export const MCP_AGENTS: Record<string, AgentDef> = {
-  'claude-code':    { name: 'Claude Code',    project: '.mcp.json',                       global: '~/.claude.json',    key: 'mcpServers' },
-  'claude-desktop': { name: 'Claude Desktop', project: null,                               global: process.platform === 'darwin' ? '~/Library/Application Support/Claude/claude_desktop_config.json' : '~/.config/Claude/claude_desktop_config.json', key: 'mcpServers' },
-  'cursor':         { name: 'Cursor',          project: '.cursor/mcp.json',                global: '~/.cursor/mcp.json', key: 'mcpServers' },
-  'windsurf':       { name: 'Windsurf',        project: null,                               global: '~/.codeium/windsurf/mcp_config.json', key: 'mcpServers' },
-  'cline':          { name: 'Cline',           project: null,                               global: process.platform === 'darwin' ? '~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json' : '~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json', key: 'mcpServers' },
-  'trae':           { name: 'Trae',            project: '.trae/mcp.json',                  global: '~/.trae/mcp.json', key: 'mcpServers' },
-  'gemini-cli':     { name: 'Gemini CLI',      project: '.gemini/settings.json',           global: '~/.gemini/settings.json', key: 'mcpServers' },
-  'openclaw':       { name: 'OpenClaw',        project: null,                               global: '~/.openclaw/mcp.json', key: 'mcpServers' },
-  'codebuddy':      { name: 'CodeBuddy',       project: null,                               global: '~/.claude-internal/.claude.json', key: 'mcpServers' },
+  'claude-code':    { name: 'Claude Code',    project: '.mcp.json',                       global: '~/.claude.json',    key: 'mcpServers', preferredTransport: 'stdio' },
+  'claude-desktop': { name: 'Claude Desktop', project: null,                               global: process.platform === 'darwin' ? '~/Library/Application Support/Claude/claude_desktop_config.json' : '~/.config/Claude/claude_desktop_config.json', key: 'mcpServers', preferredTransport: 'http' },
+  'cursor':         { name: 'Cursor',          project: '.cursor/mcp.json',                global: '~/.cursor/mcp.json', key: 'mcpServers', preferredTransport: 'stdio' },
+  'windsurf':       { name: 'Windsurf',        project: null,                               global: '~/.codeium/windsurf/mcp_config.json', key: 'mcpServers', preferredTransport: 'stdio' },
+  'cline':          { name: 'Cline',           project: null,                               global: process.platform === 'darwin' ? '~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json' : '~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json', key: 'mcpServers', preferredTransport: 'stdio' },
+  'trae':           { name: 'Trae',            project: '.trae/mcp.json',                  global: '~/.trae/mcp.json', key: 'mcpServers', preferredTransport: 'stdio' },
+  'gemini-cli':     { name: 'Gemini CLI',      project: '.gemini/settings.json',           global: '~/.gemini/settings.json', key: 'mcpServers', preferredTransport: 'stdio' },
+  'openclaw':       { name: 'OpenClaw',        project: null,                               global: '~/.openclaw/mcp.json', key: 'mcpServers', preferredTransport: 'stdio' },
+  'codebuddy':      { name: 'CodeBuddy',       project: null,                               global: '~/.claude-internal/.claude.json', key: 'mcpServers', preferredTransport: 'stdio' },
 };
 
 export function detectInstalled(agentKey: string): { installed: boolean; scope?: string; transport?: string; configPath?: string } {

package/app/lib/renderers/registry.ts

@@ -15,6 +15,7 @@ export interface RendererDefinition {
   icon: string;          // emoji or short string
   tags: string[];
   builtin: boolean;      // true = ships with MindOS; false = user-installed (future)
+  core?: boolean;        // true = default renderer for a file type, cannot be disabled by user
   entryPath?: string;    // canonical entry file shown on home page (e.g. 'TODO.md')
   match: (ctx: Pick<RendererContext, 'filePath' | 'extension'>) => boolean;
   // Provide either `component` (eager) or `load` (lazy). Prefer `load` for code-splitting.
@@ -38,6 +39,9 @@ export function loadDisabledState() {
 }
 
 export function setRendererEnabled(id: string, enabled: boolean) {
+  // Core renderers cannot be disabled
+  const def = registry.find(r => r.id === id);
+  if (def?.core) return;
   if (enabled) {
     _disabledIds.delete(id);
   } else {
@@ -49,6 +53,9 @@ export function setRendererEnabled(id: string, enabled: boolean) {
 }
 
 export function isRendererEnabled(id: string): boolean {
+  // Core renderers cannot be disabled
+  const def = registry.find(r => r.id === id);
+  if (def?.core) return true;
   return !_disabledIds.has(id);
 }
 

package/app/lib/renderers/useRendererState.ts

@@ -0,0 +1,114 @@
+'use client';
+
+import { useSyncExternalStore, useCallback, useRef } from 'react';
+
+/**
+ * Unified per-file state hook for renderers.
+ *
+ * Each renderer stores its state under a namespaced localStorage key:
+ *   `mindos-renderer:{rendererId}:{filePath}`
+ *
+ * Usage:
+ *   const [cfg, setCfg] = useRendererState<CsvConfig>('csv', filePath, defaultCfg);
+ *
+ * The state is reactive — changes from other tabs/windows or from other
+ * components calling the setter will trigger a re-render via
+ * `useSyncExternalStore`.
+ */
+
+const CHANGE_EVENT = 'mindos-renderer-state-change';
+
+function storageKey(rendererId: string, filePath: string): string {
+  return `mindos-renderer:${rendererId}:${filePath}`;
+}
+
+export function useRendererState<T>(
+  rendererId: string,
+  filePath: string,
+  defaultValue: T,
+): [T, (value: T | ((prev: T) => T)) => void] {
+  const key = storageKey(rendererId, filePath);
+
+  // Cache parsed value to maintain referential stability for useSyncExternalStore.
+  // Without this, JSON.parse returns a new object on every getSnapshot call,
+  // causing Object.is to fail → infinite re-renders for non-primitive types.
+  const cacheRef = useRef<{ key: string; raw: string | null; parsed: T }>({ key, raw: null, parsed: defaultValue });
+
+  // Reset cache when key changes (different file or different renderer)
+  if (cacheRef.current.key !== key) {
+    cacheRef.current = { key, raw: null, parsed: defaultValue };
+  }
+
+  const state = useSyncExternalStore(
+    (onStoreChange) => {
+      const listener = () => onStoreChange();
+      window.addEventListener('storage', listener);
+      window.addEventListener(CHANGE_EVENT, listener);
+      return () => {
+        window.removeEventListener('storage', listener);
+        window.removeEventListener(CHANGE_EVENT, listener);
+      };
+    },
+    () => {
+      try {
+        const raw = localStorage.getItem(key);
+        if (raw === cacheRef.current.raw) return cacheRef.current.parsed;
+        if (raw === null) {
+          cacheRef.current = { key, raw: null, parsed: defaultValue };
+          return defaultValue;
+        }
+        const parsed = JSON.parse(raw) as T;
+        cacheRef.current = { key, raw, parsed };
+        return parsed;
+      } catch {
+        return defaultValue;
+      }
+    },
+    () => defaultValue,
+  );
+
+  const setState = useCallback(
+    (value: T | ((prev: T) => T)) => {
+      try {
+        const current = (() => {
+          try {
+            const raw = localStorage.getItem(key);
+            return raw !== null ? (JSON.parse(raw) as T) : defaultValue;
+          } catch {
+            return defaultValue;
+          }
+        })();
+        const next = typeof value === 'function' ? (value as (prev: T) => T)(current) : value;
+        const serialized = JSON.stringify(next);
+        localStorage.setItem(key, serialized);
+        // Update cache eagerly so the next getSnapshot returns stable ref
+        cacheRef.current = { key, raw: serialized, parsed: next };
+      } catch { /* ignore quota errors */ }
+      window.dispatchEvent(new Event(CHANGE_EVENT));
+    },
+    [key, defaultValue],
+  );
+
+  return [state, setState];
+}
+
+/**
+ * Non-hook helpers for reading/writing renderer state outside React components.
+ */
+export function getRendererState<T>(rendererId: string, filePath: string, defaultValue: T): T {
+  if (typeof window === 'undefined') return defaultValue;
+  try {
+    const raw = localStorage.getItem(storageKey(rendererId, filePath));
+    return raw !== null ? (JSON.parse(raw) as T) : defaultValue;
+  } catch {
+    return defaultValue;
+  }
+}
+
+export function setRendererState<T>(rendererId: string, filePath: string, value: T): void {
+  if (typeof window === 'undefined') return;
+  try {
+    localStorage.setItem(storageKey(rendererId, filePath), JSON.stringify(value));
+  } catch { /* ignore */ }
+  window.dispatchEvent(new Event(CHANGE_EVENT));
+}

package/bin/cli.js

@@ -550,7 +550,9 @@ ${dim('Shortcut: mindos start --daemon  →  install + start in one step')}
       await runGatewayCommand('stop');
       await runGatewayCommand('install');
       await runGatewayCommand('start');
-      const webPort = process.env.MINDOS_WEB_PORT || '3000';
+      const webPort = (() => {
+        try { return JSON.parse(readFileSync(CONFIG_PATH, 'utf-8')).port ?? 3000; } catch { return 3000; }
+      })();
       console.log(dim('  (Waiting for Web UI to come back up...)'));
       const ready = await waitForHttp(Number(webPort), { retries: 120, intervalMs: 2000, label: 'Web UI' });
       if (ready) {

package/bin/lib/gateway.js

@@ -31,7 +31,7 @@ export async function waitForHttp(port, { retries = 120, intervalMs = 2000, labe
     try {
       const { request } = await import('node:http');
       const ok = await new Promise((resolve) => {
-        const req = request({ hostname: '127.0.0.1', port, path: '/', method: 'HEAD', timeout: 1500 },
+        const req = request({ hostname: '127.0.0.1', port, path: '/api/health', method: 'GET', timeout: 1500 },
           (res) => { res.resume(); resolve(res.statusCode < 500); });
         req.on('error', () => resolve(false));
         req.on('timeout', () => { req.destroy(); resolve(false); });

package/bin/lib/mcp-agents.js

@@ -4,13 +4,13 @@
  */
 
 export const MCP_AGENTS = {
-  'claude-code':    { name: 'Claude Code',    project: '.mcp.json',                       global: '~/.claude.json',                                                                         key: 'mcpServers' },
-  'claude-desktop': { name: 'Claude Desktop', project: null,                               global: process.platform === 'darwin' ? '~/Library/Application Support/Claude/claude_desktop_config.json' : '~/.config/Claude/claude_desktop_config.json', key: 'mcpServers' },
-  'cursor':         { name: 'Cursor',          project: '.cursor/mcp.json',                global: '~/.cursor/mcp.json',                                                                     key: 'mcpServers' },
-  'windsurf':       { name: 'Windsurf',        project: null,                               global: '~/.codeium/windsurf/mcp_config.json',                                                   key: 'mcpServers' },
-  'cline':          { name: 'Cline',           project: null,                               global: process.platform === 'darwin' ? '~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json' : '~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json', key: 'mcpServers' },
-  'trae':           { name: 'Trae',            project: '.trae/mcp.json',                  global: '~/.trae/mcp.json',                                                                       key: 'mcpServers' },
-  'gemini-cli':     { name: 'Gemini CLI',      project: '.gemini/settings.json',           global: '~/.gemini/settings.json',                                                                key: 'mcpServers' },
-  'openclaw':       { name: 'OpenClaw',        project: null,                               global: '~/.openclaw/mcp.json',                                                                   key: 'mcpServers' },
-  'codebuddy':      { name: 'CodeBuddy',       project: null,                               global: '~/.claude-internal/.claude.json',                                                        key: 'mcpServers' },
+  'claude-code':    { name: 'Claude Code',    project: '.mcp.json',                       global: '~/.claude.json',                                                                         key: 'mcpServers', preferredTransport: 'stdio' },
+  'claude-desktop': { name: 'Claude Desktop', project: null,                               global: process.platform === 'darwin' ? '~/Library/Application Support/Claude/claude_desktop_config.json' : '~/.config/Claude/claude_desktop_config.json', key: 'mcpServers', preferredTransport: 'http' },
+  'cursor':         { name: 'Cursor',          project: '.cursor/mcp.json',                global: '~/.cursor/mcp.json',                                                                     key: 'mcpServers', preferredTransport: 'stdio' },
+  'windsurf':       { name: 'Windsurf',        project: null,                               global: '~/.codeium/windsurf/mcp_config.json',                                                   key: 'mcpServers', preferredTransport: 'stdio' },
+  'cline':          { name: 'Cline',           project: null,                               global: process.platform === 'darwin' ? '~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json' : '~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json', key: 'mcpServers', preferredTransport: 'stdio' },
+  'trae':           { name: 'Trae',            project: '.trae/mcp.json',                  global: '~/.trae/mcp.json',                                                                       key: 'mcpServers', preferredTransport: 'stdio' },
+  'gemini-cli':     { name: 'Gemini CLI',      project: '.gemini/settings.json',           global: '~/.gemini/settings.json',                                                                key: 'mcpServers', preferredTransport: 'stdio' },
+  'openclaw':       { name: 'OpenClaw',        project: null,                               global: '~/.openclaw/mcp.json',                                                                   key: 'mcpServers', preferredTransport: 'stdio' },
+  'codebuddy':      { name: 'CodeBuddy',       project: null,                               global: '~/.claude-internal/.claude.json',                                                        key: 'mcpServers', preferredTransport: 'stdio' },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geminilight/mindos",
-  "version": "0.5.2",
+  "version": "0.5.5",
   "description": "MindOS — Human-Agent Collaborative Mind System. Local-first knowledge base that syncs your mind to all AI Agents via MCP.",
   "keywords": [
     "mindos",