@geminilight/mindos 0.6.56 → 0.6.58

package/app/lib/i18n/modules/panels.ts

@@ -313,6 +313,58 @@ export const panelsEn = {
       recentActivity: 'Recent Activity',
       viewAll: 'View all',
       showLess: 'Show less',
+      addCustomAgent: 'Add your own agent',
+      addCustomAgentTitle: 'Add Custom Agent',
+      editCustomAgentTitle: (name: string) => `Edit ${name}`,
+      customAgentName: 'Agent Name',
+      customAgentNamePlaceholder: 'e.g. QCLaw, WorkBuddy',
+      customAgentDir: 'Config Directory',
+      customAgentDirPlaceholder: '~/.qclaw/',
+      customAgentDirHint: 'Common: ~/.xxx/ or ~/Library/Application Support/',
+      customAgentKeyPreview: (key: string) => `Key: ${key}`,
+      customAgentContinue: 'Continue',
+      customAgentDetecting: 'Detecting...',
+      customAgentDirFound: 'Directory found',
+      customAgentDirNotFound: 'Not found yet — agent will appear when installed',
+      customAgentDetectTimeout: 'Detection timed out, using defaults',
+      customAgentDetectedTitle: 'Detected Configuration',
+      customAgentDefaultTitle: 'Default Configuration',
+      customAgentConfigLabel: 'MCP Config',
+      customAgentFormatLabel: 'Format',
+      customAgentTransportLabel: 'Transport',
+      customAgentSkillsLabel: 'Skills',
+      customAgentSkillsFound: (n: number) => `${n} skill${n !== 1 ? 's' : ''} found`,
+      customAgentSkillsNone: 'Not detected',
+      customAgentSkillDir: 'Skills Directory',
+      customAgentSkillDirHint: 'Where skills are installed for this agent',
+      customAgentSkillDirPlaceholder: '~/.xxx/skills/',
+      customAgentCustomize: 'Customize these settings',
+      customAgentAdd: 'Add Agent',
+      customAgentAdding: 'Adding...',
+      customAgentSave: 'Save Changes',
+      customAgentSaving: 'Saving...',
+      customAgentRetry: 'Retry',
+      customAgentAdded: (name: string) => `${name} added`,
+      customAgentUpdated: (name: string) => `${name} updated`,
+      customAgentRemoved: (name: string) => `${name} removed`,
+      customAgentRemoveTitle: (name: string) => `Remove "${name}"?`,
+      customAgentRemoveMessage: 'This removes the agent from MindOS. No files will be deleted on disk.',
+      customAgentRemoveConfirm: 'Remove',
+      customAgentConfigPath: 'MCP Config File Path',
+      customAgentConfigKey: 'Config Key',
+      customAgentFormat: 'Format',
+      customAgentTransport: 'Transport',
+      customAgentProjectConfig: 'Project Config (optional)',
+      customAgentCliBinary: 'CLI Binary (optional)',
+      customAgentCliBinaryPlaceholder: 'e.g. qclaw',
+      customAgentEdit: 'Edit',
+      customAgentRemove: 'Remove',
+      customAgentCancel: 'Cancel',
+      customAgentNetworkError: 'Network error. Please try again.',
+      customAgentFailedSave: 'Failed to save',
+      customAgentFailedRemove: 'Failed to remove',
+      customAgentKeyConflict: (key: string) => `An agent with key "${key}" already exists`,
+      customAgentBuiltinConflict: (name: string) => `Conflicts with built-in agent "${name}"`,
     },
     mcp: {
       title: 'MCP Connections',
@@ -949,6 +1001,58 @@ export const panelsZh = {
       recentActivity: '最近活动',
       viewAll: '查看全部',
       showLess: '收起',
+      addCustomAgent: '添加自定义 Agent',
+      addCustomAgentTitle: '添加自定义 Agent',
+      editCustomAgentTitle: (name: string) => `编辑 ${name}`,
+      customAgentName: 'Agent 名称',
+      customAgentNamePlaceholder: '例如 QCLaw、WorkBuddy',
+      customAgentDir: '配置目录',
+      customAgentDirPlaceholder: '~/.qclaw/',
+      customAgentDirHint: '常见路径：~/.xxx/ 或 ~/Library/Application Support/',
+      customAgentKeyPreview: (key: string) => `标识符：${key}`,
+      customAgentContinue: '继续',
+      customAgentDetecting: '检测中...',
+      customAgentDirFound: '目录已找到',
+      customAgentDirNotFound: '目录尚未创建，安装后将自动检测',
+      customAgentDetectTimeout: '检测超时，使用默认配置',
+      customAgentDetectedTitle: '检测到的配置',
+      customAgentDefaultTitle: '默认配置',
+      customAgentConfigLabel: 'MCP 配置',
+      customAgentFormatLabel: '格式',
+      customAgentTransportLabel: '传输协议',
+      customAgentSkillsLabel: '技能',
+      customAgentSkillsFound: (n: number) => `发现 ${n} 个技能`,
+      customAgentSkillsNone: '未检测到',
+      customAgentSkillDir: '技能目录',
+      customAgentSkillDirHint: '此 Agent 安装技能的目录',
+      customAgentSkillDirPlaceholder: '~/.xxx/skills/',
+      customAgentCustomize: '自定义配置',
+      customAgentAdd: '添加 Agent',
+      customAgentAdding: '添加中...',
+      customAgentSave: '保存更改',
+      customAgentSaving: '保存中...',
+      customAgentRetry: '重试',
+      customAgentAdded: (name: string) => `${name} 已添加`,
+      customAgentUpdated: (name: string) => `${name} 已更新`,
+      customAgentRemoved: (name: string) => `${name} 已移除`,
+      customAgentRemoveTitle: (name: string) => `移除「${name}」？`,
+      customAgentRemoveMessage: '这将从 MindOS 中移除该 Agent，不会删除磁盘上的任何文件。',
+      customAgentRemoveConfirm: '移除',
+      customAgentConfigPath: 'MCP 配置文件路径',
+      customAgentConfigKey: '配置键名',
+      customAgentFormat: '格式',
+      customAgentTransport: '传输协议',
+      customAgentProjectConfig: '项目配置路径（可选）',
+      customAgentCliBinary: 'CLI 命令名（可选）',
+      customAgentCliBinaryPlaceholder: '例如 qclaw',
+      customAgentEdit: '编辑',
+      customAgentRemove: '移除',
+      customAgentCancel: '取消',
+      customAgentNetworkError: '网络错误，请重试。',
+      customAgentFailedSave: '保存失败',
+      customAgentFailedRemove: '移除失败',
+      customAgentKeyConflict: (key: string) => `已存在标识为 "${key}" 的 Agent`,
+      customAgentBuiltinConflict: (name: string) => `与内置 Agent "${name}" 冲突`,
     },
     mcp: {
       title: 'MCP 连接',

package/app/lib/image.ts

@@ -0,0 +1,47 @@
+/**
+ * Image path resolution utilities for Markdown.
+ *
+ * Converts markdown image paths (e.g., `![alt](/.media/image.png)`) to API URLs
+ * that can be served by `/api/file/raw?path=...`
+ */
+
+/**
+ * Checks if a path is an absolute path (starts with `/`).
+ */
+function isAbsolutePath(path: string): boolean {
+  return path.startsWith('/');
+}
+
+/**
+ * Checks if a path is a URL (starts with protocol like http://, https://, file://).
+ */
+function isUrl(path: string): boolean {
+  return /^(https?|file):\/\//.test(path);
+}
+
+/**
+ * Resolves an image path to a URL for the API endpoint.
+ *
+ * Rules:
+ * - Absolute paths (start with `/`) → `/api/file/raw?path=...` (strip leading slash)
+ * - URLs (http/https/file) → return as-is
+ * - Relative paths → return as-is (browser handles relative URLs)
+ *
+ * @param imagePath - The image path from markdown syntax
+ * @returns The resolved URL or path
+ */
+export function resolveImagePath(imagePath: string): string {
+  // Already a URL
+  if (isUrl(imagePath)) {
+    return imagePath;
+  }
+
+  // Absolute path like `/.media/image.png` or `/path/to/image.png`
+  if (isAbsolutePath(imagePath)) {
+    const cleanPath = imagePath.slice(1); // Remove leading `/`
+    return `/api/file/raw?path=${encodeURIComponent(cleanPath)}`;
+  }
+
+  // Relative path — return as-is for browser to resolve
+  return imagePath;
+}

package/app/lib/mcp-agents.ts

@@ -235,6 +235,15 @@ export const MCP_AGENTS: Record<string, AgentDef> = {
     presenceCli: 'codex',
     presenceDirs: ['~/.codex/'],
   },
+  'antigravity': {
+    name: 'Antigravity',
+    project: '.antigravity/mcp_config.json',
+    global: '~/.gemini/antigravity/mcp_config.json',
+    key: 'mcpServers',
+    preferredTransport: 'stdio',
+    presenceCli: 'agy',
+    presenceDirs: ['~/.gemini/antigravity/'],
+  },
 };
 
 /**
@@ -261,6 +270,7 @@ export const SKILL_AGENT_REGISTRY: Record<string, SkillAgentRegistration> = {
   'roo': { mode: 'additional', skillAgentName: 'roo' },
   'github-copilot': { mode: 'universal' },
   'codex': { mode: 'universal' },
+  'antigravity': { mode: 'additional', skillAgentName: 'antigravity' },
 };
 
 export interface SkillWorkspaceProfile {

package/app/lib/settings.ts

@@ -58,6 +58,8 @@ export interface ServerSettings {
     cli: boolean;   // Always true (CLI is mandatory)
     mcp: boolean;   // User's explicit choice during onboarding
   };
+  /** User-defined agents not built into MindOS. */
+  customAgents?: import('./custom-agents').CustomAgentDef[];
 }
 
 const DEFAULTS: ServerSettings = {
@@ -216,6 +218,7 @@ export function readSettings(): ServerSettings {
         return Object.keys(result).length > 0 ? result : undefined;
       })(),
       connectionMode: inferConnectionMode(parsed),
