coding-friend-cli 1.37.0 → 1.38.1

package/README.md

@@ -1,6 +1,6 @@
 # coding-friend-cli
 
-CLI companion for the [coding-friend](https://github.com/dinhanhthi/coding-friend) plugin — a lean toolkit for disciplined engineering workflows with Claude Code.
+CLI companion for the [coding-friend](https://github.com/dinhanhthi/coding-friend) plugin — a lean toolkit for disciplined engineering workflows with Claude Code and Codex CLI.
 
 ## Plugin without the CLI?
 
@@ -23,7 +23,7 @@ Everything else (every skill, every agent, every hook except the three OPTIONAL
 
 - Node.js >= 20
 - npm (included with Node.js, but on some Linux distros you may need to install it separately)
-- The [coding-friend plugin](https://github.com/dinhanhthi/coding-friend) installed in Claude Code
+- The [coding-friend plugin](https://github.com/dinhanhthi/coding-friend) installed in Claude Code or Codex CLI
 
 ### Additional requirements for `cf memory init`
 
@@ -56,12 +56,14 @@ cf install --user       # Install at user scope (all projects)
 cf install --global     # Same as --user
 cf install --project    # Install at project scope (shared via git)
 cf install --local      # Install at local scope (this machine only)
+cf install --agent codex  # Register/install Coding Friend for Codex CLI
                         # 💡 Safe to run multiple times (idempotent).
 cf uninstall            # Uninstall plugin (interactive scope chooser)
 cf uninstall --user     # Uninstall from user scope (full cleanup)
 cf uninstall --global   # Same as --user
 cf uninstall --project  # Uninstall from project scope only
 cf uninstall --local    # Uninstall from local scope only
+cf uninstall --agent codex  # Disable Coding Friend in Codex CLI
                         # 💡 Interactive — asks for confirmation before acting.
 cf disable             # Disable plugin (interactive scope chooser)
 cf disable --user      # Disable at user scope (all projects)
@@ -75,6 +77,7 @@ cf enable --global     # Same as --user
 cf enable --project    # Enable at project scope
 cf enable --local      # Enable at local scope
 cf init              # Initialize workspace (interactive)
+cf init --agent codex  # Initialize workspace for Codex CLI
                      # 💡 You can run this anywhere, anytime.
 cf config            # Manage Coding Friend configuration (interactive menu)
                      # 💡 Edit docsDir, language, learn settings, and more.
@@ -89,6 +92,7 @@ cf permission              # Manage Claude Code permission rules (interactive)
 cf permission --all        # Apply all recommended permissions without prompts
 cf permission --user       # Save to user-level settings (~/.claude/settings.json)
 cf permission --project    # Save to project-level settings (.claude/settings.local.json)
+cf permission --agent codex --enable-auto-approve
 cf permission --all --user # Apply all recommended permissions to user settings
 cf statusline        # Setup coding-friend statusline
 cf update               # Update plugin + CLI + statusline
@@ -97,6 +101,7 @@ cf update               # Update plugin + CLI + statusline
 cf update --cli         # Update only the CLI (npm package)
 cf update --plugin      # Update only the Claude Code plugin
 cf update --statusline  # Update only the statusline
+cf update --agent codex # Update Codex marketplace/plugin cache
 cf update --project     # Update plugin at project scope
 cf update --local       # Update plugin at local scope
 cf dev on [path]     # Switch to local plugin source for development

package/dist/{chunk-GZT3YPAP.js → chunk-32UAW3NX.js}

@@ -8,7 +8,7 @@ import {
   claudeSettingsPath,
   installedPluginsPath,
   knownMarketplacesPath
-} from "./chunk-X2H7JJMR.js";
+} from "./chunk-PLSJW7QJ.js";
 
 // src/lib/plugin-state.ts
 var MARKETPLACE_NAME = "coding-friend-marketplace";

package/dist/chunk-5QCGEPQO.js

@@ -0,0 +1,238 @@
+import {
+  codexAgentsDir,
+  codexConfigTomlPath,
+  codexInstalledPluginsPath
+} from "./chunk-PLSJW7QJ.js";
+
+// src/lib/codex-config.ts
+import {
+  copyFileSync,
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  readFileSync,
+  rmSync,
+  writeFileSync
+} from "fs";
+import { basename, dirname, join, resolve } from "path";
+var CODEX_MARKETPLACE_NAME = "coding-friend-marketplace";
+var CODEX_PLUGIN_NAME = "coding-friend";
+var CODEX_PLUGIN_ID = `${CODEX_PLUGIN_NAME}@${CODEX_MARKETPLACE_NAME}`;
+var CODEX_PLUGIN_TABLE = `plugins."${CODEX_PLUGIN_ID}"`;
+var CODEX_MEMORY_MCP_TABLE = "mcp_servers.coding-friend-memory";
+function readToml(filePath) {
+  try {
+    return readFileSync(filePath, "utf8");
+  } catch {
+    return "";
+  }
+}
+function writeToml(filePath, content) {
+  mkdirSync(dirname(filePath), { recursive: true });
+  writeFileSync(filePath, content.endsWith("\n") ? content : `${content}
+`);
+}
+function tomlString(value) {
+  return JSON.stringify(value);
+}
+function tableHeader(tableName) {
+  return `[${tableName}]`;
+}
+function findTableRange(lines, header) {
+  const start = lines.findIndex((line) => line.trim() === header);
+  if (start === -1) return null;
+  let end = lines.length;
+  for (let index = start + 1; index < lines.length; index += 1) {
+    if (/^\s*\[[^\]]+\]\s*$/.test(lines[index])) {
+      end = index;
+      break;
+    }
+  }
+  return { start, end };
+}
+function replaceTable(content, tableName, body) {
+  const header = tableHeader(tableName);
+  const lines = content.split(/\n/);
+  const range = findTableRange(lines, header);
+  const nextBlock = [header, ...body];
+  if (range) {
+    lines.splice(range.start, range.end - range.start, ...nextBlock);
+    return `${lines.join("\n").replace(/\n*$/, "")}
+`;
+  }
+  const prefix = content.replace(/\n*$/, "");
+  return `${prefix}${prefix ? "\n\n" : ""}${nextBlock.join("\n")}
+`;
+}
+function upsertTableKey(content, tableName, key, valueLine) {
+  const header = tableHeader(tableName);
+  const lines = content.split(/\n/);
+  const range = findTableRange(lines, header);
+  if (!range) {
+    return replaceTable(content, tableName, [valueLine]);
+  }
+  const keyPattern = new RegExp(`^\\s*${key}\\s*=`);
+  let replaced = false;
+  for (let index = range.start + 1; index < range.end; index += 1) {
+    if (keyPattern.test(lines[index])) {
+      lines[index] = valueLine;
+      replaced = true;
+      break;
+    }
+  }
+  if (!replaced) {
+    lines.splice(range.end, 0, valueLine);
+  }
+  return `${lines.join("\n").replace(/\n*$/, "")}
+`;
+}
+function getTable(content, tableName) {
+  const lines = content.split(/\n/);
+  const range = findTableRange(lines, tableHeader(tableName));
+  if (!range) return [];
+  return lines.slice(range.start + 1, range.end);
+}
+function isCodexMarketplaceRegistered(configPath = codexConfigTomlPath()) {
+  return readToml(configPath).split(/\n/).some(
+    (line) => line.trim() === tableHeader(`marketplaces.${CODEX_MARKETPLACE_NAME}`)
+  );
+}
+function setCodexPluginEnabled(enabled, configPath = codexConfigTomlPath()) {
+  const content = readToml(configPath);
+  writeToml(
+    configPath,
+    upsertTableKey(
+      content,
+      CODEX_PLUGIN_TABLE,
+      "enabled",
+      `enabled = ${enabled ? "true" : "false"}`
+    )
+  );
+}
+function isCodexPluginDisabled(configPath = codexConfigTomlPath()) {
+  const table = getTable(readToml(configPath), CODEX_PLUGIN_TABLE);
+  return table.some((line) => /^\s*enabled\s*=\s*false\s*(?:#.*)?$/.test(line));
+}
+function removeTable(content, tableName) {
+  const lines = content.split(/\n/);
+  const range = findTableRange(lines, tableHeader(tableName));
+  if (!range) return content;
+  let start = range.start;
+  while (start > 0 && lines[start - 1].trim() === "") start -= 1;
+  lines.splice(start, range.end - start);
+  return `${lines.join("\n").replace(/\n*$/, "")}
+`;
+}
+function removeCodexMemoryMcpConfig(configPath = codexConfigTomlPath()) {
+  const content = readToml(configPath);
+  const next = removeTable(content, CODEX_MEMORY_MCP_TABLE);
+  if (next === content) return false;
+  writeToml(configPath, next);
+  return true;
+}
+function removeDeployedCodexAgents(targetDir = codexAgentsDir()) {
+  if (!existsSync(targetDir)) return 0;
+  let removed = 0;
+  for (const entry of readdirSync(targetDir, { withFileTypes: true })) {
+    if (!entry.isFile() || !/^cf-.*\.toml$/.test(entry.name)) continue;
+    rmSync(join(targetDir, entry.name));
+    removed += 1;
+  }
+  return removed;
+}
+function writeCodexMemoryMcpConfig(memoryDir, configPath = codexConfigTomlPath()) {
+  const content = readToml(configPath);
+  writeToml(
+    configPath,
+    replaceTable(content, CODEX_MEMORY_MCP_TABLE, [
+      'command = "npx"',
+      `args = ["-y", "coding-friend-cli", "mcp-serve", ${tomlString(memoryDir)}]`
+    ])
+  );
+}
+function writeCodexAgentLimits(configPath = codexConfigTomlPath()) {
+  const content = readToml(configPath);
+  writeToml(
+    configPath,
+    upsertTableKey(content, "agents", "max_depth", "max_depth = 2")
+  );
+}
+function trustCodexProject(projectPath = process.cwd(), configPath = codexConfigTomlPath()) {
+  const tableName = `projects.${tomlString(projectPath)}`;
+  const content = readToml(configPath);
+  writeToml(
+    configPath,
+    upsertTableKey(
+      content,
+      tableName,
+      "trust_level",
+      'trust_level = "trusted"'
+    )
+  );
+}
+function generatedCodexAgentsDir(repoRoot = process.cwd()) {
+  return resolve(repoRoot, "plugin-codex", "agents");
+}
+function compareVersions(a, b) {
+  const left = a.split(".").map((part) => Number.parseInt(part, 10));
+  const right = b.split(".").map((part) => Number.parseInt(part, 10));
+  for (let index = 0; index < 3; index += 1) {
+    const diff = (left[index] || 0) - (right[index] || 0);
+    if (diff !== 0) return diff > 0 ? 1 : -1;
+  }
+  return 0;
+}
+function latestCodexInstalledPluginDir(pluginRoot = codexInstalledPluginsPath()) {
+  const directManifest = join(pluginRoot, ".codex-plugin", "plugin.json");
+  if (existsSync(directManifest)) return pluginRoot;
+  if (!existsSync(pluginRoot)) return null;
+  const versions = readdirSync(pluginRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name).filter(
+    (version) => existsSync(join(pluginRoot, version, ".codex-plugin", "plugin.json"))
+  ).sort(compareVersions).reverse();
+  return versions[0] ? join(pluginRoot, versions[0]) : null;
+}
+function getCodexInstalledVersion(pluginRoot = codexInstalledPluginsPath()) {
+  const pluginDir = latestCodexInstalledPluginDir(pluginRoot);
+  if (!pluginDir) return null;
+  try {
+    const manifest = JSON.parse(
+      readFileSync(join(pluginDir, ".codex-plugin", "plugin.json"), "utf8")
+    );
+    return manifest.version ?? basename(pluginDir);
+  } catch {
+    return basename(pluginDir);
+  }
+}
+function findCodexAgentSourceDir(repoRoot = process.cwd()) {
+  const generated = generatedCodexAgentsDir(repoRoot);
+  if (existsSync(generated)) return generated;
+  const installedPluginDir = latestCodexInstalledPluginDir();
+  const installedAgents = installedPluginDir ? join(installedPluginDir, "agents") : null;
+  return installedAgents && existsSync(installedAgents) ? installedAgents : null;
+}
+function deployCodexAgents(sourceDir, targetDir = codexAgentsDir()) {
+  if (!existsSync(sourceDir)) return 0;
+  mkdirSync(targetDir, { recursive: true });
+  let copied = 0;
+  for (const entry of readdirSync(sourceDir, { withFileTypes: true })) {
+    if (!entry.isFile() || !entry.name.endsWith(".toml")) continue;
+    copyFileSync(join(sourceDir, entry.name), join(targetDir, entry.name));
+    copied += 1;
+  }
+  return copied;
+}
+
+export {
+  CODEX_MARKETPLACE_NAME,
+  isCodexMarketplaceRegistered,
+  setCodexPluginEnabled,
+  isCodexPluginDisabled,
+  removeCodexMemoryMcpConfig,
+  removeDeployedCodexAgents,
+  writeCodexMemoryMcpConfig,
+  writeCodexAgentLimits,
+  trustCodexProject,
+  getCodexInstalledVersion,
+  findCodexAgentSourceDir,
+  deployCodexAgents
+};

package/dist/{chunk-YIXAQ4R2.js → chunk-6NXZKAOV.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-EVGXUDX4.js";
 import {
   resolvePath
-} from "./chunk-X2H7JJMR.js";
+} from "./chunk-PLSJW7QJ.js";
 import {
   log
 } from "./chunk-NREZK463.js";

package/dist/{chunk-DP6DFQ4G.js → chunk-BXSCYGWE.js}

@@ -6,7 +6,7 @@ import {
   askScope,
   formatScopeLabel,
   injectBackChoice
-} from "./chunk-IKLMHJH6.js";
+} from "./chunk-GIH6E7GJ.js";
 import {
   runWithStderr
 } from "./chunk-EVGXUDX4.js";
@@ -19,7 +19,7 @@ import {
   claudeConfigDir,
   globalConfigPath,
   localConfigPath
-} from "./chunk-X2H7JJMR.js";
+} from "./chunk-PLSJW7QJ.js";
 import {
   log
 } from "./chunk-NREZK463.js";

package/dist/{chunk-W6D3J5DX.js → chunk-CGEMETKQ.js}

@@ -2,23 +2,23 @@ import {
   checkMemoryMcpHealth,
   printHealthSection,
   warnStaleMcpJson
-} from "./chunk-6S7352JG.js";
+} from "./chunk-ONG4KRYP.js";
 import {
   loadConfig,
   resolveMemoryDir
-} from "./chunk-PI4P34KF.js";
+} from "./chunk-RFNKPAJW.js";
 import {
   getMemoryMcpStatus,
   isMemoryMcpRegistered,
   memoryConfigMenu,
   registerMemoryMcp
-} from "./chunk-DP6DFQ4G.js";
+} from "./chunk-BXSCYGWE.js";
 import {
   getLibPath
 } from "./chunk-RZRT7NGT.js";
 import {
   showConfigHint
-} from "./chunk-IKLMHJH6.js";
+} from "./chunk-GIH6E7GJ.js";
 import {
   run,
   runWithStderr
@@ -30,7 +30,7 @@ import {
 import {
   globalConfigPath,
   localConfigPath
-} from "./chunk-X2H7JJMR.js";
+} from "./chunk-PLSJW7QJ.js";
 import {
   log,
   printBanner
@@ -104,7 +104,9 @@ async function refreshMemoryAfterUpdate() {
       log.warn('Memory server build failed \u2014 run "cf memory status" to retry.');
     }
   } catch {
-    log.warn('Could not refresh memory server \u2014 run "cf memory status" to retry.');
+    log.warn(
+      'Could not refresh memory server \u2014 run "cf memory status" to retry.'
+    );
   }
 }
 function printMemoryMcpConfig(memoryDir) {

package/dist/{chunk-XEKQW4RN.js → chunk-ETTZRJ55.js}

@@ -12,7 +12,7 @@ import {
   globalConfigPath,
   installedPluginsPath,
   pluginCachePath
-} from "./chunk-X2H7JJMR.js";
+} from "./chunk-PLSJW7QJ.js";
 
 // src/lib/statusline.ts
 import { existsSync, readdirSync } from "fs";

