@kood/claude-code 0.7.7 → 0.7.9

package/dist/index.js

@@ -22,8 +22,9 @@ var banner = () => {
 };
 
 // src/commands/init.ts
-import fs8 from "fs-extra";
+import fs9 from "fs-extra";
 import os from "os";
+import path11 from "path";
 
 // src/features/templates/template-path-resolver.ts
 import path2 from "path";
@@ -688,16 +689,40 @@ async function promptScopeSelection(options) {
   }
   return { scope: response.value };
 }
+async function promptCodexSync(options) {
+  const { providedSyncCodex, codexSkillsPath } = options;
+  if (providedSyncCodex !== void 0) {
+    return { syncCodex: providedSyncCodex };
+  }
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    return { syncCodex: false };
+  }
+  logger.blank();
+  const pathHint = codexSkillsPath ? ` (${codexSkillsPath})` : "";
+  const result = await promptConfirm(
+    `Also sync with Codex now?${pathHint}`,
+    false
+  );
+  return { syncCodex: result.confirmed };
+}
 
 // src/shared/gitignore-manager.ts
 import fs7 from "fs-extra";
 import path9 from "path";
 var CLAUDE_GENERATED_FOLDERS = [
+  ".claude/brainstorms/",
+  ".claude/crawler/",
+  ".claude/first-principles/",
+  ".claude/genius-ideas/",
   ".claude/plan/",
+  ".claude/plans/",
   ".claude/ralph/",
   ".claude/refactor/",
-  ".claude/prd/"
+  ".claude/prd/",
+  ".claude/research/",
+  ".claude/validation-results/"
 ];