+      customAgents: Array.isArray(parsed.customAgents) ? parsed.customAgents as import('./custom-agents').CustomAgentDef[] : undefined,
     };
   } catch {
     // Config file missing or corrupt → force setup wizard
@@ -246,6 +249,7 @@ export function writeSettings(settings: ServerSettings): void {
   if (settings.acpAgents !== undefined) merged.acpAgents = settings.acpAgents;
   if (settings.baseUrlCompat !== undefined) merged.baseUrlCompat = settings.baseUrlCompat;
   if (settings.connectionMode !== undefined) merged.connectionMode = settings.connectionMode;
+  if (settings.customAgents !== undefined) merged.customAgents = settings.customAgents;
   // setupPending: false/undefined → remove the field (cleanup); true → set it
   if ('setupPending' in settings) {
     if (settings.setupPending) merged.setupPending = true;

package/bin/commands/start.js

@@ -59,7 +59,11 @@ export const meta = {
  * @returns {Promise<void>}
  */
 export const run = async (args, flags) => {
-  const isDaemon = Boolean(flags.daemon) || isDaemonMode();
+  // Must be checked BEFORE isDaemon — when a daemon manager has already launched
+  // us, re-entering the daemon installation path causes a recursive loop.
+  const launchedByDaemon =
+    process.env.LAUNCHED_BY_LAUNCHD === '1' || !!process.env.INVOCATION_ID;
+  const isDaemon = !launchedByDaemon && (Boolean(flags.daemon) || isDaemonMode());
   const isVerbose = Boolean(flags.verbose);
   const extra = args.join(' ');
 
@@ -212,9 +216,6 @@ export const run = async (args, flags) => {
   // When launched by a daemon manager (launchd/systemd), wait for ports to
   // free instead of exiting immediately — the previous instance may still be
   // shutting down after a restart/update.
-  const launchedByDaemon =
-    process.env.LAUNCHED_BY_LAUNCHD === '1' || !!process.env.INVOCATION_ID; /* systemd sets INVOCATION_ID */
-
   if (launchedByDaemon) {
     const { waitForPortFree } = await import('../lib/gateway.js');
     const webOk = await waitForPortFree(Number(webPort), { retries: 60, intervalMs: 500 });

package/bin/commands/update.js

@@ -8,7 +8,7 @@ import { execSync, spawn as nodeSpawn } from 'node:child_process';
 import { existsSync, readFileSync, writeFileSync, rmSync, realpathSync } from 'node:fs';
 import { dirname, resolve } from 'node:path';
 
-import { ROOT, BUILD_STAMP, CONFIG_PATH, LOG_PATH } from '../lib/constants.js';
+import { ROOT, BUILD_STAMP, CONFIG_PATH, LOG_PATH, MINDOS_DIR } from '../lib/constants.js';
 import { bold, dim, cyan, green, red, yellow } from '../lib/colors.js';
 import { execInherited } from '../lib/shell.js';
 import { EXIT } from '../lib/command.js';
@@ -21,15 +21,19 @@ import { stripBom } from '../lib/jsonc.js';
 /**
  * Dynamically resolve the new ROOT after `npm install -g`.
  * This is needed because constants are evaluated at module load time.
+ *
+ * Skips ~/.mindos/bin/ — that directory contains our own shell shim
+ * (not a JS file); resolving ROOT from it yields ~/.mindos/ which is wrong.
  */
 function getUpdatedRoot() {
+  const shimBinDir = resolve(MINDOS_DIR, 'bin');
   try {
     const whichCmd = process.platform === 'win32' ? 'where mindos' : 'which mindos';
     const mindosBin = execSync(whichCmd, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'ignore'] }).trim().split(/\r?\n/)[0];
     if (mindosBin) {
       let cliPath;
       try { cliPath = realpathSync(mindosBin); } catch { cliPath = mindosBin; }
-      if (cliPath) {
+      if (cliPath && resolve(dirname(cliPath)) !== shimBinDir) {
         return resolve(dirname(cliPath), '..');
       }
     }

package/bin/lib/gateway.js

@@ -13,8 +13,12 @@ import { stripBom } from './jsonc.js';
  * Dynamically resolve the current mindos CLI path.
  * This is needed because CLI_PATH is evaluated at module load time,
  * but after `npm install -g @geminilight/mindos@latest`, the path may have changed.
+ *
+ * Skips ~/.mindos/bin/ — that directory contains our own shell shim
+ * (not a JS file), which must not be passed to `node` as ExecStart.
  */
 function getCurrentCliPath() {
+  const shimBinDir = resolve(MINDOS_DIR, 'bin');
   try {
     const whichCmd = process.platform === 'win32' ? 'where mindos' : 'which mindos';
     // `where` on Windows can return multiple lines; take the first match
@@ -22,9 +26,9 @@ function getCurrentCliPath() {
     if (mindosBin) {
       try {
         const realPath = realpathSync(mindosBin);
-        if (existsSync(realPath)) return realPath;
+        if (existsSync(realPath) && resolve(dirname(realPath)) !== shimBinDir) return realPath;
       } catch {}
-      if (existsSync(mindosBin)) return mindosBin;
+      if (existsSync(mindosBin) && resolve(dirname(mindosBin)) !== shimBinDir) return mindosBin;
     }
   } catch {}
   return CLI_PATH;

package/bin/lib/mcp-agents.js

@@ -217,6 +217,15 @@ export const MCP_AGENTS = {
     presenceCli: 'codex',
     presenceDirs: ['~/.codex/'],
   },
+  'antigravity': {
+    name: 'Antigravity',
+    project: '.antigravity/mcp_config.json',
+    global: '~/.gemini/antigravity/mcp_config.json',
+    key: 'mcpServers',
+    preferredTransport: 'stdio',
+    presenceCli: 'agy',
+    presenceDirs: ['~/.gemini/antigravity/'],
+  },
 };
 
 /**
@@ -243,6 +252,7 @@ export const SKILL_AGENT_REGISTRY = {
   'roo': { mode: 'additional', skillAgentName: 'roo' },
   'github-copilot': { mode: 'universal' },
   'codex': { mode: 'universal' },
+  'antigravity': { mode: 'additional', skillAgentName: 'antigravity' },
 };
 
 export function detectAgentPresence(agentKey) {

package/mcp/dist/index.cjs

@@ -123,7 +123,7 @@ ${l}`).join(`
 `);return de(Av(c))}catch(o){return xe(String(o))}}),t.registerTool("mindos_get_history",{title:"Get File Git History",description:"Get git commit history for a file.",inputSchema:E.object({path:E.string().min(1),limit:E.number().int().min(1).max(50).default(10)}),annotations:{readOnlyHint:!0}},async({path:i,limit:o})=>{try{let c=(await r("/api/git",{op:"history",path:i,limit:String(o)})).entries;if(c.length===0)return de(`No git history found for "${i}"`);let u=[`# Git History: ${i}`,"",`${c.length} commit(s):`,""];for(let l of c)u.push(`- **${l.date}** \`${l.hash.slice(0,8)}\` \u2014 ${l.message} (${l.author})`);return de(u.join(`
 `))}catch(s){return xe(String(s))}}),t.registerTool("mindos_get_file_at_version",{title:"Read File at Git Version",description:"Read file content at a specific git commit.",inputSchema:E.object({path:E.string().min(1),commit:E.string().min(4)}),annotations:{readOnlyHint:!0}},async({path:i,commit:o})=>{try{let c=(await r("/api/git",{op:"show",path:i,commit:o})).content;return de(Av(`# ${i} @ ${o.slice(0,8)}
 
-${c}`))}catch(s){return xe(String(s))}})}function _E(){let t=new yc({name:"mindos-mcp-server",version:"1.0.0"});return fL(t),t}async function mL(){if(uL==="http"){let t=new Map,e=xE({host:Ru});e.get("/api/health",(n,a)=>{a.json({ok:!0,service:"mindos"})}),Cu&&e.use(jv,(n,a,i)=>{if(n.headers.authorization?.replace("Bearer ","")!==Cu){a.status(401).json({error:"Unauthorized"});return}i()}),e.all(jv,async(n,a)=>{let i=n.headers["mcp-session-id"];if(i&&t.has(i)){await t.get(i).transport.handleRequest(n,a,n.body);return}if(i&&!t.has(i)){a.status(404).json({jsonrpc:"2.0",error:{code:-32e3,message:"Session not found"}});return}let o=new Ec({sessionIdGenerator:()=>(0,wE.randomUUID)()}),s=_E();o.onclose=()=>{let u=o.sessionId;u&&t.delete(u),console.error(`[MCP] Session ${u?.slice(0,8)} closed (${t.size} active)`)},await s.connect(o),await o.handleRequest(n,a,n.body);let c=o.sessionId;if(c){t.set(c,{transport:o,server:s});let u=s.server.getClientVersion(),l=u?.name?` (${u.name})`:"";console.error(`[MCP] New session ${c.slice(0,8)}${l} (${t.size} active)`)}});let r=(0,kE.createServer)(e);r.listen(bE,Ru,()=>{console.error(`MindOS MCP server (HTTP) listening on http://${Ru==="0.0.0.0"?"127.0.0.1":Ru}:${bE}${jv}`),console.error(`API backend: ${Co}`)}),process.stdin.isTTY||(process.stdin.resume(),process.stdin.on("end",()=>{console.error("[MindOS MCP] Parent process exited (stdin closed), shutting down"),r.close(),setTimeout(()=>process.exit(0),1e3)}),process.stdin.on("error",()=>{}))}else{let t=_E(),e=new bc;await t.connect(e),console.error(`MindOS MCP server started (stdio, API: ${Co})`)}}mL().catch(t=>{console.error("Fatal:",t),process.exit(1)});
+${c}`))}catch(s){return xe(String(s))}})}function _E(){let t=new yc({name:"mindos-mcp-server",version:"1.0.0"});return fL(t),t}async function mL(){if(uL==="http"){let t=new Map,e=xE({host:Ru});e.get("/api/health",(a,i)=>{i.json({ok:!0,service:"mindos"})}),Cu&&e.use(jv,(a,i,o)=>{if(a.headers.authorization?.replace("Bearer ","")!==Cu){i.status(401).json({error:"Unauthorized"});return}o()}),e.all(jv,async(a,i)=>{let o=a.headers["mcp-session-id"];if(o&&t.has(o)){await t.get(o).transport.handleRequest(a,i,a.body);return}if(o&&!t.has(o)){i.status(404).json({jsonrpc:"2.0",error:{code:-32e3,message:"Session not found"}});return}let s=new Ec({sessionIdGenerator:()=>(0,wE.randomUUID)()}),c=_E();s.onclose=()=>{let l=s.sessionId;l&&t.delete(l),console.error(`[MCP] Session ${l?.slice(0,8)} closed (${t.size} active)`)},await c.connect(s),await s.handleRequest(a,i,a.body);let u=s.sessionId;if(u){t.set(u,{transport:s,server:c});let l=c.server.getClientVersion(),p=l?.name?` (${l.name})`:"";console.error(`[MCP] New session ${u.slice(0,8)}${p} (${t.size} active)`)}});let r=(0,kE.createServer)(e);r.listen(bE,Ru,()=>{console.error(`MindOS MCP server (HTTP) listening on http://${Ru==="0.0.0.0"?"127.0.0.1":Ru}:${bE}${jv}`),console.error(`API backend: ${Co}`)});let n=process.env.LAUNCHED_BY_LAUNCHD==="1"||!!process.env.INVOCATION_ID;!process.stdin.isTTY&&!n&&(process.stdin.resume(),process.stdin.on("end",()=>{console.error("[MindOS MCP] Parent process exited (stdin closed), shutting down"),r.close(),setTimeout(()=>process.exit(0),1e3)}),process.stdin.on("error",()=>{}))}else{let t=_E(),e=new bc;await t.connect(e),console.error(`MindOS MCP server started (stdio, API: ${Co})`)}}mL().catch(t=>{console.error("Fatal:",t),process.exit(1)});
 /*! Bundled license information:
 
 depd/index.js:

package/mcp/src/index.ts

@@ -675,7 +675,12 @@ async function main() {
       console.error(`API backend: ${BASE_URL}`);
     });
 
-    if (!process.stdin.isTTY) {
+    // Detect parent-exit via stdin EOF — but only when stdin is a real pipe
+    // from a parent process (e.g. Desktop/Electron).  Under launchd/systemd,
+    // stdin is /dev/null which emits EOF immediately and would kill the server.
+    const launchedByDaemon =
+      process.env.LAUNCHED_BY_LAUNCHD === '1' || !!process.env.INVOCATION_ID;
+    if (!process.stdin.isTTY && !launchedByDaemon) {
       process.stdin.resume();
       process.stdin.on('end', () => {
         console.error('[MindOS MCP] Parent process exited (stdin closed), shutting down');

package/package.json

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

package/skills/mindos/SKILL.md

@@ -4,12 +4,18 @@ description: >
   Operate a MindOS knowledge base: update notes, search, organize files, execute SOPs/workflows,
   retrospective, append CSV, cross-agent handoff, route unstructured input to the right files,
   distill experience, sync related docs.
-  Use when the task targets files inside the user's MindOS KB (mindRoot).
+  更新笔记, 搜索知识库, 整理文件, 执行SOP/工作流, 复盘, 追加CSV, 跨Agent交接,
+  路由非结构化输入到对应文件, 提炼经验, 同步关联文档.
   NOT for editing app source, project docs, or paths outside the KB.
   Core concepts: Space, Instruction (INSTRUCTION.md), Skill (SKILL.md); notes can embody both.
-  Trigger when user asks to: save or record a note, search their knowledge base, update or edit
-  a file, organize notes, run a workflow or SOP, capture decisions from a session, append rows
-  to a table or CSV, hand off context to another agent.
+  Trigger when user asks to: save or record anything, search for prior notes or context, update or
+  edit a file, organize notes, run a workflow or SOP, capture decisions from a session, append rows
+  to a table or CSV, hand off context to another agent, check if something was discussed before,
+  look up a past decision, distill lessons learned, prepare context for a meeting.
+  Also trigger on Chinese: 帮我记下来, 搜一下笔记, 更新知识库, 整理文件, 复盘, 提炼经验,
+  保存, 记录, 交接, 查一下之前的, 有没有相关笔记, 把这个存起来.
+  When the user's question implies stored context may exist (past decisions, previous discussions,
+  meeting records), consider searching MindOS even if they don't explicitly mention it.
 ---
 
 # MindOS Skill

package/skills/mindos-max/SKILL.md

@@ -0,0 +1,191 @@
+---
+name: mindos-max
+description: >
+  The user's second brain — a persistent, shared knowledge base that ALL agents read from and write to.
+  MindOS is the global memory layer: decisions, meeting notes, SOPs, debugging lessons, architecture
+  choices, research findings, preferences, and conversation summaries all live here.
+
+  PROACTIVE USE — do not wait for the user to say "save to knowledge base":
+  (1) Before answering any question about past decisions, discussions, or context → search MindOS first.
+  (2) After any valuable output (decision made, bug fixed, lesson learned, meeting summarized) → offer to save it.
+  (3) When handing off to another agent or ending a session → persist key context to MindOS.
+
+  Trigger on ALL of these, even without explicit "MindOS" mention: save/record anything,
+  search prior notes, update files, organize/restructure, run SOPs or workflows, retrospective,
+  append CSV/table data, cross-agent handoff, distill experience, sync related docs, check if
+  something was discussed before, look up a past decision, find a template, prepare meeting context,
+  daily logging, track goals. Also trigger on Chinese equivalents: 帮我记下来, 搜一下笔记,
+  更新知识库, 整理文件, 复盘, 提炼经验, 保存, 记录, 交接.
+
+  When in doubt whether MindOS applies — it probably does. Check anyway.
+  NOT for editing app source code or project repos outside the KB.
+  Core concepts: Space, Instruction (INSTRUCTION.md), Skill (SKILL.md).
+---
+
+# MindOS Skill
+
+<!-- version: 3.1.0-max — aggressive global memory mode -->
+
+> **You are the user's memory.** Every agent shares MindOS. If something is worth remembering, save it.
+> If you need context, check MindOS first. Be proactive — don't wait to be asked.
+
+## Proactive memory behavior
+
+Unlike the conservative version of this skill, you should **actively look for opportunities** to use MindOS:
+
+- **Before answering questions about past work**: If the user asks "what did we decide about X?" or "how did we handle Y?", search MindOS before guessing. Even if they don't mention MindOS, their question implies stored context exists.
+- **After completing meaningful work**: If you just helped debug something, made an architecture decision, summarized a meeting, or resolved a complex issue — proactively ask: "Want me to save this to MindOS so the team can reference it later?"
+- **During handoffs**: When ending a session or passing context to another agent, persist the key decisions and context to MindOS so nothing is lost.
+- **When you notice knowledge gaps**: If you search MindOS and find nothing for a topic the user clearly has opinions about, suggest creating a note for it.
+
+The goal: the user should never have to remember to use MindOS. You remember for them.
+
+---
+
+## CLI commands
+
+Use `mindos file <subcommand>` for all knowledge base operations. Add `--json` for structured output.
+
+| Operation | Command |
+|-----------|---------|
+| List files | `mindos file list` |
+| Read file | `mindos file read <path>` |
+| Write/overwrite | `mindos file write <path> --content "..."` |
+| Create new file | `mindos file create <path> --content "..."` |
+| Append to file | `mindos file append <path> --content "..."` |
+| Edit section | `mindos file edit-section <path> -H "## Heading" --content "..."` |
+| Insert after heading | `mindos file insert-heading <path> -H "## Heading" --content "..."` |
+| Append CSV row | `mindos file append-csv <path> --row "col1,col2,col3"` |
+| Delete file | `mindos file delete <path>` |
+| Rename/move | `mindos file rename <old> <new>` |
+| Search | `mindos search "query"` |
+| Backlinks | `mindos file backlinks <path>` |
+| Recent files | `mindos file recent --limit 10` |
+| Git history | `mindos file history <path>` |
+| List spaces | `mindos space list` |
+| Create space | `mindos space create "name"` |
+
+> **MCP users:** If you only have MCP tools (`mindos_*`), use them directly — they are self-describing via their schemas. Prefer CLI when available (lower token cost).
+
+### CLI setup
+
+```bash
+npm install -g @geminilight/mindos
+# Remote mode: mindos config set url http://<IP>:<PORT> && mindos config set authToken <token>
+```
+
+---
+
+## Rules
+
+1. **Bootstrap first** — list the KB tree to understand structure before searching or writing.
+2. **Default to read-only.** Only write when the user explicitly asks to save, record, organize, or edit. Lookup / summarize / quote = no writes.
+3. **Rule precedence** (highest wins): user's current-turn instruction > `.mindos/user-preferences.md` > nearest directory `INSTRUCTION.md` > root `INSTRUCTION.md` > this SKILL's defaults.
+4. **Multi-file edits require a plan first.** Present the full change list; execute only after approval.
+5. After create/delete/move/rename > **sync affected READMEs** automatically.
+6. **Read before write.** Always read a file before overwriting it. Never write based on assumptions.
+
+---
+
+## NEVER do (hard-won pitfalls)
+
+- **NEVER write to the KB root** unless explicitly told. Root is for governance files only. New content goes under the most fitting subdirectory.
+- **NEVER assume directory names.** Infer from the actual bootstrap tree — the KB may use Chinese names or flat layout.
+- **NEVER use full-file overwrite for a small edit.** Use `mindos file edit-section` or `mindos file insert-heading` for targeted changes. Full rewrites destroy git diffs.
+- **NEVER search with a single keyword.** Fire 2-4 parallel searches (synonyms, abbreviations, Chinese/English variants).
+- **NEVER modify `INSTRUCTION.md` or `README.md` without confirmation.** Governance docs — treat as high-sensitivity.
+- **NEVER create a file without checking siblings.** Read 1-2 files in the target directory to learn local style.
+- **NEVER leave orphan references.** After rename/move, check backlinks and update every referring file.
+- **NEVER skip routing confirmation for multi-file writes.** The user's mental model may differ from yours.
+
+---
+
+## MindOS concepts
+
+- **Space** — Knowledge partitions organized the way you think. Agents follow the same structure.
+- **Instruction** — A rules file (`INSTRUCTION.md`) all connected agents obey.
+- **Skill** — Teaches agents how to read, write, and organize the KB.
+
+Notes can embody both Instruction and Skill — they're just Markdown files in the tree.
+
+---
+
+## Decision tree
+
+```
+User request
+  |
+  |- Lookup / summarize / quote?
+  |   -> [Read-only]: search -> read -> answer with citations. No writes.
+  |
+  |- Save / record / update / organize specific content?
+  |   |- Single file -> [Single-file edit]
+  |   -> Multiple files or unclear -> [Multi-file routing] -- plan first
+  |
+  |- Structural change (rename / move / delete / reorganize)?
+  |   -> [Structural path] -- check backlinks before and after
+  |
+  |- Procedural / repeatable task?
+  |   -> [SOP path] -- find and follow existing SOP, or create one
+  |
+  |- Retrospective / distill / handoff?
+  |   -> [Retrospective path]
+  |
+  -> Ambiguous?
+      -> ASK. Propose 2-3 specific options based on KB state.
+```
+
+---
+
+## Judgment heuristics
+
+**Save intent boundary:**
+- "save this" / "record" / "write down" = write
+- "search" / "summarize" / "look up" = read-only
+- "organize" -> ask: display only, or write back?
+
+**File location uncertainty:**
+- Can't decide in 5 seconds -> use nearest existing directory, inform user
+- "Just put it somewhere" -> inbox, propose classification after
+
+**Scope creep:**
+- Input routes to >5 files -> pause, confirm scope
+- "Update all of these" spanning multiple topics -> split into batches
+
+**Citation:** KB-cited facts must include the file path.
+
+---
+
+## Post-task hooks
+
+After write tasks (not simple reads), scan this table. At most 1 proposal; highest priority wins. Check `.mindos/user-preferences.md` suppression first.
+
+| Hook | Priority | Condition |
+|------|----------|-----------|
+| Experience capture | high | Debugging, troubleshooting, or multi-round work |
+| Consistency sync | high | Edited file with backlinks |
+| SOP drift | medium | Followed SOP but diverged |
+| Linked update | medium | Changed CSV/TODO status with related docs |
+| Structure classification | medium | Created file in inbox/temp location |
+| Pattern extraction | low | 3+ similar operations this session |
+
+If a hook triggers -> read [references/post-task-hooks.md](../mindos/references/post-task-hooks.md).
+
+## Preference capture
+
+When user expresses a standing preference -> read [references/preference-capture.md](../mindos/references/preference-capture.md) and follow confirm-then-write flow.
+
+## SOP authoring
+
+When creating/rewriting an SOP -> read [references/sop-template.md](../mindos/references/sop-template.md).
+
+---
+
+## Error handling (CLI)
+
+```bash
+"command not found: mindos"  -> npm install -g @geminilight/mindos
+"Mind root not configured"   -> mindos onboard
+"401 Unauthorized"           -> Check AUTH_TOKEN: mindos token (on server)
+"ECONNREFUSED"               -> Start server: mindos start
+```

package/skills/mindos-max-workspace/evals/evals.json

@@ -0,0 +1,23 @@
+{
+  "skill_name": "mindos-max",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "我昨天跟产品经理开会讨论了一个新的用户反馈系统的方案，他们建议用NPS打分加上开放式评论，我觉得挺好的。帮我把这个决策记下来，以后其他同事问起来可以查到。",
+      "expected_output": "Agent should recognize this as a 'save decision from meeting' task, use MindOS to store the meeting note with proper structure (date, attendees implied, decision, rationale), and place it in an appropriate directory in the KB.",
+      "files": []
+    },
+    {
+      "id": 2,
+      "prompt": "上周我记得我们讨论过API限流的方案，具体是怎么定的来着？好像是每分钟100次还是200次？我找不到了。",
+      "expected_output": "Agent should recognize this as a 'search for past decision' task, use MindOS search to find the API rate limiting discussion, and return the relevant content with file path citation.",
+      "files": []
+    },
+    {
+      "id": 3,
+      "prompt": "I just finished debugging a really tricky race condition in our payment service - turns out the mutex wasn't being released properly in the error path. Took me 3 hours to figure out. I want to make sure the team doesn't hit this again.",
+      "expected_output": "Agent should recognize this as 'capture debugging experience/lessons learned', use MindOS to save a structured troubleshooting note with problem description, root cause, solution, and prevention tips.",
+      "files": []
+    }
+  ]
+}

package/skills/mindos-max-workspace/iteration-1/capture-debugging-experience-en/eval_metadata.json

@@ -0,0 +1,11 @@
+{
+  "eval_id": 3,
+  "eval_name": "capture-debugging-experience-en",
+  "prompt": "I just finished debugging a really tricky race condition in our payment service - turns out the mutex wasn't being released properly in the error path. Took me 3 hours to figure out. I want to make sure the team doesn't hit this again.",
+  "assertions": [
+    {"text": "Uses mindos CLI to save debugging experience note", "type": "behavioral"},
+    {"text": "Structured note includes: problem description, root cause, solution, prevention tips", "type": "content"},
+    {"text": "Bootstraps KB tree before writing", "type": "behavioral"},
+    {"text": "Recognizes this as experience capture / lessons learned scenario", "type": "behavioral"}
+  ]
+}

package/skills/mindos-max-workspace/iteration-1/capture-debugging-experience-en/old_skill/grading.json

@@ -0,0 +1,28 @@
+{
+  "eval_id": 3,
+  "eval_name": "capture-debugging-experience-en",
+  "run_type": "old_skill",
+  "skill": "mindos-original",
+  "expectations": [
+    {
+      "text": "Uses mindos CLI to save debugging experience note",
+      "passed": true,
+      "evidence": "Uses `mindos file insert-heading \"engineering/debugging-experiences.md\"` in Step 5 — chose to append to existing file rather than create new."
+    },
+    {
+      "text": "Structured note includes: problem description, root cause, solution, prevention tips",
+      "passed": true,
+      "evidence": "Content has Problem, Root Cause, Solution, Rule (with code review checklist), Debugging Approach, Tags sections."
+    },
+    {
+      "text": "Bootstraps KB tree before writing",
+      "passed": true,
+      "evidence": "Step 1 runs `mindos file list`."
+    },
+    {
+      "text": "Recognizes this as experience capture / lessons learned scenario",
+      "passed": true,
+      "evidence": "Decision tree analysis identifies 'save / record' path and Experience capture hook (high priority)."
+    }
+  ]
+}