exomind 0.4.2 → 0.5.0

package/README.md

@@ -56,13 +56,18 @@ exomind feedback "entities/Redis.md" positive
 
 > 把 API Key 当密码对待:不提交进仓库、不贴进聊天。脚本化登录用 `exomind login --api-key ...`(注意别让 key 进 shell 历史或进程列表);交互式 `exomind login` 的 prompt 读取不走 shell 历史。
 
-## 接入 Claude Code(一条命令,默认全装)
+## 接入 Claude Code / Codex(一条命令,默认全装)
 
 ```bash
-exomind install          # 装 skill + hook + MCP,全部自动(幂等+备份)
-# 不想要某项: exomind install --no-hook  或  --no-mcp
+exomind install          # 装 skill(Claude+Codex)+ hook(Claude)+ MCP(各宿主),全部自动(幂等+备份)
+# 只装某个宿主: exomind install --host codex   (claude | codex | opencode)
+# 跳过某项: --no-skill / --no-hook / --no-mcp
 ```
 
+**Codex**(skill + MCP,无 hook):装到 `$CODEX_HOME/skills/exomind/`(缺省 `~/.codex/`),MCP 写入 `$CODEX_HOME/config.toml`。**Codex 没有 Claude 的 UserPromptSubmit hook**,靠 skill 的触发词(jdit/存档/查询)驱动;MCP `ingest` 只收文本,目录导入走 `exomind ingest --dir`。装完**重启 Codex**,skill 列表应出现 `exomind`。
+
+排查各宿主装没装上:`exomind doctor`(或 `exomind --json doctor`)。
+
 一行完成三层,免手改任何 JSON:
 - **① MCP 工具**(能力):写 `~/.claude.json` 的 `mcpServers.exomind` → Agent 拿到 `mcp__exomind__*` 确定性工具。
 - **② skill**(指导):拷到 `~/.claude/skills/exomind/`。
@@ -77,13 +82,14 @@ exomind install          # 装 skill + hook + MCP,全部自动(幂等+备份)
 
 **升级**:`npm i -g exomind@latest && exomind install`(幂等,刷新 skill/hook/mcp;`~/.exomind/` 的 config 与 manifest 保留)。注意:`npm i -g` 只换二进制(CLI+MCP 自动用新),**skill 是拷贝的,需 `exomind install` 才刷新**。
 
-## 关于 MCP 工具层(Claude Code + OpenCode 都已默认装)
+## 关于 MCP 工具层(Claude Code / OpenCode / Codex 都已默认装)
 
-`exomind install` 一次写**两个宿主**的 MCP 配置(都幂等+备份,互不干扰,各读各的):
+`exomind install` 一次写**三个宿主**的 MCP 配置(都幂等+备份,互不干扰,各读各的):
 - **Claude Code**:`~/.claude.json` → `mcpServers.exomind`
 - **OpenCode**:`~/.config/opencode/opencode.json` → `mcp.exomind`
+- **Codex**:`$CODEX_HOME/config.toml` → `[mcp_servers.exomind]`
 
-只关 MCP:`exomind install --no-mcp`(两个宿主都不写)。手写/其它宿主(如 Cursor)参考 [docs/mcp.md](./docs/mcp.md)。
+只关 MCP:`exomind install --no-mcp`(三个宿主都不写)。手写/其它宿主(如 Cursor)参考 [docs/mcp.md](./docs/mcp.md)。
 
 `exomind mcp` 是本地 stdio MCP server,把 ingest/query/search/entity/relations/stats 暴露为 typed tool;复用同一份凭证,三平台都能跑(本地 stdio,不涉及远程 SSE 的 Windows 坑)。
 
@@ -100,7 +106,9 @@ exomind install          # 装 skill + hook + MCP,全部自动(幂等+备份)
 | `review` / `review mark` | FSRS-5 复习队列与评分 |
 | `synthesize` / `topics` / `gaps` / `daily` | 主题综合、选题、缺口、每日摘要 |
 | `feedback` | 质量反馈(影响搜索排名) |
-| `hook` / `install` | UserPromptSubmit 钩子、安装 skill+hook |
+| `install` | 装 skill(Claude+Codex)+ hook(Claude)+ MCP;`--host`/`--no-skill`/`--no-hook`/`--no-mcp` |
+| `doctor` | 诊断各宿主 skill/hook/MCP/鉴权 状态(`--json`) |
+| `hook` | UserPromptSubmit 钩子(由 install 配置) |
 
 完整命令参考与排错见 **[CLI 命令指南](./docs/cli-guide.md)**。
 
