oxe-cc 1.12.0 → 1.16.0

package/bin/lib/oxe-agent-install.cjs

@@ -13,13 +13,13 @@ const path = require('path');
 const os = require('os');
 const runtimeSemantics = require('./oxe-runtime-semantics.cjs');
 
-const OXE_MANAGED_HTML = '<!-- oxe-cc managed -->';
-const OXE_MANAGED_TOML = '# oxe-cc managed';
-
-/** @param {string} name */
-function isOxeCommandMarkdownName(name) {
-  return (name === 'oxe.md' || name.startsWith('oxe-')) && name.endsWith('.md');
-}
+const OXE_MANAGED_HTML = '<!-- oxe-cc managed -->';
+const OXE_MANAGED_TOML = '# oxe-cc managed';
+
+/** @param {string} name */
+function isOxeCommandMarkdownName(name) {
+  return (name === 'oxe.md' || name.startsWith('oxe-')) && name.endsWith('.md');
+}
 
 function expandTilde(p) {
   if (typeof p !== 'string') return p;
@@ -34,20 +34,21 @@ function expandTilde(p) {
  *   opencodeCommandDirs: string[],
  *   geminiCommandsBase: string,
  *   windsurfWorkflowsDir: string,
- *   codexPromptsDir: string,
- *   codexAgentsSkillsRoot: string,
- *   antigravitySkillsRoot: string,
- *   claudeAgentsDir: string,
- * }} AgentInstallPaths
+ *   codexPromptsDir: string,
+ *   codexAgentsSkillsRoot: string,
+ *   antigravitySkillsRoot: string,
+ *   claudeAgentsDir: string,
+ * }} AgentInstallPaths
  */
 
 /**
- * @param {boolean} ideGlobal
- * @param {string} projectRoot
- * @returns {AgentInstallPaths}
- */
-function buildAgentInstallPaths(ideGlobal, projectRoot) {
-  const home = os.homedir();
+ * @param {boolean} ideGlobal
+ * @param {string} projectRoot
+ * @param {{ home?: string }} [options]
+ * @returns {AgentInstallPaths}
+ */
+function buildAgentInstallPaths(ideGlobal, projectRoot, options = {}) {
+  const home = options.home ? path.resolve(options.home) : os.homedir();
   const root = path.resolve(projectRoot);
   if (ideGlobal) {
     const xdg = process.env.XDG_CONFIG_HOME || path.join(home, '.config');
@@ -57,23 +58,23 @@ function buildAgentInstallPaths(ideGlobal, projectRoot) {
       opencodeCommandDirs: [path.join(xdg, 'opencode', 'commands'), path.join(home, '.opencode', 'commands')],
       geminiCommandsBase: path.join(home, '.gemini', 'commands'),
       windsurfWorkflowsDir: path.join(home, '.codeium', 'windsurf', 'global_workflows'),
-      codexPromptsDir: path.join(codexHome, 'prompts'),
-      codexAgentsSkillsRoot: path.join(home, '.agents', 'skills'),
-      antigravitySkillsRoot: path.join(home, '.gemini', 'antigravity', 'skills'),
-      claudeAgentsDir: path.join(home, '.claude', 'agents'),
-    };
-  }
+      codexPromptsDir: path.join(codexHome, 'prompts'),
+      codexAgentsSkillsRoot: path.join(home, '.agents', 'skills'),
+      antigravitySkillsRoot: path.join(home, '.gemini', 'antigravity', 'skills'),
+      claudeAgentsDir: path.join(home, '.claude', 'agents'),
+    };
+  }
   return {
     ideGlobal: false,
     opencodeCommandDirs: [path.join(root, '.opencode', 'commands')],
     geminiCommandsBase: path.join(root, '.gemini', 'commands'),
     windsurfWorkflowsDir: path.join(root, '.windsurf', 'global_workflows'),
-    codexPromptsDir: path.join(root, '.codex', 'prompts'),
-    codexAgentsSkillsRoot: path.join(root, '.agents', 'skills'),
-    antigravitySkillsRoot: path.join(root, '.gemini', 'antigravity', 'skills'),
-    claudeAgentsDir: path.join(root, '.claude', 'agents'),
-  };
-}
+    codexPromptsDir: path.join(root, '.codex', 'prompts'),
+    codexAgentsSkillsRoot: path.join(root, '.agents', 'skills'),
+    antigravitySkillsRoot: path.join(root, '.gemini', 'antigravity', 'skills'),
+    claudeAgentsDir: path.join(root, '.claude', 'agents'),
+  };
+}
 
 /** @param {string} content */
 function adjustWorkflowPathsForNestedLayout(content) {
@@ -95,30 +96,30 @@ function parseCursorCommandFrontmatter(text) {
   if (end === -1) {
     return { description: '', body: normalized.trim(), frontmatter: {} };
   }
-  const yamlBlock = normalized.slice(4, end);
-  const frontmatter = {};
-  let description = '';
-  const yamlLines = yamlBlock.split('\n');
-  for (let i = 0; i < yamlLines.length; i++) {
-    const line = yamlLines[i];
-    const foldedDescription = line.match(/^description:\s*[>|]\s*$/);
-    if (foldedDescription) {
-      const parts = [];
-      let j = i + 1;
-      while (j < yamlLines.length && /^\s+/.test(yamlLines[j])) {
-        const value = yamlLines[j].trim();
-        if (value) parts.push(value);
-        j += 1;
-      }
-      description = parts.join(' ').trim();
-      frontmatter.description = description;
-      i = j - 1;
-      continue;
-    }
-    const m = line.match(/^description:\s*(.+)$/);
-    if (m) {
-      description = m[1].trim().replace(/^["']|["']$/g, '');
-    }
+  const yamlBlock = normalized.slice(4, end);
+  const frontmatter = {};
+  let description = '';
+  const yamlLines = yamlBlock.split('\n');
+  for (let i = 0; i < yamlLines.length; i++) {
+    const line = yamlLines[i];
+    const foldedDescription = line.match(/^description:\s*[>|]\s*$/);
+    if (foldedDescription) {
+      const parts = [];
+      let j = i + 1;
+      while (j < yamlLines.length && /^\s+/.test(yamlLines[j])) {
+        const value = yamlLines[j].trim();
+        if (value) parts.push(value);
+        j += 1;
+      }
+      description = parts.join(' ').trim();
+      frontmatter.description = description;
+      i = j - 1;
+      continue;
+    }
+    const m = line.match(/^description:\s*(.+)$/);
+    if (m) {
+      description = m[1].trim().replace(/^["']|["']$/g, '');
+    }
     const kv = line.match(/^([A-Za-z0-9_-]+):\s*(.+)$/);
     if (kv) frontmatter[kv[1]] = kv[2].trim().replace(/^["']|["']$/g, '');
   }
@@ -132,7 +133,7 @@ function parseCursorCommandFrontmatter(text) {
  * @param {string} body
  * @param {Record<string, string>} [metadata]
  */
-function buildAgentSkillMarkdown(skillName, description, body, metadata) {
+function buildAgentSkillMarkdown(skillName, description, body, metadata) {
   const desc = description.trim() || `Comando OXE — ${skillName}`;
   const meta = metadata ? runtimeSemantics.pickRuntimeMetadata(metadata) : {};
   const metaLines = Object.keys(meta).length
@@ -147,91 +148,91 @@ function buildAgentSkillMarkdown(skillName, description, body, metadata) {
     `---\n\n` +
     `${OXE_MANAGED_HTML}\n\n` +
     `${body}\n`
-  );
-}
-
-/** @param {string} name */
-function isOxeAgentMarkdownName(name) {
-  return name.startsWith('oxe-') && name.endsWith('.md');
-}
-
-/**
- * @param {string} text
- * @returns {{ name: string, description: string, body: string, frontmatter: Record<string, string> }}
- */
-function parseCanonicalAgentMarkdown(text) {
-  const parsed = parseCursorCommandFrontmatter(text);
-  return {
-    name: parsed.frontmatter.name || '',
-    description: parsed.description || parsed.frontmatter.description || '',
-    body: parsed.body,
-    frontmatter: parsed.frontmatter,
-  };
-}
-
-/**
- * Instala agentes especializados OXE como markdown nativo para runtimes que suportam agentes.
- * @param {string} agentsSrc
- * @param {string} destDir
- * @param {{ dryRun: boolean, force: boolean }} opts
- * @param {(s: string) => void} [logOmitido]
- * @param {(s: string) => void} [logWrite]
- */
-function installCanonicalAgentMarkdowns(agentsSrc, destDir, opts, logOmitido, logWrite) {
-  if (!fs.existsSync(agentsSrc)) return;
-  for (const name of fs.readdirSync(agentsSrc)) {
-    if (!isOxeAgentMarkdownName(name)) continue;
-    const src = path.join(agentsSrc, name);
-    const dest = path.join(destDir, name);
-    if (opts.dryRun) {
-      if (logWrite) logWrite(`${src} → ${dest}`);
-      continue;
-    }
-    if (fs.existsSync(dest) && !opts.force) {
-      if (logOmitido) logOmitido(dest);
-      continue;
-    }
-    const raw = fs.readFileSync(src, 'utf8');
-    const out = raw.includes(OXE_MANAGED_HTML) ? raw : raw.replace(/\n?$/, `\n\n${OXE_MANAGED_HTML}\n`);
-    fs.mkdirSync(destDir, { recursive: true });
-    fs.writeFileSync(dest, out, 'utf8');
-  }
-}
-
-/**
- * Instala agentes especializados OXE como skills Codex/Antigravity.
- * @param {string} agentsSrc
- * @param {string} skillsRoot
- * @param {{ dryRun: boolean, force: boolean }} opts
- * @param {(s: string) => void} [logOmitido]
- * @param {(s: string) => void} [logWrite]
- */
-function installCanonicalAgentSkills(agentsSrc, skillsRoot, opts, logOmitido, logWrite) {
-  if (!fs.existsSync(agentsSrc)) return;
-  for (const name of fs.readdirSync(agentsSrc)) {
-    if (!isOxeAgentMarkdownName(name)) continue;
-    const src = path.join(agentsSrc, name);
-    const raw = fs.readFileSync(src, 'utf8');
-    const parsed = parseCanonicalAgentMarkdown(raw);
-    const skillName = parsed.name || name.replace(/\.md$/i, '');
-    const md = buildAgentSkillMarkdown(skillName, parsed.description, parsed.body, parsed.frontmatter);
-    const destDir = path.join(skillsRoot, skillName);
-    const dest = path.join(destDir, 'SKILL.md');
-    if (opts.dryRun) {
-      if (logWrite) logWrite(`${src} → ${dest}`);
-      continue;
-    }
-    if (fs.existsSync(dest) && !opts.force) {
-      if (logOmitido) logOmitido(dest);
-      continue;
-    }
-    fs.mkdirSync(destDir, { recursive: true });
-    fs.writeFileSync(dest, md, 'utf8');
-  }
-}
-
-/**
- * @returns {string[]}
+  );
+}
+
+/** @param {string} name */
+function isOxeAgentMarkdownName(name) {
+  return name.startsWith('oxe-') && name.endsWith('.md');
+}
+
+/**
+ * @param {string} text
+ * @returns {{ name: string, description: string, body: string, frontmatter: Record<string, string> }}
+ */
+function parseCanonicalAgentMarkdown(text) {
+  const parsed = parseCursorCommandFrontmatter(text);
+  return {
+    name: parsed.frontmatter.name || '',
+    description: parsed.description || parsed.frontmatter.description || '',
+    body: parsed.body,
+    frontmatter: parsed.frontmatter,
+  };
+}
+
+/**
+ * Instala agentes especializados OXE como markdown nativo para runtimes que suportam agentes.
+ * @param {string} agentsSrc
+ * @param {string} destDir
+ * @param {{ dryRun: boolean, force: boolean }} opts
+ * @param {(s: string) => void} [logOmitido]
+ * @param {(s: string) => void} [logWrite]
+ */
+function installCanonicalAgentMarkdowns(agentsSrc, destDir, opts, logOmitido, logWrite) {
+  if (!fs.existsSync(agentsSrc)) return;
+  for (const name of fs.readdirSync(agentsSrc)) {
+    if (!isOxeAgentMarkdownName(name)) continue;
+    const src = path.join(agentsSrc, name);
+    const dest = path.join(destDir, name);
+    if (opts.dryRun) {
+      if (logWrite) logWrite(`${src} → ${dest}`);
+      continue;
+    }
+    if (fs.existsSync(dest) && !opts.force) {
+      if (logOmitido) logOmitido(dest);
+      continue;
+    }
+    const raw = fs.readFileSync(src, 'utf8');
+    const out = raw.includes(OXE_MANAGED_HTML) ? raw : raw.replace(/\n?$/, `\n\n${OXE_MANAGED_HTML}\n`);
+    fs.mkdirSync(destDir, { recursive: true });
+    fs.writeFileSync(dest, out, 'utf8');
+  }
+}
+
+/**
+ * Instala agentes especializados OXE como skills Codex/Antigravity.
+ * @param {string} agentsSrc
+ * @param {string} skillsRoot
+ * @param {{ dryRun: boolean, force: boolean }} opts
+ * @param {(s: string) => void} [logOmitido]
+ * @param {(s: string) => void} [logWrite]
+ */
+function installCanonicalAgentSkills(agentsSrc, skillsRoot, opts, logOmitido, logWrite) {
+  if (!fs.existsSync(agentsSrc)) return;
+  for (const name of fs.readdirSync(agentsSrc)) {
+    if (!isOxeAgentMarkdownName(name)) continue;
+    const src = path.join(agentsSrc, name);
+    const raw = fs.readFileSync(src, 'utf8');
+    const parsed = parseCanonicalAgentMarkdown(raw);
+    const skillName = parsed.name || name.replace(/\.md$/i, '');
+    const md = buildAgentSkillMarkdown(skillName, parsed.description, parsed.body, parsed.frontmatter);
+    const destDir = path.join(skillsRoot, skillName);
+    const dest = path.join(destDir, 'SKILL.md');
+    if (opts.dryRun) {
+      if (logWrite) logWrite(`${src} → ${dest}`);
+      continue;
+    }
+    if (fs.existsSync(dest) && !opts.force) {
+      if (logOmitido) logOmitido(dest);
+      continue;
+    }
+    fs.mkdirSync(destDir, { recursive: true });
+    fs.writeFileSync(dest, md, 'utf8');
+  }
+}
+
+/**
+ * @returns {string[]}
  */
 function opencodeCommandDirs() {
   return buildAgentInstallPaths(true, process.cwd()).opencodeCommandDirs;
@@ -328,12 +329,12 @@ function installSkillTreeFromCursorCommands(cCmdSrc, skillsRoot, opts, pathRewri
  * @param {AgentInstallPaths} paths
  */
 function installOpenCodeCommands(cCmdSrc, paths, opts, pathRewriteNested, logOmitido, logWrite) {
-  if (!fs.existsSync(cCmdSrc)) return;
+  if (!fs.existsSync(cCmdSrc)) return;
   for (const destDir of paths.opencodeCommandDirs) {
-    for (const name of fs.readdirSync(cCmdSrc)) {
-      if (!isOxeCommandMarkdownName(name)) continue;
-      const src = path.join(cCmdSrc, name);
-      const dest = path.join(destDir, name);
+    for (const name of fs.readdirSync(cCmdSrc)) {
+      if (!isOxeCommandMarkdownName(name)) continue;
+      const src = path.join(cCmdSrc, name);
+      const dest = path.join(destDir, name);
       if (opts.dryRun) {
         if (logWrite) logWrite(`opencode ${src} → ${dest}`);
         continue;
@@ -345,10 +346,24 @@ function installOpenCodeCommands(cCmdSrc, paths, opts, pathRewriteNested, logOmi
       const raw = fs.readFileSync(src, 'utf8');
       const out = injectManagedAfterFrontmatter(raw, pathRewriteNested);
       fs.mkdirSync(destDir, { recursive: true });
-      fs.writeFileSync(dest, out, 'utf8');
-    }
-  }
-}
+      fs.writeFileSync(dest, out, 'utf8');
+    }
+    const helpSrc = path.join(cCmdSrc, 'oxe-help.md');
+    const rootDest = path.join(destDir, 'oxe.md');
+    if (fs.existsSync(helpSrc) && (opts.force || !fs.existsSync(rootDest))) {
+      const raw = fs.readFileSync(helpSrc, 'utf8');
+      const out = injectManagedAfterFrontmatter(raw, pathRewriteNested);
+      if (opts.dryRun) {
+        if (logWrite) logWrite(`opencode ${helpSrc} → ${rootDest}`);
+      } else {
+        fs.mkdirSync(destDir, { recursive: true });
+        fs.writeFileSync(rootDest, out, 'utf8');
+      }
+    } else if (fs.existsSync(rootDest) && logOmitido) {
+      logOmitido(rootDest);
+    }
+  }
+}
 
 /**
  * ~/.gemini/commands/oxe.toml → /oxe ; oxe/scan.toml → /oxe:scan
@@ -449,13 +464,13 @@ function installWindsurfGlobalWorkflows(cCmdSrc, paths, opts, pathRewriteNested,
  * Codex: prompts em ~/.codex/prompts ou ./.codex/prompts (local).
  * @param {AgentInstallPaths} paths
  */
-function installCodexPrompts(cCmdSrc, paths, opts, pathRewriteNested, logOmitido, logWrite) {
-  if (!fs.existsSync(cCmdSrc)) return;
-  const destDir = paths.codexPromptsDir;
-  for (const name of fs.readdirSync(cCmdSrc)) {
-    if (!isOxeCommandMarkdownName(name)) continue;
-    const src = path.join(cCmdSrc, name);
-    const dest = path.join(destDir, name);
+function installCodexPrompts(cCmdSrc, paths, opts, pathRewriteNested, logOmitido, logWrite) {
+  if (!fs.existsSync(cCmdSrc)) return;
+  const destDir = paths.codexPromptsDir;
+  for (const name of fs.readdirSync(cCmdSrc)) {
+    if (!isOxeCommandMarkdownName(name)) continue;
+    const src = path.join(cCmdSrc, name);
+    const dest = path.join(destDir, name);
     if (opts.dryRun) {
       if (logWrite) logWrite(`codex prompts ${src} → ${dest}`);
       continue;
@@ -489,10 +504,10 @@ function installCodexPrompts(cCmdSrc, paths, opts, pathRewriteNested, logOmitido
  * @param {{ dryRun: boolean }} u
  * @param {AgentInstallPaths} [paths] omissão = instalação global (HOME)
  */
-function cleanupMarkedUnifiedArtifacts(u, paths) {
-  const p = paths || buildAgentInstallPaths(true, process.cwd());
-  const targets = u && typeof u === 'object' && u.targets && typeof u.targets === 'object' ? u.targets : null;
-  const shouldClean = (name) => !targets || targets[name] !== false;
+function cleanupMarkedUnifiedArtifacts(u, paths) {
+  const p = paths || buildAgentInstallPaths(true, process.cwd());
+  const targets = u && typeof u === 'object' && u.targets && typeof u.targets === 'object' ? u.targets : null;
+  const shouldClean = (name) => !targets || targets[name] !== false;
 
   const unlinkQuiet = (filePath) => {
     if (!fs.existsSync(filePath)) return;
@@ -522,119 +537,119 @@ function cleanupMarkedUnifiedArtifacts(u, paths) {
     }
   };
 
-  if (shouldClean('opencode')) {
-    for (const dir of p.opencodeCommandDirs) {
-      if (!fs.existsSync(dir)) continue;
-      for (const name of fs.readdirSync(dir)) {
-        if (!isOxeCommandMarkdownName(name)) continue;
-        const filePath = path.join(dir, name);
-        let txt = '';
-        try {
-          txt = fs.readFileSync(filePath, 'utf8');
-        } catch {
-          continue;
-        }
-        if (txt.includes(OXE_MANAGED_HTML)) unlinkQuiet(filePath);
-      }
-    }
-  }
-
-  if (shouldClean('gemini')) {
-    const gBase = p.geminiCommandsBase;
-    const oxeToml = path.join(gBase, 'oxe.toml');
-    if (fs.existsSync(oxeToml)) {
-      try {
-        if (fs.readFileSync(oxeToml, 'utf8').includes(OXE_MANAGED_TOML)) unlinkQuiet(oxeToml);
-      } catch {
-        /* ignore */
-      }
-    }
-    const oxeSub = path.join(gBase, 'oxe');
-    if (fs.existsSync(oxeSub)) {
-      for (const name of fs.readdirSync(oxeSub)) {
-        if (!name.endsWith('.toml')) continue;
-        const filePath = path.join(oxeSub, name);
-        try {
-          if (fs.readFileSync(filePath, 'utf8').includes(OXE_MANAGED_TOML)) unlinkQuiet(filePath);
-        } catch {
-          /* ignore */
-        }
-      }
-      try {
-        if (!u.dryRun && fs.existsSync(oxeSub) && fs.readdirSync(oxeSub).length === 0) fs.rmdirSync(oxeSub);
-      } catch {
-        /* ignore */
-      }
-    }
-  }
-
-  if (shouldClean('windsurf')) {
-    const wfDir = p.windsurfWorkflowsDir;
-    if (fs.existsSync(wfDir)) {
-      for (const name of fs.readdirSync(wfDir)) {
-        if (!isOxeCommandMarkdownName(name)) continue;
-        const filePath = path.join(wfDir, name);
-        try {
-          if (fs.readFileSync(filePath, 'utf8').includes(OXE_MANAGED_HTML)) unlinkQuiet(filePath);
-        } catch {
-          /* ignore */
-        }
-      }
-    }
-  }
-
-  if (shouldClean('codex')) {
-    const cpDir = p.codexPromptsDir;
-    if (fs.existsSync(cpDir)) {
-      for (const name of fs.readdirSync(cpDir)) {
-        if (!isOxeCommandMarkdownName(name)) continue;
-        const filePath = path.join(cpDir, name);
-        try {
-          if (fs.readFileSync(filePath, 'utf8').includes(OXE_MANAGED_HTML)) unlinkQuiet(filePath);
-        } catch {
-          /* ignore */
-        }
-      }
-    }
-  }
-
-  if (shouldClean('claude')) {
-    const clAgents = p.claudeAgentsDir;
-    if (fs.existsSync(clAgents)) {
-      for (const name of fs.readdirSync(clAgents)) {
-        if (!isOxeAgentMarkdownName(name)) continue;
-        const filePath = path.join(clAgents, name);
-        try {
-          if (fs.readFileSync(filePath, 'utf8').includes(OXE_MANAGED_HTML)) unlinkQuiet(filePath);
-        } catch {
-          /* ignore */
-        }
-      }
-    }
-  }
-
-  if (shouldClean('antigravity')) {
-    const agRoot = p.antigravitySkillsRoot;
-    if (fs.existsSync(agRoot)) {
-      for (const name of fs.readdirSync(agRoot, { withFileTypes: true })) {
-        if (!name.isDirectory()) continue;
-        if (!/^oxe($|-)/.test(name.name)) continue;
-        rmDirIfOxeSkill(path.join(agRoot, name.name));
-      }
-    }
-  }
-
-  if (shouldClean('codex')) {
-    const cxRoot = p.codexAgentsSkillsRoot;
-    if (fs.existsSync(cxRoot)) {
-      for (const name of fs.readdirSync(cxRoot, { withFileTypes: true })) {
-        if (!name.isDirectory()) continue;
-        if (!/^oxe($|-)/.test(name.name)) continue;
-        rmDirIfOxeSkill(path.join(cxRoot, name.name));
-      }
-    }
-  }
-}
+  if (shouldClean('opencode')) {
+    for (const dir of p.opencodeCommandDirs) {
+      if (!fs.existsSync(dir)) continue;
+      for (const name of fs.readdirSync(dir)) {
+        if (!isOxeCommandMarkdownName(name)) continue;
+        const filePath = path.join(dir, name);
+        let txt = '';
+        try {
+          txt = fs.readFileSync(filePath, 'utf8');
+        } catch {
+          continue;
+        }
+        if (txt.includes(OXE_MANAGED_HTML)) unlinkQuiet(filePath);
+      }
+    }
+  }
+
+  if (shouldClean('gemini')) {
+    const gBase = p.geminiCommandsBase;
+    const oxeToml = path.join(gBase, 'oxe.toml');
+    if (fs.existsSync(oxeToml)) {
+      try {
+        if (fs.readFileSync(oxeToml, 'utf8').includes(OXE_MANAGED_TOML)) unlinkQuiet(oxeToml);
+      } catch {
+        /* ignore */
+      }
+    }
+    const oxeSub = path.join(gBase, 'oxe');
+    if (fs.existsSync(oxeSub)) {
+      for (const name of fs.readdirSync(oxeSub)) {
+        if (!name.endsWith('.toml')) continue;
+        const filePath = path.join(oxeSub, name);
+        try {
+          if (fs.readFileSync(filePath, 'utf8').includes(OXE_MANAGED_TOML)) unlinkQuiet(filePath);
+        } catch {
+          /* ignore */
+        }
+      }
+      try {
+        if (!u.dryRun && fs.existsSync(oxeSub) && fs.readdirSync(oxeSub).length === 0) fs.rmdirSync(oxeSub);
+      } catch {
+        /* ignore */
+      }
+    }
+  }
+
+  if (shouldClean('windsurf')) {
+    const wfDir = p.windsurfWorkflowsDir;
+    if (fs.existsSync(wfDir)) {
+      for (const name of fs.readdirSync(wfDir)) {
+        if (!isOxeCommandMarkdownName(name)) continue;
+        const filePath = path.join(wfDir, name);
+        try {
+          if (fs.readFileSync(filePath, 'utf8').includes(OXE_MANAGED_HTML)) unlinkQuiet(filePath);
+        } catch {
+          /* ignore */
+        }
+      }
+    }
+  }
+
+  if (shouldClean('codex')) {
+    const cpDir = p.codexPromptsDir;
+    if (fs.existsSync(cpDir)) {
+      for (const name of fs.readdirSync(cpDir)) {
+        if (!isOxeCommandMarkdownName(name)) continue;
+        const filePath = path.join(cpDir, name);
+        try {
+          if (fs.readFileSync(filePath, 'utf8').includes(OXE_MANAGED_HTML)) unlinkQuiet(filePath);
+        } catch {
+          /* ignore */
+        }
+      }
+    }
+  }
+
+  if (shouldClean('claude')) {
+    const clAgents = p.claudeAgentsDir;
+    if (fs.existsSync(clAgents)) {
+      for (const name of fs.readdirSync(clAgents)) {
+        if (!isOxeAgentMarkdownName(name)) continue;
+        const filePath = path.join(clAgents, name);
+        try {
+          if (fs.readFileSync(filePath, 'utf8').includes(OXE_MANAGED_HTML)) unlinkQuiet(filePath);
+        } catch {
+          /* ignore */
+        }
+      }
+    }
+  }
+
+  if (shouldClean('antigravity')) {
+    const agRoot = p.antigravitySkillsRoot;
+    if (fs.existsSync(agRoot)) {
+      for (const name of fs.readdirSync(agRoot, { withFileTypes: true })) {
+        if (!name.isDirectory()) continue;
+        if (!/^oxe($|-)/.test(name.name)) continue;
+        rmDirIfOxeSkill(path.join(agRoot, name.name));
+      }
+    }
+  }
+
+  if (shouldClean('codex')) {
+    const cxRoot = p.codexAgentsSkillsRoot;
+    if (fs.existsSync(cxRoot)) {
+      for (const name of fs.readdirSync(cxRoot, { withFileTypes: true })) {
+        if (!name.isDirectory()) continue;
+        if (!/^oxe($|-)/.test(name.name)) continue;
+        rmDirIfOxeSkill(path.join(cxRoot, name.name));
+      }
+    }
+  }
+}
 
 module.exports = {
   OXE_MANAGED_HTML,
@@ -645,18 +660,18 @@ module.exports = {
   buildAgentSkillMarkdown,
   installSkillTreeFromCursorCommands,
   installOpenCodeCommands,
-  installGeminiTomlCommands,
-  installWindsurfGlobalWorkflows,
-  installCodexPrompts,
-  installCanonicalAgentMarkdowns,
-  installCanonicalAgentSkills,
-  opencodeCommandDirs,
+  installGeminiTomlCommands,
+  installWindsurfGlobalWorkflows,
+  installCodexPrompts,
+  installCanonicalAgentMarkdowns,
+  installCanonicalAgentSkills,
+  opencodeCommandDirs,
   windsurfGlobalWorkflowsDir,
   geminiUserDir,
   codexAgentsSkillsRoot,
   codexPromptsDir,
-  antigravitySkillsRoot,
-  isOxeCommandMarkdownName,
-  isOxeAgentMarkdownName,
-  cleanupMarkedUnifiedArtifacts,
-};
+  antigravitySkillsRoot,
+  isOxeCommandMarkdownName,
+  isOxeAgentMarkdownName,
+  cleanupMarkedUnifiedArtifacts,
+};