+var CODEX_GENERATED_FOLDERS = [".codex/"];
 function normalizeIgnorePattern(pattern) {
   return pattern.replace(/\\/g, "/").replace(/^\.?\//, "").replace(/\/+$/, "").trim();
 }
@@ -710,9 +735,11 @@ function parseIgnoreLine(line) {
   const normalized = normalizeIgnorePattern(rawPattern);
   return normalized || null;
 }
-async function updateGitignore(targetDir) {
+async function updateGitignore(targetDir, options = {}) {
+  const { includeCodex = false } = options;
   const gitignorePath = path9.join(targetDir, ".gitignore");
   const sectionComment = "# Claude Code generated files";
+  const targetFolders = includeCodex ? [...CLAUDE_GENERATED_FOLDERS, ...CODEX_GENERATED_FOLDERS] : CLAUDE_GENERATED_FOLDERS;
   let content = "";
   let hasGitignore = false;
   try {
@@ -726,7 +753,7 @@ async function updateGitignore(targetDir) {
   const existingPatterns = new Set(
     lines.map((line) => parseIgnoreLine(line)).filter((pattern) => Boolean(pattern))
   );
-  const linesToAdd = CLAUDE_GENERATED_FOLDERS.filter(
+  const linesToAdd = targetFolders.filter(
     (folder) => !existingPatterns.has(normalizeIgnorePattern(folder))
   );
   if (linesToAdd.length === 0) {
@@ -757,6 +784,128 @@ async function updateGitignore(targetDir) {
   }
 }
 
+// src/features/codex-sync/codex-sync.ts
+import fs8 from "fs-extra";
+import path10 from "path";
+var RESERVED_CODEX_SKILL_DIRS = /* @__PURE__ */ new Set([".system", "claude-commands"]);
+function normalizeLineEndings(content) {
+  return content.replace(/\r\n/g, "\n");
+}
+function yamlQuote(value) {
+  return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}
+function extractDescriptionFromFrontmatter(markdown) {
+  const frontmatterMatch = markdown.match(/^---\n([\s\S]*?)\n---\n?/);
+  if (!frontmatterMatch) {
+    return void 0;
+  }
+  const lines = frontmatterMatch[1].split("\n");
+  for (const rawLine of lines) {
+    const line = rawLine.trim();
+    if (!line.startsWith("description:")) {
+      continue;
+    }
+    const value = line.slice("description:".length).trim();
+    if (!value) {
+      return void 0;
+    }
+    return value.replace(/^['"]|['"]$/g, "");
+  }
+  return void 0;
+}
+function buildCommandSkillContent(commandPath, commandRaw) {
+  const commandName = path10.basename(commandPath, ".md");
+  const normalizedCommand = normalizeLineEndings(commandRaw).trim();
+  const sourcePath = path10.resolve(commandPath);
+  const description = extractDescriptionFromFrontmatter(normalizedCommand) || `${commandName} command imported from .claude/commands`;
+  return `---
+name: ${yamlQuote(commandName)}
+description: ${yamlQuote(description)}
+---
+
+Imported command source: ${sourcePath}
+
+Use this as a command playbook. If scripts are referenced with .claude-relative paths,
+resolve them from the current workspace first; if missing, ask for the intended repo root.
+
+---
+
+${normalizedCommand}
+`;
+}
+async function syncSkills(claudeSkillsDir, codexSkillsDir) {
+  await fs8.ensureDir(codexSkillsDir);
+  let sourceSkillNames = [];
+  if (await fs8.pathExists(claudeSkillsDir)) {
+    const sourceEntries = await fs8.readdir(claudeSkillsDir, { withFileTypes: true });
+    sourceSkillNames = sourceEntries.filter((entry) => entry.isDirectory()).map((entry) => entry.name).filter((name) => name !== ".system");
+  }
+  const sourceSkillSet = new Set(sourceSkillNames);
+  const codexEntries = await fs8.readdir(codexSkillsDir, { withFileTypes: true });
+  for (const entry of codexEntries) {
+    if (!entry.isDirectory()) {
+      continue;
+    }
+    if (RESERVED_CODEX_SKILL_DIRS.has(entry.name)) {
+      continue;
+    }
+    if (!sourceSkillSet.has(entry.name)) {
+      await fs8.remove(path10.join(codexSkillsDir, entry.name));
+    }
+  }
+  for (const skillName of sourceSkillNames) {
+    const src = path10.join(claudeSkillsDir, skillName);
+    const dest = path10.join(codexSkillsDir, skillName);
+    if (await fs8.pathExists(dest)) {
+      await fs8.remove(dest);
+    }
+    await copyRecursive(src, dest, { files: 0, directories: 0 });
+  }
+  return sourceSkillNames.length;
+}
+async function syncCommands(claudeCommandsDir, codexCommandsDir) {
+  if (!await fs8.pathExists(claudeCommandsDir)) {
+    await fs8.remove(codexCommandsDir);
+    return 0;
+  }
+  const entries = await fs8.readdir(claudeCommandsDir, { withFileTypes: true });
+  const commandFiles = entries.filter((entry) => entry.isFile() && entry.name.endsWith(".md")).map((entry) => entry.name).sort((a, b) => a.localeCompare(b));
+  if (commandFiles.length === 0) {
+    await fs8.remove(codexCommandsDir);
+    return 0;
+  }
+  await fs8.remove(codexCommandsDir);
+  await fs8.ensureDir(codexCommandsDir);
+  for (const commandFile of commandFiles) {
+    const commandPath = path10.join(claudeCommandsDir, commandFile);
+    const commandRaw = await fs8.readFile(commandPath, "utf8");
+    const commandName = path10.basename(commandFile, ".md");
+    const skillDir = path10.join(codexCommandsDir, commandName);
+    const skillPath = path10.join(skillDir, "SKILL.md");
+    await fs8.ensureDir(skillDir);
+    await fs8.writeFile(skillPath, buildCommandSkillContent(commandPath, commandRaw));
+  }
+  return commandFiles.length;
+}
+async function syncWithCodex(targetDir) {
+  const codexHome = path10.resolve(targetDir, ".codex");
+  const codexSkillsDir = path10.join(codexHome, "skills");
+  const codexCommandsDir = path10.join(codexSkillsDir, "claude-commands");
+  await fs8.ensureDir(codexSkillsDir);
+  const claudeRootDir = path10.join(targetDir, ".claude");
+  const claudeSkillsDir = path10.join(claudeRootDir, "skills");
+  const claudeCommandsDir = path10.join(claudeRootDir, "commands");
+  const syncedSkills = await syncSkills(claudeSkillsDir, codexSkillsDir);
+  const syncedCommands = await syncCommands(claudeCommandsDir, codexCommandsDir);
+  return {
+    codexHome,
+    codexSkillsDir,
+    codexCommandsDir,
+    syncedSkills,
+    syncedCommands
+  };
+}
+
 // src/commands/init.ts
 var TEMPLATE_DESCRIPTIONS = {
   "tanstack-start": "TanStack Start + React \uD480\uC2A4\uD0DD \uD504\uB85C\uC81D\uD2B8",
@@ -766,7 +915,7 @@ var TEMPLATE_DESCRIPTIONS = {
 };
 async function validateTargetDirectory(targetDir) {
   try {
-    const stat = await fs8.stat(targetDir);
+    const stat = await fs9.stat(targetDir);
     if (!stat.isDirectory()) {
       logger.error(`Target is not a directory: ${targetDir}`);
       process.exit(1);
@@ -780,7 +929,7 @@ async function validateTargetDirectory(targetDir) {
     process.exit(1);
   }
   try {
-    await fs8.access(targetDir, fs8.constants.W_OK);
+    await fs9.access(targetDir, fs9.constants.W_OK);
   } catch {
     logger.error(`No write permission for: ${targetDir}`);
     process.exit(1);
@@ -953,9 +1102,38 @@ var init = async (options) => {
     hasScripts,
     scope
   );
+  const codexSkillsPath = path11.join(targetDir, ".codex", "skills");
+  const { syncCodex } = await promptCodexSync({
+    providedSyncCodex: options.syncCodex,
+    codexSkillsPath
+  });
+  if (syncCodex) {
+    logger.blank();
+    logger.info("Syncing .claude skills/commands to Codex...");
+    try {
+      const result = await syncWithCodex(targetDir);
+      if (result.syncedSkills > 0) {
+        logger.step(`Skills synced: ${result.syncedSkills}`);
+      }
+      if (result.syncedCommands > 0) {
+        logger.step(`Commands synced: ${result.syncedCommands}`);
+      }
+      if (result.syncedSkills === 0 && result.syncedCommands === 0) {
+        logger.warn(
+          "Nothing was synced. .claude/skills and .claude/commands were not found."
+        );
+      } else {
+        logger.success(`Codex sync complete: ${result.codexSkillsDir}`);
+      }
+    } catch (error) {
+      logger.warn(
+        `Codex sync failed: ${error instanceof Error ? error.message : "Unknown error"}`
+      );
+    }
+  }
   if (!isUserScope) {
     try {
-      await updateGitignore(targetDir);
+      await updateGitignore(targetDir, { includeCodex: syncCodex });
     } catch (error) {
       logger.warn(
         `Failed to update .gitignore: ${error instanceof Error ? error.message : "Unknown error"}`
@@ -966,11 +1144,14 @@ var init = async (options) => {
 
 // src/index.ts
 var program = new Command();
-program.name("claude-code").description("Claude Code documentation installer for projects").version("0.7.7");
+program.name("claude-code").description("Claude Code documentation installer for projects").version("0.7.9");
 program.option(
   "-t, --template <names>",
   "template names (comma-separated: tanstack-start,hono)"
-).option("-f, --force", "overwrite existing files without prompting").option("--cwd <path>", "target directory (default: current directory)").option("--list", "list available templates").option("-s, --skills", "install skills to .claude/skills/").option("-c, --commands", "install commands to .claude/commands/").option("-a, --agents", "install agents to .claude/agents/").option("--scope <scope>", "installation scope (project|user)").action(async (options) => {
+).option("-f, --force", "overwrite existing files without prompting").option("--cwd <path>", "target directory (default: current directory)").option("--list", "list available templates").option("-s, --skills", "install skills to .claude/skills/").option("-c, --commands", "install commands to .claude/commands/").option("-a, --agents", "install agents to .claude/agents/").option(
+  "--sync-codex",
+  "sync installed .claude skills/commands to selected-scope .codex/skills/"
+).option("--scope <scope>", "installation scope (project|user)").action(async (options) => {
   banner();
   if (options.list) {
     const templates = await listAvailableTemplates();
@@ -986,7 +1167,8 @@ program.option(
     scope: options.scope,
     skills: options.skills,
     commands: options.commands,
-    agents: options.agents
+    agents: options.agents,
+    syncCodex: options.syncCodex
   });
 });
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kood/claude-code",
-  "version": "0.7.7",
+  "version": "0.7.9",
   "description": "Claude Code documentation installer for projects",
   "type": "module",
   "bin": "./dist/index.js",