@@ -143,7 +151,8 @@ src/
   io.ts         stdin / 文件读取
   hook.ts       UserPromptSubmit 钩子(替代 bash hook)
   commands/     每个命令一个文件
-skill/SKILL.md  Claude Code skill 源(install 时拷贝)
+skill/claude/SKILL.md  Claude Code skill 源(install 时拷贝)
+skill/codex/SKILL.md   Codex skill 源(install 时拷到 $CODEX_HOME/skills/exomind/)
 test/           node:test 单元 + 协议级 e2e
 ```
 

package/dist/cli.js

@@ -965,8 +965,8 @@ var require_command = __commonJS({
     "use strict";
     var EventEmitter = require("events").EventEmitter;
     var childProcess = require("child_process");
-    var path7 = require("path");
-    var fs7 = require("fs");
+    var path8 = require("path");
+    var fs8 = require("fs");
     var process2 = require("process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
@@ -1898,11 +1898,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let launchWithNode = false;
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
-          const localBin = path7.resolve(baseDir, baseName);
-          if (fs7.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path7.extname(baseName))) return void 0;
+          const localBin = path8.resolve(baseDir, baseName);
+          if (fs8.existsSync(localBin)) return localBin;
+          if (sourceExt.includes(path8.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
-            (ext) => fs7.existsSync(`${localBin}${ext}`)
+            (ext) => fs8.existsSync(`${localBin}${ext}`)
           );
           if (foundExt) return `${localBin}${foundExt}`;
           return void 0;
@@ -1914,21 +1914,21 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (this._scriptPath) {
           let resolvedScriptPath;
           try {
-            resolvedScriptPath = fs7.realpathSync(this._scriptPath);
+            resolvedScriptPath = fs8.realpathSync(this._scriptPath);
           } catch (err) {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path7.resolve(
-            path7.dirname(resolvedScriptPath),
+          executableDir = path8.resolve(
+            path8.dirname(resolvedScriptPath),
             executableDir
           );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path7.basename(
+            const legacyName = path8.basename(
               this._scriptPath,
-              path7.extname(this._scriptPath)
+              path8.extname(this._scriptPath)
             );
             if (legacyName !== this._name) {
               localFile = findFile(
@@ -1939,7 +1939,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path7.extname(executableFile));
+        launchWithNode = sourceExt.includes(path8.extname(executableFile));
         let proc;
         if (process2.platform !== "win32") {
           if (launchWithNode) {
@@ -2779,7 +2779,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Command}
        */
       nameFromFilename(filename) {
-        this._name = path7.basename(filename, path7.extname(filename));
+        this._name = path8.basename(filename, path8.extname(filename));
         return this;
       }
       /**
@@ -2793,9 +2793,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {(string|null|Command)}
        */
-      executableDir(path8) {
-        if (path8 === void 0) return this._executableDir;
-        this._executableDir = path8;
+      executableDir(path9) {
+        if (path9 === void 0) return this._executableDir;
+        this._executableDir = path9;
         return this;
       }
       /**
@@ -3119,7 +3119,7 @@ var {
 // package.json
 var package_default = {
   name: "exomind",
-  version: "0.4.2",
+  version: "0.5.0",
   description: "ExoMind \u8DE8\u5E73\u53F0\u547D\u4EE4\u884C\u5BA2\u6237\u7AEF \u2014 \u901A\u8FC7 REST \u4E0E ExoMind \u77E5\u8BC6\u5E93\u4EA4\u4E92(ingest/query/search/review),\u66FF\u4EE3 Windows \u4E0D\u53EF\u7528\u7684 MCP \u5BA2\u6237\u7AEF\u3002",
   bin: {
     exomind: "dist/cli.js"
@@ -4502,7 +4502,8 @@ var path6 = __toESM(require("path"));
 var os2 = __toESM(require("os"));
 var import_node_child_process = require("child_process");
 var PKG_ROOT = path6.resolve(__dirname, "..");
-var SKILL_SRC = path6.join(PKG_ROOT, "skill", "SKILL.md");
+var CLAUDE_SKILL_SRC = path6.join(PKG_ROOT, "skill", "claude", "SKILL.md");
+var CODEX_SKILL_SRC = path6.join(PKG_ROOT, "skill", "codex", "SKILL.md");
 function readJson2(file) {
   try {
     return JSON.parse(fs6.readFileSync(file, "utf-8"));
@@ -4535,19 +4536,23 @@ function pruneBackups(file, keep) {
   } catch {
   }
 }
-function purgeMcpExomind(file) {
-  const d = readJson2(file);
-  if (!d) return false;
-  const grp = d.mcpServers;
-  if (!grp || !grp.exomind) return false;
-  delete grp.exomind;
-  if (Object.keys(grp).length === 0) delete d.mcpServers;
-  backup(file);
-  fs6.writeFileSync(file, JSON.stringify(d, null, 2) + "\n");
-  return true;
+function resolveCodexHome(env = process.env, homeDir = os2.homedir()) {
+  const configured = (env.CODEX_HOME ?? "").trim();
+  return configured ? path6.resolve(configured) : path6.join(homeDir, ".codex");
 }
-function configureCodexMcp() {
-  const codexConfig = path6.join(os2.homedir(), ".codex", "config.toml");
+function looksLikeValidToml(text) {
+  if (!text.trim()) return true;
+  if (/\x00/.test(text)) return false;
+  let brackets = 0;
+  for (const ch of text) {
+    if (ch === "[") brackets++;
+    else if (ch === "]") brackets--;
+    if (brackets < 0) return false;
+  }
+  return brackets === 0;
+}
+function configureCodexMcp(codexHome) {
+  const codexConfig = path6.join(codexHome, "config.toml");
   try {
     fs6.mkdirSync(path6.dirname(codexConfig), { recursive: true });
   } catch {
@@ -4558,8 +4563,16 @@ function configureCodexMcp() {
   } catch {
     existing = "";
   }
+  if (existing && !looksLikeValidToml(existing)) {
+    return {
+      ok: false,
+      written: false,
+      file: codexConfig,
+      reason: `config.toml \u7591\u4F3C\u635F\u574F(\u62EC\u53F7\u4E0D\u914D\u5E73/\u542B\u4E8C\u8FDB\u5236),\u5DF2\u4FDD\u7559\u539F\u6587\u4EF6\u672A\u6539: ${codexConfig}`
+    };
+  }
   if (/^\[mcp_servers\.exomind\]\s*$/m.test(existing)) {
-    return false;
+    return { ok: true, written: false, file: codexConfig };
   }
   backup(codexConfig);
   const prefix = existing && !existing.endsWith("\n") ? "\n\n" : existing ? "\n" : "";
@@ -4568,6 +4581,34 @@ command = "exomind"
 args = ["mcp"]
 `;
   fs6.writeFileSync(codexConfig, existing + snippet);
