coding-friend-cli 1.35.6 → 1.35.8

package/README.md

@@ -2,6 +2,23 @@
 
 CLI companion for the [coding-friend](https://github.com/dinhanhthi/coding-friend) plugin — a lean toolkit for disciplined engineering workflows with Claude Code.
 
+## Plugin without the CLI?
+
+If you installed the Coding Friend plugin through the Claude Code marketplace but cannot install or run this CLI (npm errors, sandboxed environment, restricted machine), **the plugin still works**. You lose:
+
+- Fast indexed memory search — falls back to `grep -r '<query>' docs/memory/`
+- The `coding-friend-learn-host` doc viewer — open `docs/learn/*.md` directly in your editor
+- The `cf statusline` renderer — Claude Code's default statusline takes over
+
+Everything else (every skill, every agent, every hook except the three OPTIONAL hooks above) is unaffected. See [`../docs/cli-requirements.md`](../docs/cli-requirements.md) for the full matrix.
+
+### Common CLI install issues
+
+- **`node` not found** — install Node.js 20+ from <https://nodejs.org> (the CLI declares `engines.node >= 20`; older versions will refuse to install).
+- **`EACCES` on global install** — set a user-writable global prefix: `npm config set prefix ~/.npm-global` and add `~/.npm-global/bin` to your `PATH`.
+- **`cf` not on PATH after install** — verify with `npm root -g` and ensure that directory's `bin/` is in your `PATH`.
+- **MCP server not appearing in Claude Code** — after install, run `cf mcp` to register the memory MCP, then restart Claude Code.
+
 ## Requirements
 
 - Node.js >= 20

package/dist/{chunk-B2NFXRFP.js → chunk-5Z5TZUHZ.js}

@@ -67,6 +67,9 @@ var MemoryConfigSchema = z.object({
   autoCapture: z.boolean().optional(),
   autoStart: z.boolean().optional()
 });
+var ReviewConfigSchema = z.strictObject({
+  withCodex: z.boolean().optional()
+});
 var ConfigSchema = z.strictObject({
   language: z.string().optional(),
   docsDir: z.string().optional(),
@@ -74,6 +77,7 @@ var ConfigSchema = z.strictObject({
   learn: LearnConfigSchema.optional(),
   statusline: StatuslineConfigSchema.optional(),
   memory: MemoryConfigSchema.optional(),
+  review: ReviewConfigSchema.optional(),
   autoApprove: z.boolean().optional(),
   autoApproveIgnore: z.array(z.string()).optional(),
   autoApproveAllowExtra: z.array(z.string()).optional()
@@ -85,6 +89,7 @@ var KNOWN_KEYS = [
   "learn",
   "statusline",
   "memory",
+  "review",
   "autoApprove",
   "autoApproveIgnore",
   "autoApproveAllowExtra"

package/dist/{chunk-YBK44KZM.js → chunk-ASNR6LFD.js}

@@ -2,16 +2,16 @@ import {
   checkMemoryMcpHealth,
   printHealthSection,
   warnStaleMcpJson
-} from "./chunk-XMSSEJYL.js";
+} from "./chunk-UXIWEBI2.js";
 import {
   getMemoryMcpStatus,
   memoryConfigMenu,
   writeMemoryMcpEntry
-} from "./chunk-DTSWPWPA.js";
+} from "./chunk-HA7E7QZ4.js";
 import {
   loadConfig,
   resolveMemoryDir
-} from "./chunk-B2NFXRFP.js";
+} from "./chunk-5Z5TZUHZ.js";
 import {
   getLibPath
 } from "./chunk-RZRT7NGT.js";

package/dist/{chunk-DTSWPWPA.js → chunk-HA7E7QZ4.js}

@@ -1,6 +1,6 @@
 import {
   resolveMemoryDir
-} from "./chunk-B2NFXRFP.js";
+} from "./chunk-5Z5TZUHZ.js";
 import {
   getLibPath
 } from "./chunk-RZRT7NGT.js";

package/dist/{chunk-XMSSEJYL.js → chunk-UXIWEBI2.js}

@@ -1,6 +1,6 @@
 import {
   writeMemoryMcpEntry
-} from "./chunk-DTSWPWPA.js";
+} from "./chunk-HA7E7QZ4.js";
 import {
   log
 } from "./chunk-NREZK463.js";

package/dist/{clean-VFWQ4AJP.js → clean-PAYOM4FV.js}

@@ -1,7 +1,7 @@
 import {
   loadConfig,
   resolveMemoryDir
-} from "./chunk-B2NFXRFP.js";
+} from "./chunk-5Z5TZUHZ.js";
 import "./chunk-57EGAXYI.js";
 import {
   resolvePath

package/dist/{config-Z3GE6HAP.js → config-NPKT6NN3.js}

@@ -7,10 +7,10 @@ import {
 } from "./chunk-WSUYLIYX.js";
 import {
   memoryConfigMenu
-} from "./chunk-DTSWPWPA.js";
+} from "./chunk-HA7E7QZ4.js";
 import {
   resolveLearnDir
-} from "./chunk-B2NFXRFP.js";
+} from "./chunk-5Z5TZUHZ.js";
 import "./chunk-RZRT7NGT.js";
 import {
   findStatuslineHookPath,
@@ -445,6 +445,20 @@ async function editTdd(globalCfg, localCfg) {
   if (scope === "back") return;
   writeToScope(scope, { tdd: value });
 }
+async function editReviewWithCodex(globalCfg, localCfg) {
+  const currentValue = getMergedValue("review", globalCfg, localCfg)?.withCodex;
+  if (currentValue !== void 0) {
+    log.dim(`Current: ${currentValue}`);
+  }
+  log.dim("Note: requires the Codex CLI installed and logged in.");
+  const value = await confirm({
+    message: "Run a Codex second-opinion review alongside Claude's by default? (every /cf-review, including auto-invoked ones)",
+    default: currentValue ?? false
+  });
+  const scope = await askScope();
+  if (scope === "back") return;
+  writeNestedField("review", scope, "withCodex", value);
+}
 async function editAutoApprove(globalCfg, localCfg) {
   const currentValue = getMergedValue("autoApprove", globalCfg, localCfg);
   if (currentValue !== void 0) {
@@ -689,6 +703,8 @@ async function configCommand() {
       globalCfg,
       localCfg
     );
+    const reviewScope = getScopeLabel("review", globalCfg, localCfg);
+    const withCodexVal = getMergedValue("review", globalCfg, localCfg)?.withCodex;
     const statuslineStatus = isStatuslineConfigured() ? chalk.green("configured") : chalk.yellow("not configured");
     const completionStatus = hasShellCompletion() ? chalk.green("installed") : chalk.yellow("not installed");
     const projectRules = getExistingRules(claudeLocalSettingsPath());
@@ -734,6 +750,11 @@ async function configCommand() {
             value: "autoApprove",
             description: "  Auto-approve safe tool calls, block destructive ones, prompt for ambiguous"
           },
+          {
+            name: `Codex dual-review ${formatScopeLabel(reviewScope)}${withCodexVal !== void 0 ? ` (${withCodexVal})` : ""}`,
+            value: "review",
+            description: "  Run a Codex second-opinion review alongside Claude's on every /cf-review"
+          },
           {
             name: `Statusline (${statuslineStatus})`,
             value: "statusline",
@@ -780,6 +801,9 @@ async function configCommand() {
       case "autoApprove":
         await editAutoApprove(globalCfg, localCfg);
         break;
+      case "review":
+        await editReviewWithCodex(globalCfg, localCfg);
+        break;
       case "statusline":
         await editStatusline();
         break;

package/dist/{dev-DWIZTH25.js → dev-MD5TNAKI.js}

@@ -11,7 +11,8 @@ import {
 } from "./chunk-R6HDMRYL.js";
 import {
   commandExists,
-  run
+  run,
+  runWithStderr
 } from "./chunk-EVGXUDX4.js";
 import {
   devStatePath,
@@ -68,9 +69,11 @@ function ensureClaude() {
 }
 function runClaude(args, label) {
   log.step(label);
-  const result = run("claude", args);
-  if (result === null) {
+  const result = runWithStderr("claude", args);
+  if (result.exitCode !== 0) {
     log.error(`Failed: claude ${args.join(" ")}`);
+    const tail = result.stderr.split("\n").filter((l) => l.trim()).slice(-5).join("\n");
+    if (tail) log.dim(tail);
     return false;
   }
   return true;
@@ -166,11 +169,21 @@ async function devOffCommand() {
       "Removing local marketplace..."
     );
   }
-  if (!runClaude(
+  try {
+    unlinkSync(devStatePath());
+  } catch {
+  }
+  const remoteAdded = runClaude(
     ["plugin", "marketplace", "add", REMOTE_URL],
     "Adding remote marketplace..."
-  )) {
-    log.error("Failed to add remote marketplace.");
+  );
+  if (!remoteAdded) {
+    log.error(
+      "Failed to add remote marketplace. Dev mode is OFF but remote is not configured."
+    );
+    log.dim(
+      `Run \`claude plugin marketplace add ${REMOTE_URL}\` manually, then \`claude plugin install ${PLUGIN_ID}\`.`
+    );
     return;
   }
   if (!runClaude(
@@ -182,10 +195,6 @@ async function devOffCommand() {
       return;
     }
   }
-  try {
-    unlinkSync(devStatePath());
-  } catch {
-  }
   console.log();
   log.success(`Dev mode ${chalk.yellow("OFF")} \u2014 using remote marketplace.`);
   log.dim("Restart Claude Code to see changes.");
@@ -299,7 +308,60 @@ async function devReinstall(path, label) {
   ensureShellCompletion({ silent: true });
 }
 var devRestartCommand = (path) => devReinstall(path, "Restarting dev mode");
-var devUpdateCommand = (path) => devReinstall(path, "Updating dev plugin");
+async function devUpdateCommand(path) {
+  const state = getDevState();
+  if (!state) {
+    log.error("Dev mode is OFF. Run `cf dev on <path>` first.");
+    return;
+  }
+  if (!ensureClaude()) return;
+  if (path && resolve(path) !== state.localPath) {
+    return devReinstall(path, "Updating dev plugin (path changed)");
+  }
+  if (!isMarketplaceRegistered()) {
+    return devReinstall(
+      state.localPath,
+      "Updating dev plugin (marketplace missing)"
+    );
+  }
+  const localPath = state.localPath;
+  const version = getLocalPluginVersion(localPath);
+  const versionLabel = version ? ` (v${version})` : "";
+  console.log();
+  printBanner(`Updating dev plugin${versionLabel}`, { color: chalk.cyan });
+  console.log();
+  log.info(`Local path: ${chalk.cyan(localPath)}`);
+  if (isPluginInstalled()) {
+    if (!runClaude(
+      ["plugin", "uninstall", PLUGIN_ID],
+      "Uninstalling local plugin..."
+    )) {
+      run("claude", ["plugin", "uninstall", PLUGIN_NAME]);
+    }
+  }
+  if (!runClaude(
+    ["plugin", "install", PLUGIN_ID],
+    "Reinstalling plugin from local source..."
+  )) {
+    if (!runClaude(["plugin", "install", PLUGIN_NAME], "Retrying install...")) {
+      log.error(
+        "Failed to reinstall local plugin. Run `cf dev restart` to recover."
+      );
+      return;
+    }
+  }
+  writeJson(devStatePath(), {
+    localPath,
+    savedAt: (/* @__PURE__ */ new Date()).toISOString()
+  });
+  ensureStatusline();
+  ensureShellCompletion({ silent: true });
+  console.log();
+  log.success(
+    `Dev plugin updated${versionLabel} from ${chalk.cyan(localPath)}.`
+  );
+  log.dim("Restart Claude Code to see changes.");
+}
 async function devStatusCommand() {
   const state = getDevState();
   const source = getMarketplaceSource();

package/dist/{host-HKA4OHBM.js → host-DKGDDAGO.js}

@@ -1,6 +1,6 @@
 import {
   resolveDocsDir
-} from "./chunk-B2NFXRFP.js";
+} from "./chunk-5Z5TZUHZ.js";
 import {
   getLibPath
 } from "./chunk-RZRT7NGT.js";

package/dist/index.js

@@ -30,19 +30,19 @@ program.command("enable").description("Re-enable the Coding Friend plugin").opti
   await enableCommand(opts);
 });
 program.command("init").description("Initialize coding-friend in current project").action(async () => {
-  const { initCommand } = await import("./init-MFUX5INO.js");
+  const { initCommand } = await import("./init-ZIUTSR4U.js");
   await initCommand();
 });
 program.command("config").description("Manage Coding Friend configuration").action(async () => {
-  const { configCommand } = await import("./config-Z3GE6HAP.js");
+  const { configCommand } = await import("./config-NPKT6NN3.js");
   await configCommand();
 });
 program.command("host").description("Build and serve learning docs as a static website").argument("[path]", "path to docs folder").option("-p, --port <port>", "port number", "3333").action(async (path, opts) => {
-  const { hostCommand } = await import("./host-HKA4OHBM.js");
+  const { hostCommand } = await import("./host-DKGDDAGO.js");
   await hostCommand(path, opts);
 });
 program.command("mcp").description("Setup MCP server for learning docs").action(async () => {
-  const { mcpCommand } = await import("./mcp-AG7J6CEP.js");
+  const { mcpCommand } = await import("./mcp-T3UG4PS3.js");
   await mcpCommand();
 });
 program.command("mcp-serve").description("Start the cf-memory MCP server (used internally by npx)").argument("<memoryDir>", "path to memory directory").action(async (memoryDir) => {
@@ -69,11 +69,11 @@ program.command("update").description("Update coding-friend plugin, CLI, and sta
   await updateCommand(opts);
 });
 program.command("status").description("Show comprehensive Coding Friend status").action(async () => {
-  const { statusCommand } = await import("./status-DDNQ5QNJ.js");
+  const { statusCommand } = await import("./status-YWABL222.js");
   await statusCommand();
 });
 program.command("clean").description("Clean files generated by Coding Friend in docs/").action(async () => {
-  const { cleanCommand } = await import("./clean-VFWQ4AJP.js");
+  const { cleanCommand } = await import("./clean-PAYOM4FV.js");
   await cleanCommand();
 });
 var session = program.command("session").description("[beta] Save and load Claude Code sessions across machines");
@@ -88,11 +88,11 @@ session.command("save").description("Save current Claude Code session to sync fo
   "-s, --session-id <id>",
   "session UUID to save (default: auto-detect newest)"
 ).option("-l, --label <label>", "label for this session").action(async (opts) => {
-  const { sessionSaveCommand } = await import("./session-B3B3CSRF.js");
+  const { sessionSaveCommand } = await import("./session-MVH6IYHM.js");
   await sessionSaveCommand(opts);
 });
 session.command("load").description("Load a saved session from sync folder").action(async () => {
-  const { sessionLoadCommand } = await import("./session-B3B3CSRF.js");
+  const { sessionLoadCommand } = await import("./session-MVH6IYHM.js");
   await sessionLoadCommand();
 });
 var memory = program.command("memory").description("AI memory system \u2014 store and search project knowledge");
@@ -112,43 +112,43 @@ Memory subcommands:
   memory mcp          Show MCP server setup instructions`
 );
 memory.command("status").description("Show memory system status").action(async () => {
-  const { memoryStatusCommand } = await import("./memory-RZR672Q7.js");
+  const { memoryStatusCommand } = await import("./memory-R57VRQZL.js");
   await memoryStatusCommand();
 });
 memory.command("search").description("Search memories by query").argument("<query>", "search query").action(async (query) => {
-  const { memorySearchCommand } = await import("./memory-RZR672Q7.js");
+  const { memorySearchCommand } = await import("./memory-R57VRQZL.js");
   await memorySearchCommand(query);
 });
 memory.command("list").description(
   "List memories in current project, or all projects with --projects"
 ).option("--projects", "List all project databases with size and metadata").action(async (opts) => {
-  const { memoryListCommand } = await import("./memory-RZR672Q7.js");
+  const { memoryListCommand } = await import("./memory-R57VRQZL.js");
   await memoryListCommand(opts);
 });
 memory.command("init").description(
   "Initialize memory system \u2014 interactive wizard (first time) or config menu"
 ).action(async () => {
-  const { memoryInitCommand } = await import("./memory-RZR672Q7.js");
+  const { memoryInitCommand } = await import("./memory-R57VRQZL.js");
   await memoryInitCommand();
 });
 memory.command("config").description("Configure memory system settings").action(async () => {
-  const { memoryConfigCommand } = await import("./memory-RZR672Q7.js");
+  const { memoryConfigCommand } = await import("./memory-R57VRQZL.js");
   await memoryConfigCommand();
 });
 memory.command("start-daemon").description("Start the memory daemon (Tier 2 \u2014 MiniSearch)").action(async () => {
-  const { memoryStartDaemonCommand } = await import("./memory-RZR672Q7.js");
+  const { memoryStartDaemonCommand } = await import("./memory-R57VRQZL.js");
   await memoryStartDaemonCommand();
 });
 memory.command("stop-daemon").description("Stop the memory daemon").action(async () => {
-  const { memoryStopDaemonCommand } = await import("./memory-RZR672Q7.js");
+  const { memoryStopDaemonCommand } = await import("./memory-R57VRQZL.js");
   await memoryStopDaemonCommand();
 });
 memory.command("rebuild").description("Rebuild the daemon search index").action(async () => {
-  const { memoryRebuildCommand } = await import("./memory-RZR672Q7.js");
+  const { memoryRebuildCommand } = await import("./memory-R57VRQZL.js");
   await memoryRebuildCommand();
 });
 memory.command("mcp").description("Show MCP server setup instructions").action(async () => {
-  const { memoryMcpCommand } = await import("./memory-RZR672Q7.js");
+  const { memoryMcpCommand } = await import("./memory-R57VRQZL.js");
   await memoryMcpCommand();
 });
 memory.command("rm").description("Remove a project database").option("--project-id <id>", "Project ID to remove").option("--all", "Remove all project databases").option(
@@ -156,7 +156,7 @@ memory.command("rm").description("Remove a project database").option("--project-
   "Remove orphaned projects (source dir missing or 0 memories)"
 ).action(
   async (opts) => {
-    const { memoryRmCommand } = await import("./memory-RZR672Q7.js");
+    const { memoryRmCommand } = await import("./memory-R57VRQZL.js");
     await memoryRmCommand(opts);
   }
 );
@@ -182,35 +182,37 @@ Dev subcommands:
   dev update [path]   Update local dev plugin to latest version`
 );
 dev.command("on").description("Switch to local plugin source").argument("[path]", "path to local coding-friend repo (default: cwd)").action(async (path) => {
-  const { devOnCommand } = await import("./dev-DWIZTH25.js");
+  const { devOnCommand } = await import("./dev-MD5TNAKI.js");
   await devOnCommand(path);
 });
 dev.command("off").description("Switch back to remote marketplace").action(async () => {
-  const { devOffCommand } = await import("./dev-DWIZTH25.js");
+  const { devOffCommand } = await import("./dev-MD5TNAKI.js");
   await devOffCommand();
 });
 dev.command("status").description("Show current dev mode").action(async () => {
-  const { devStatusCommand } = await import("./dev-DWIZTH25.js");
+  const { devStatusCommand } = await import("./dev-MD5TNAKI.js");
   await devStatusCommand();
 });
 dev.command("sync").description(
   "Copy local source files to plugin cache (no version bump needed)"
 ).action(async () => {
-  const { devSyncCommand } = await import("./dev-DWIZTH25.js");
+  const { devSyncCommand } = await import("./dev-MD5TNAKI.js");
   await devSyncCommand();
 });
 dev.command("restart").description("Reinstall local dev plugin (off + on)").argument(
   "[path]",
   "path to local coding-friend repo (default: saved path or cwd)"
 ).action(async (path) => {
-  const { devRestartCommand } = await import("./dev-DWIZTH25.js");
+  const { devRestartCommand } = await import("./dev-MD5TNAKI.js");
   await devRestartCommand(path);
 });
-dev.command("update").description("Update local dev plugin to latest version (off + on)").argument(
+dev.command("update").description(
+  "Refresh local dev plugin via uninstall + reinstall (fast, no remote round-trip)"
+).argument(
   "[path]",
   "path to local coding-friend repo (default: saved path or cwd)"
 ).action(async (path) => {
-  const { devUpdateCommand } = await import("./dev-DWIZTH25.js");
+  const { devUpdateCommand } = await import("./dev-MD5TNAKI.js");
   await devUpdateCommand(path);
 });
 program.hook("postAction", async () => {

package/dist/{init-MFUX5INO.js → init-ZIUTSR4U.js}

@@ -2,16 +2,16 @@ import {
   ensureMemoryBuilt,
   isMemoryInitialized,
   memoryInitWizard
-} from "./chunk-YBK44KZM.js";
-import "./chunk-XMSSEJYL.js";
+} from "./chunk-ASNR6LFD.js";
+import "./chunk-UXIWEBI2.js";
 import {
   isLearnMcpRegistered,
   registerLearnMcp
 } from "./chunk-WSUYLIYX.js";
 import {
   memoryConfigMenu
-} from "./chunk-DTSWPWPA.js";
-import "./chunk-B2NFXRFP.js";
+} from "./chunk-HA7E7QZ4.js";
+import "./chunk-5Z5TZUHZ.js";
 import {
   getLibPath
 } from "./chunk-RZRT7NGT.js";

package/dist/{mcp-AG7J6CEP.js → mcp-T3UG4PS3.js}

@@ -1,14 +1,14 @@
 import {
   ensureMemoryBuilt,
   printMemoryMcpConfig
-} from "./chunk-YBK44KZM.js";
+} from "./chunk-ASNR6LFD.js";
 import {
   checkLearnMcpHealth,
   checkMemoryMcpHealth,
   detectMemoryMcpState,
   printHealthSection,
   warnStaleMcpJson
-} from "./chunk-XMSSEJYL.js";
+} from "./chunk-UXIWEBI2.js";
 import {
   listMdFilesRecursive
 } from "./chunk-2DTXVMPQ.js";
@@ -19,11 +19,11 @@ import {
 import {
   getMemoryMcpStatus,
   writeMemoryMcpEntry
-} from "./chunk-DTSWPWPA.js";
+} from "./chunk-HA7E7QZ4.js";
 import {
   resolveLearnDir,
   resolveMemoryDir
-} from "./chunk-B2NFXRFP.js";
+} from "./chunk-5Z5TZUHZ.js";
 import {
   getLibPath
 } from "./chunk-RZRT7NGT.js";

package/dist/{memory-RZR672Q7.js → memory-R57VRQZL.js}

@@ -13,10 +13,10 @@ import {
   memoryStatusCommand,
   memoryStopDaemonCommand,
   printMemoryMcpConfig
-} from "./chunk-YBK44KZM.js";
-import "./chunk-XMSSEJYL.js";
-import "./chunk-DTSWPWPA.js";
-import "./chunk-B2NFXRFP.js";
+} from "./chunk-ASNR6LFD.js";
+import "./chunk-UXIWEBI2.js";
+import "./chunk-HA7E7QZ4.js";
+import "./chunk-5Z5TZUHZ.js";
 import "./chunk-RZRT7NGT.js";
 import "./chunk-57EGAXYI.js";
 import "./chunk-TAPL6NF3.js";

package/dist/{session-B3B3CSRF.js → session-MVH6IYHM.js}

@@ -1,6 +1,6 @@
 import {
   loadConfig
-} from "./chunk-B2NFXRFP.js";
+} from "./chunk-5Z5TZUHZ.js";
 import "./chunk-57EGAXYI.js";
 import {
   claudeSessionDir,

package/dist/{status-DDNQ5QNJ.js → status-YWABL222.js}

@@ -1,19 +1,19 @@
 import {
   checkLearnMcpHealth,
   checkMemoryMcpHealth
-} from "./chunk-XMSSEJYL.js";
+} from "./chunk-UXIWEBI2.js";
 import {
   listMdFilesRecursive
 } from "./chunk-2DTXVMPQ.js";
 import {
   isLearnMcpRegistered
 } from "./chunk-WSUYLIYX.js";
-import "./chunk-DTSWPWPA.js";
+import "./chunk-HA7E7QZ4.js";
 import {
   resolveLearnDir,
   resolveMemoryDir,
   sanitizeRawConfig
-} from "./chunk-B2NFXRFP.js";
+} from "./chunk-5Z5TZUHZ.js";
 import {
   getLibPath
 } from "./chunk-RZRT7NGT.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coding-friend-cli",
-  "version": "1.35.6",
+  "version": "1.35.8",
   "description": "CLI for coding-friend — host learning docs, setup MCP server, initialize projects",
   "type": "module",
   "bin": {