package/dist/{chunk-IKLMHJH6.js → chunk-GIH6E7GJ.js}

@@ -7,11 +7,62 @@ import {
 import {
   globalConfigPath,
   localConfigPath
-} from "./chunk-X2H7JJMR.js";
+} from "./chunk-PLSJW7QJ.js";
 import {
   log
 } from "./chunk-NREZK463.js";
 
+// src/lib/host.ts
+var CODEX_MIN_VERSION = "0.130.0";
+function resolveHost(opts = {}) {
+  const agent = opts.agent?.trim().toLowerCase();
+  const codexAlias = opts.codex === true;
+  if (agent && agent !== "claude" && agent !== "codex") {
+    throw new Error(
+      `Unsupported agent "${opts.agent}". Use "claude" or "codex".`
+    );
+  }
+  if (codexAlias && agent === "claude") {
+    throw new Error("Use either --agent claude or --codex, not both.");
+  }
+  if (codexAlias) return "codex";
+  if (agent === "codex") return "codex";
+  return "claude";
+}
+function getCodexMinVersion() {
+  return CODEX_MIN_VERSION;
+}
+function checkCodexVersion() {
+  const min = getCodexMinVersion();
+  const output = run("codex", ["--version"]);
+  const actual = output ? extractVersion(output) : void 0;
+  return {
+    ok: actual ? compareVersions(actual, min) >= 0 : false,
+    actual,
+    min
+  };
+}
+function extractVersion(input) {
+  return input.match(/\b(\d+\.\d+\.\d+)\b/)?.[1];
+}
+function compareVersions(a, b) {
+  const left = parseVersion(a);
+  const right = parseVersion(b);
+  for (let i = 0; i < 3; i += 1) {
+    if (left[i] > right[i]) return 1;
+    if (left[i] < right[i]) return -1;
+  }
+  return 0;
+}
+function parseVersion(version) {
+  const parts = version.split(".").map((part) => Number.parseInt(part, 10));
+  return [
+    Number.isFinite(parts[0]) ? parts[0] : 0,
+    Number.isFinite(parts[1]) ? parts[1] : 0,
+    Number.isFinite(parts[2]) ? parts[2] : 0
+  ];
+}
+
 // src/lib/prompt-utils.ts
 import { select, Separator } from "@inquirer/prompts";
 import { existsSync } from "fs";