+  const after = fs6.readFileSync(codexConfig, "utf-8");
+  if (!/^\[mcp_servers\.exomind\]\s*$/m.test(after) || !looksLikeValidToml(after)) {
+    return { ok: false, written: true, file: codexConfig, reason: "\u5199\u540E\u590D\u9A8C\u5931\u8D25(\u6BB5\u672A\u5199\u5165\u6216\u6587\u4EF6\u635F\u574F)" };
+  }
+  return { ok: true, written: true, file: codexConfig };
+}
+function installCodexSkill(codexHome, skillSrc = CODEX_SKILL_SRC) {
+  const destDir = path6.join(codexHome, "skills", "exomind");
+  const dest = path6.join(destDir, "SKILL.md");
+  if (!fs6.existsSync(skillSrc)) {
+    return { ok: false, dest, reason: `skill \u6E90\u4E0D\u5B58\u5728: ${skillSrc}` };
+  }
+  fs6.mkdirSync(destDir, { recursive: true });
+  backup(dest);
+  const tmp = `${dest}.tmp-${Date.now()}`;
+  fs6.writeFileSync(tmp, fs6.readFileSync(skillSrc));
+  fs6.renameSync(tmp, dest);
+  return { ok: true, dest };
+}
+function purgeMcpExomind(file) {
+  const d = readJson2(file);
+  if (!d) return false;
+  const grp = d.mcpServers;
+  if (!grp || !grp.exomind) return false;
+  delete grp.exomind;
+  if (Object.keys(grp).length === 0) delete d.mcpServers;
+  backup(file);
+  fs6.writeFileSync(file, JSON.stringify(d, null, 2) + "\n");
   return true;
 }
 function checkMcp(timeoutMs = 6e3) {
@@ -4615,16 +4656,34 @@ function checkMcp(timeoutMs = 6e3) {
   });
 }
 async function install(client, opts) {
+  if (opts.host && !["claude", "codex", "opencode"].includes(opts.host)) {
+    throw new Error(`\u672A\u77E5 --host: ${opts.host}(\u53EF\u9009: claude | codex | opencode)`);
+  }
   const claudeDir = path6.join(os2.homedir(), ".claude");
   const skillDestDir = path6.join(claudeDir, "skills", "exomind");
-  if (!fs6.existsSync(SKILL_SRC)) {
-    throw new Error(`skill \u6E90\u4E0D\u5B58\u5728: ${SKILL_SRC}(npm \u5305\u53EF\u80FD\u635F\u574F,\u6216\u5F00\u53D1\u6A21\u5F0F\u4E0B\u672A\u6784\u5EFA)`);
+  const codexHome = resolveCodexHome();
+  const want = (h) => !opts.host || opts.host === h;
+  if (opts.skill !== false) {
+    if (want("claude")) {
+      if (!fs6.existsSync(CLAUDE_SKILL_SRC)) {
+        throw new Error(`Claude skill \u6E90\u4E0D\u5B58\u5728: ${CLAUDE_SKILL_SRC}(npm \u5305\u53EF\u80FD\u635F\u574F,\u6216\u5F00\u53D1\u6A21\u5F0F\u4E0B\u672A\u6784\u5EFA)`);
+      }
+      fs6.mkdirSync(skillDestDir, { recursive: true });
+      fs6.copyFileSync(CLAUDE_SKILL_SRC, path6.join(skillDestDir, "SKILL.md"));
+      console.log(ok("\u5DF2\u5B89\u88C5 Claude Code skill"));
+      console.log(dim(`  \u2192 ${skillDestDir}/SKILL.md`));
+    }
+    if (want("codex")) {
+      const r = installCodexSkill(codexHome);
+      if (r.ok) {
+        console.log(ok("\u5DF2\u5B89\u88C5 Codex skill"));
+        console.log(dim(`  \u2192 ${r.dest}`));
+      } else {
+        console.log(yellow(`\u2717 Codex skill \u5B89\u88C5\u5931\u8D25: ${r.reason}`));
+      }
+    }
   }
-  fs6.mkdirSync(skillDestDir, { recursive: true });
-  fs6.copyFileSync(SKILL_SRC, path6.join(skillDestDir, "SKILL.md"));
-  console.log(ok("\u5DF2\u5B89\u88C5 Claude Code skill"));
-  console.log(dim(`  \u2192 ${skillDestDir}/SKILL.md`));
-  if (opts.hook !== false) {
+  if (opts.hook !== false && want("claude")) {
     const settingsFile = path6.join(claudeDir, "settings.json");
     fs6.mkdirSync(claudeDir, { recursive: true });
     backup(settingsFile);
@@ -4640,40 +4699,53 @@ async function install(client, opts) {
     hooks.UserPromptSubmit = kept;
     settings.hooks = hooks;
     fs6.writeFileSync(settingsFile, JSON.stringify(settings, null, 2) + "\n");
-    console.log(ok("\u5DF2\u914D\u7F6E UserPromptSubmit hook \u2192 exomind hook"));
-    console.log(dim("  \u91CD\u542F Claude Code \u751F\u6548\u3002hook \u51FA\u9519\u4E0D\u4F1A\u963B\u585E\u4F60\u7684\u8F93\u5165(\u9519\u8BEF\u53EA\u8FDB stderr)\u3002"));
+    console.log(ok("\u5DF2\u914D\u7F6E UserPromptSubmit hook \u2192 exomind hook (Claude Code \u72EC\u6709)"));
+    console.log(dim("  Codex \u5F53\u524D\u65E0\u5BF9\u5E94 prompt-submit hook,\u9760 skill \u89E6\u53D1(jdit/\u5B58\u6863/\u67E5\u8BE2)\u3002"));
   }
   if (opts.mcp !== false) {
-    const ccJson = path6.join(os2.homedir(), ".claude.json");
-    backup(ccJson);
-    const cc = readJson2(ccJson) ?? {};
-    const ccMcp = cc.mcpServers ?? {};
-    ccMcp.exomind = { command: "exomind", args: ["mcp"] };
-    cc.mcpServers = ccMcp;
-    fs6.writeFileSync(ccJson, JSON.stringify(cc, null, 2) + "\n");
-    const ocJson = path6.join(os2.homedir(), ".config", "opencode", "opencode.json");
-    fs6.mkdirSync(path6.dirname(ocJson), { recursive: true });
-    backup(ocJson);
-    const oc = readJson2(ocJson) ?? {};
-    const ocMcp = oc.mcp ?? {};
-    ocMcp.exomind = { type: "local", command: ["exomind", "mcp"] };
-    oc.mcp = ocMcp;
-    fs6.writeFileSync(ocJson, JSON.stringify(oc, null, 2) + "\n");
-    configureCodexMcp();
+    const configured = [];
+    if (want("claude")) {
+      const ccJson = path6.join(os2.homedir(), ".claude.json");
+      backup(ccJson);
+      const cc = readJson2(ccJson) ?? {};
+      const ccMcp = cc.mcpServers ?? {};
+      ccMcp.exomind = { command: "exomind", args: ["mcp"] };
+      cc.mcpServers = ccMcp;
+      fs6.writeFileSync(ccJson, JSON.stringify(cc, null, 2) + "\n");
+      configured.push("Claude Code (~/.claude.json)");
+    }
+    if (want("opencode")) {
+      const ocJson = path6.join(os2.homedir(), ".config", "opencode", "opencode.json");
+      fs6.mkdirSync(path6.dirname(ocJson), { recursive: true });
+      backup(ocJson);
+      const oc = readJson2(ocJson) ?? {};
+      const ocMcp = oc.mcp ?? {};
+      ocMcp.exomind = { type: "local", command: ["exomind", "mcp"] };
+      oc.mcp = ocMcp;
+      fs6.writeFileSync(ocJson, JSON.stringify(oc, null, 2) + "\n");
+      configured.push("OpenCode (~/.config/opencode/opencode.json)");
+    }
+    if (want("codex")) {
+      const r = configureCodexMcp(codexHome);
+      if (r.ok) configured.push(`Codex (${r.file})`);
+      else console.log(yellow(`\u2717 Codex MCP \u914D\u7F6E\u5931\u8D25: ${r.reason}`));
+    }
     const purged = [];
-    if (purgeMcpExomind(path6.join(claudeDir, "settings.json"))) purged.push("~/.claude/settings.json");
+    if (want("claude") && purgeMcpExomind(path6.join(claudeDir, "settings.json"))) {
+      purged.push("~/.claude/settings.json");
+    }
     let curDir = process.cwd();
     for (let i = 0; i < 12 && curDir !== path6.dirname(curDir); i++) {
       const f = path6.join(curDir, ".mcp.json");
       if (fs6.existsSync(f) && purgeMcpExomind(f)) purged.push(f.replace(os2.homedir(), "~"));
       curDir = path6.dirname(curDir);
     }
-    if (purged.length) console.log(dim(`  \u2192 \u6E05\u7406\u6B8B\u7559 exomind MCP \u6761\u76EE\uFF08\u907F\u514D\u8986\u76D6 stdio\uFF09: ${purged.join(", ")}`));
-    console.log(ok("\u5DF2\u914D\u7F6E MCP server \u2192 exomind mcp"));
-    console.log(dim("  \u2192 Claude Code: ~/.claude.json (mcpServers.exomind)"));
-    console.log(dim("  \u2192 OpenCode: ~/.config/opencode/opencode.json (mcp.exomind)"));
-    console.log(dim("  \u2192 Codex: ~/.codex/config.toml ([mcp_servers.exomind])"));
-    console.log(dim("  \u91CD\u542F\u5BF9\u5E94 Agent \u2192 \u62FF\u5230 mcp__exomind__* \u5DE5\u5177"));
+    if (purged.length) console.log(dim(`  \u2192 \u6E05\u7406\u6B8B\u7559 exomind MCP \u6761\u76EE(\u907F\u514D\u8986\u76D6 stdio): ${purged.join(", ")}`));
+    if (configured.length) {
+      console.log(ok("\u5DF2\u914D\u7F6E MCP server \u2192 exomind mcp"));
+      for (const c of configured) console.log(dim(`  \u2192 ${c}`));
+      console.log(dim("  \u91CD\u542F\u5BF9\u5E94 Agent \u2192 \u62FF\u5230 mcp__exomind__* \u5DE5\u5177"));
+    }
   }
   const cfgFile = path6.join(os2.homedir(), ".exomind", "config.json");
   const cfg = readJson2(cfgFile);
@@ -4682,7 +4754,7 @@ async function install(client, opts) {
     cfg.base_url = DEFAULT_BASE_URL;
     fs6.writeFileSync(cfgFile, JSON.stringify(cfg, null, 2) + "\n");
     console.log(ok(`\u5DF2\u8FC1\u79FB base_url: d.youhuale.cn \u2192 ${DEFAULT_BASE_URL}`));
-    console.log(dim("  (stdio MCP \u5B50\u8FDB\u7A0B\u8BFB\u6B64\u914D\u7F6E\uFF0C\u91CD\u542F Agent \u540E\u7528\u65B0\u57DF\u540D)"));
+    console.log(dim("  (stdio MCP \u5B50\u8FDB\u7A0B\u8BFB\u6B64\u914D\u7F6E,\u91CD\u542F Agent \u540E\u7528\u65B0\u57DF\u540D)"));
   }
   const live = loadConfig();
   const keyHint = live.api_key ? `${live.api_key.slice(0, 8)}\u2026${live.api_key.slice(-4)}` : "";
@@ -4699,25 +4771,139 @@ async function install(client, opts) {
     }
   }
   const mcp = live.api_key ? await checkMcp() : { ok: false, detail: "\u672A\u914D\u7F6E API Key" };
+  const codexSkillOk = fs6.existsSync(path6.join(codexHome, "skills", "exomind", "SKILL.md"));
+  const codexMcfgOk = (() => {
+    try {
+      return /^\[mcp_servers\.exomind\]\s*$/m.test(fs6.readFileSync(path6.join(codexHome, "config.toml"), "utf-8"));
+    } catch {
+      return false;
+    }
+  })();
   console.log(yellow("\n\u53EF\u7528\u6027\u81EA\u68C0:"));
   if (!live.api_key) {
-    console.log(dim("  \uFF08\u672A\u914D\u7F6E API Key\uFF0C\u8DF3\u8FC7\u81EA\u68C0\uFF1Bexomind login \u540E\u91CD\u8DD1 install \u53EF\u81EA\u68C0\uFF09"));
+    console.log(dim("  (\u672A\u914D\u7F6E API Key,\u8DF3\u8FC7\u670D\u52A1\u7AEF\u81EA\u68C0;exomind login \u540E\u91CD\u8DD1 install \u53EF\u81EA\u68C0)"));
   } else {
     console.log(
-      me && me.authenticated ? ok(`  \u670D\u52A1\u5668\u8FDE\u901A + \u9274\u6743\u6709\u6548\uFF08tenant ${me.tenant_id} \xB7 ${keyHint}\uFF09`) : yellow("  \u2717 \u670D\u52A1\u5668\u8FDE\u901A/\u9274\u6743\u5F02\u5E38 \u2192 exomind me \u6838\u9A8C")
+      me && me.authenticated ? ok(`  \u670D\u52A1\u5668\u8FDE\u901A + \u9274\u6743\u6709\u6548(tenant ${me.tenant_id} \xB7 ${keyHint})`) : yellow("  \u2717 \u670D\u52A1\u5668\u8FDE\u901A/\u9274\u6743\u5F02\u5E38 \u2192 exomind me \u6838\u9A8C")
     );
-    console.log(mcp.ok ? ok(`  MCP \u670D\u52A1\u7AEF\u53EF\u7528\uFF08${mcp.detail}\uFF09`) : yellow(`  \u2717 MCP \u670D\u52A1\u7AEF\u5F02\u5E38\uFF1A${mcp.detail}`));
+    console.log(mcp.ok ? ok(`  MCP \u670D\u52A1\u7AEF\u53EF\u7528(${mcp.detail})`) : yellow(`  \u2717 MCP \u670D\u52A1\u7AEF\u5F02\u5E38: ${mcp.detail}`));
+  }
+  if (want("codex")) {
+    console.log(codexSkillOk ? ok("  Codex skill \u5DF2\u5B89\u88C5") : yellow("  \u2717 Codex skill \u672A\u5B89\u88C5"));
+    console.log(codexMcfgOk ? ok("  Codex MCP \u914D\u7F6E\u5B58\u5728") : yellow("  \u2717 Codex MCP \u914D\u7F6E\u7F3A\u5931"));
+    console.log(dim("  \u25B3 Codex \u65E0 UserPromptSubmit hook,\u4F9D\u8D56 skill \u89E6\u53D1(jdit/\u5B58\u6863/\u67E5\u8BE2)"));
   }
   console.log(yellow("\n\u4E0B\u4E00\u6B65:"));
   if (!live.api_key) {
-    console.log(dim("  1. exomind login\uFF08\u7C98\u8D34 API Key\uFF09"));
-    console.log(dim("  2. \u91CD\u542F Claude Code\uFF08\u52A0\u8F7D skill/hook/MCP\uFF09\u2192 mcp__exomind__* \u751F\u6548"));
+    console.log(dim("  1. exomind login(\u7C98\u8D34 API Key)"));
+    console.log(dim("  2. \u91CD\u542F Agent(Claude Code / Codex)\u52A0\u8F7D skill/MCP \u2192 mcp__exomind__* \u751F\u6548"));
   } else if (me && me.authenticated && mcp.ok) {
-    console.log(dim("  \u81EA\u68C0\u5168\u8FC7 \u2192 \u91CD\u542F Claude Code\uFF08skill/hook/MCP \u542F\u52A8\u65F6\u8F7D\u5165\uFF09\u5373\u751F\u6548"));
+    console.log(dim("  \u81EA\u68C0\u5168\u8FC7 \u2192 \u91CD\u542F Agent(skill/MCP \u542F\u52A8\u65F6\u8F7D\u5165)\u5373\u751F\u6548"));
   } else {
-    console.log(yellow("\u81EA\u68C0\u6709\u5F02\u5E38\uFF0C\u8BF7\u6309\u4E0A\u65B9 \u2717 \u63D0\u793A\u6838\u9A8C\u540E\u518D\u91CD\u542F\u4F7F\u7528\u3002"));
+    console.log(yellow("  \u81EA\u68C0\u6709\u5F02\u5E38,\u6309\u4E0A\u65B9 \u2717 \u63D0\u793A\u6838\u9A8C\u540E\u518D\u91CD\u542F\u4F7F\u7528\u3002"));
+  }
+}
+
+// src/commands/doctor.ts
+var fs7 = __toESM(require("fs"));
+var path7 = __toESM(require("path"));
+var os3 = __toESM(require("os"));
+function readText(p) {
+  try {
+    return fs7.readFileSync(p, "utf-8");
+  } catch {
+    return "";
   }
 }
+function fileExists(p) {
+  try {
+    return fs7.existsSync(p);
+  } catch {
+    return false;
+  }
+}
+function mcpServersExomind(jsonFile, key) {
+  try {
+    const d = JSON.parse(readText(jsonFile));
+    const grp = key === "mcpServers" ? d.mcpServers : d.mcp;
+    return !!(grp && grp.exomind);
+  } catch {
+    return false;
+  }
+}
+function badge(s) {
+  if (s === "ok") return ok("ok");
+  if (s === "unsupported") return dim("\u2014 n/a");
+  if (s === "missing") return yellow("\u2717 \u7F3A\u5931");
+  return red(`\u2717 ${s}`);
+}
+async function doctor(client) {
+  const codexHome = resolveCodexHome();
+  const checks = [];
+  const claudeSkill = path7.join(os3.homedir(), ".claude", "skills", "exomind", "SKILL.md");
+  const claudeSettings = path7.join(os3.homedir(), ".claude", "settings.json");
+  const claudeJson = path7.join(os3.homedir(), ".claude.json");
+  checks.push({
+    host: "claude",
+    skill: fileExists(claudeSkill) ? "ok" : "missing",
+    hook: /exomind/.test(readText(claudeSettings)) ? "ok" : "missing",
+    mcpConfig: mcpServersExomind(claudeJson, "mcpServers") ? "ok" : "missing",
+    paths: [claudeSkill, claudeSettings, claudeJson]
+  });
+  const codexSkill = path7.join(codexHome, "skills", "exomind", "SKILL.md");
+  const codexConfig = path7.join(codexHome, "config.toml");
+  checks.push({
+    host: "codex",
+    skill: fileExists(codexSkill) ? "ok" : "missing",
+    hook: "unsupported",
+    mcpConfig: /^\[mcp_servers\.exomind\]\s*$/m.test(readText(codexConfig)) ? "ok" : "missing",
+    paths: [codexSkill, codexConfig],
+    detail: "Codex \u65E0 prompt-submit hook,\u9760 skill \u89E6\u53D1(jdit/\u5B58\u6863/\u67E5\u8BE2)"
+  });
+  const ocJson = path7.join(os3.homedir(), ".config", "opencode", "opencode.json");
+  checks.push({
+    host: "opencode",
+    skill: "unsupported",
+    hook: "unsupported",
+    mcpConfig: mcpServersExomind(ocJson, "mcp") ? "ok" : "missing",
+    paths: [ocJson]
+  });
+  let authed = false;
+  let authErr = "";
+  try {
+    const me = await client.get("/auth/me", { timeoutMs: 6e3 });
+    authed = !!me.authenticated;
+  } catch (e) {
+    authErr = e instanceof Error ? e.message : String(e);
+  }
+  const mcpInit = await checkMcp();
+  if (isJsonMode()) {
+    console.log(
+      JSON.stringify(
+        {
+          codexHome,
+          hosts: checks,
+          auth: { authenticated: authed, error: authErr || void 0 },
+          mcpInitialize: { ok: mcpInit.ok, detail: mcpInit.detail }
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+  console.log(yellow("ExoMind \u5B89\u88C5\u8BCA\u65AD:"));
+  console.log(dim(`  Codex home: ${codexHome}`));
+  for (const c of checks) {
+    console.log(`  ${c.host}:  skill ${badge(c.skill)}  hook ${badge(c.hook)}  mcp ${badge(c.mcpConfig)}`);
+    if (c.detail) console.log(dim(`    ${c.detail}`));
+  }
+  console.log(
+    `  auth:        ${authed ? ok("\u2713 \u5DF2\u767B\u5F55") : yellow("\u2717 \u672A\u767B\u5F55/\u5F02\u5E38")}${authErr ? dim(" " + authErr) : ""}`
+  );
+  console.log(`  mcp init:    ${mcpInit.ok ? ok("\u2713 " + mcpInit.detail) : yellow("\u2717 " + mcpInit.detail)}`);
+  console.log(dim("\n  \u7F3A\u9879\u7528 `exomind install [--host <claude|codex|opencode>]` \u8865\u9F50;\u6539\u5B8C\u91CD\u542F\u5BF9\u5E94 Agent\u3002"));
+}
 
 // src/cli.ts
 var VERSION = package_default.version;
@@ -4807,7 +4993,8 @@ program2.command("mcp").description("\u542F\u52A8 stdio MCP server(\u4F9B Claude
   const client = new ApiClient(cfg);
   await runMcpServer(client);
 });
-program2.command("install").description("\u5B89\u88C5 skill + hook + MCP(\u9ED8\u8BA4\u5168\u88C5;--no-hook / --no-mcp \u5173\u95ED\u67D0\u9879)").option("--no-hook", "\u4E0D\u5199 UserPromptSubmit hook").option("--no-mcp", "\u4E0D\u5199 MCP server \u914D\u7F6E(Claude Code + OpenCode \u90FD\u4E0D\u5199)").action(run(install));
+program2.command("install").description("\u5B89\u88C5 skill(Claude+Codex)+ hook(Claude)+ MCP(\u5404\u5BBF\u4E3B);\u9ED8\u8BA4\u5168\u88C5,--host \u9009\u5355\u5BBF\u4E3B").option("--host <h>", "\u53EA\u88C5\u67D0\u4E2A\u5BBF\u4E3B: claude | codex | opencode(\u7F3A\u7701\u5168\u88C5)").option("--no-skill", "\u4E0D\u5237\u65B0 skill(\u4E0D\u5220\u5DF2\u6709)").option("--no-hook", "\u4E0D\u5199 UserPromptSubmit hook(\u4EC5 Claude)").option("--no-mcp", "\u4E0D\u5199 MCP server \u914D\u7F6E").action(run(install));
+program2.command("doctor").description("\u8BCA\u65AD\u5404\u5BBF\u4E3B skill/hook/MCP/\u9274\u6743 \u72B6\u6001(install \u540E\u6392\u67E5)").action(run(doctor));
 async function main() {
   const first = process.argv[2];
   if (first && /^(-v|--version)$/.test(first)) {