@@ -80,6 +131,14 @@ async function resolveScope(opts, message) {
   }
   return askPluginScope(message);
 }
+function resolveHostFlags(opts) {
+  try {
+    return { host: resolveHost(opts) };
+  } catch (err) {
+    log.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  }
+}
 function showConfigHint() {
   console.log(chalk.dim("Config files:"));
   console.log(chalk.dim("  Global: ~/.coding-friend/config.json"));
@@ -173,10 +232,12 @@ function applyDocsDirChange(newValue, oldValue, scope, subfolders = []) {
 }
 
 export {
+  checkCodexVersion,
   BACK,
   injectBackChoice,
   askScope,
   resolveScope,
+  resolveHostFlags,
   showConfigHint,
   getScopeLabel,
   formatScopeLabel,

package/dist/{chunk-6S7352JG.js → chunk-ONG4KRYP.js}

@@ -1,6 +1,6 @@
 import {
   isMemoryMcpRegistered
-} from "./chunk-DP6DFQ4G.js";
+} from "./chunk-BXSCYGWE.js";
 import {
   readJson
 } from "./chunk-5UVDWG5L.js";

package/dist/{chunk-X2H7JJMR.js → chunk-PLSJW7QJ.js}

@@ -1,6 +1,8 @@
 // src/lib/paths.ts
 import { homedir } from "os";
 import { resolve, join, isAbsolute } from "path";
+var CODEX_MARKETPLACE_NAME = "coding-friend-marketplace";
+var CODEX_PLUGIN_NAME = "coding-friend";
 function resolvePath(p, base = process.cwd()) {
   if (isAbsolute(p)) return p;
   if (p.startsWith("~/")) return join(homedir(), p.slice(2));
@@ -77,6 +79,29 @@ function claudeProjectsDir() {
 function claudeSessionDir(encodedPath) {
   return join(claudeProjectsDir(), encodedPath);
 }
+function codexConfigDir() {
+  const env = process.env.CODEX_HOME?.trim();
+  if (!env) return join(homedir(), ".codex");
+  if (env === "~") return homedir();
+  if (env.startsWith("~/")) return join(homedir(), env.slice(2));
+  return env;
+}
+function codexConfigTomlPath() {
+  return join(codexConfigDir(), "config.toml");
+}
+function codexPluginsCacheDir() {
+  return join(codexConfigDir(), "plugins", "cache");
+}
+function codexInstalledPluginsPath() {
+  return join(
+    codexPluginsCacheDir(),
+    CODEX_MARKETPLACE_NAME,
+    CODEX_PLUGIN_NAME
+  );
+}
+function codexAgentsDir() {
+  return join(codexConfigDir(), "agents");
+}
 
 export {
   resolvePath,
@@ -95,5 +120,8 @@ export {
   globalConfigDir,
   memoryDepsDir,
   encodeProjectPath,
-  claudeSessionDir
+  claudeSessionDir,
+  codexConfigTomlPath,
+  codexInstalledPluginsPath,
+  codexAgentsDir
 };

package/dist/{chunk-O5ZKLFSL.js → chunk-RCE4OWNX.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-5UVDWG5L.js";
 import {
   pluginCachePath
-} from "./chunk-X2H7JJMR.js";
+} from "./chunk-PLSJW7QJ.js";
 
 // src/lib/permissions.ts
 var STATIC_RULES = [

package/dist/{chunk-PI4P34KF.js → chunk-RFNKPAJW.js}

@@ -11,7 +11,7 @@ import {
   globalConfigPath,
   localConfigPath,
   resolvePath
-} from "./chunk-X2H7JJMR.js";
+} from "./chunk-PLSJW7QJ.js";
 import {
   log
 } from "./chunk-NREZK463.js";
@@ -107,6 +107,7 @@ var ConfigSchema = z.strictObject({
   memory: MemoryConfigSchema.optional(),
   review: ReviewConfigSchema.optional(),
   autoApprove: z.boolean().optional(),
+  autoApproveCodex: z.boolean().optional(),
   autoApproveIgnore: z.array(z.string()).optional(),
   autoApproveAllowExtra: z.array(z.string()).optional(),
   disableGUIPlan: z.boolean().optional(),
@@ -121,6 +122,7 @@ var KNOWN_KEYS = [
   "memory",
   "review",
   "autoApprove",
+  "autoApproveCodex",
   "autoApproveIgnore",
   "autoApproveAllowExtra",
   "disableGUIPlan",