coding-friend-cli 1.36.1 → 1.36.3

package/dist/{chunk-YOXXIXMQ.js → chunk-CDTQL4FI.js}

@@ -80,7 +80,9 @@ var ConfigSchema = z.strictObject({
   review: ReviewConfigSchema.optional(),
   autoApprove: z.boolean().optional(),
   autoApproveIgnore: z.array(z.string()).optional(),
-  autoApproveAllowExtra: z.array(z.string()).optional()
+  autoApproveAllowExtra: z.array(z.string()).optional(),
+  disableGUIPlan: z.boolean().optional(),
+  guiPlanFormat: z.enum(["html", "md"]).optional()
 });
 var KNOWN_KEYS = [
   "language",
@@ -92,7 +94,9 @@ var KNOWN_KEYS = [
   "review",
   "autoApprove",
   "autoApproveIgnore",
-  "autoApproveAllowExtra"
+  "autoApproveAllowExtra",
+  "disableGUIPlan",
+  "guiPlanFormat"
 ];
 function suggestKey(unknown) {
   let best = null;

package/dist/{chunk-76GDRS54.js → chunk-EAJJVXAE.js}

@@ -249,7 +249,7 @@ async function updateCommand(opts) {
     }
   }
   if (doCli) {
-    const { refreshMemoryAfterUpdate } = await import("./memory-5U6GGTVI.js");
+    const { refreshMemoryAfterUpdate } = await import("./memory-XINRMEWB.js");
     await refreshMemoryAfterUpdate();
   }
   if (doStatusline) {

package/dist/{chunk-HILXDUVZ.js → chunk-MAGBNYZK.js}

@@ -1,6 +1,6 @@
 import {
   writeMemoryMcpEntry
-} from "./chunk-2MOPHSMC.js";
+} from "./chunk-VV2U7NDN.js";
 import {
   readJson
 } from "./chunk-5UVDWG5L.js";

package/dist/{chunk-HF7Y63JR.js → chunk-TPGAW67X.js}

@@ -2,16 +2,16 @@ import {
   checkMemoryMcpHealth,
   printHealthSection,
   warnStaleMcpJson
-} from "./chunk-HILXDUVZ.js";
+} from "./chunk-MAGBNYZK.js";
 import {
   getMemoryMcpStatus,
   memoryConfigMenu,
   writeMemoryMcpEntry
-} from "./chunk-2MOPHSMC.js";
+} from "./chunk-VV2U7NDN.js";
 import {
   loadConfig,
   resolveMemoryDir
-} from "./chunk-YOXXIXMQ.js";
+} from "./chunk-CDTQL4FI.js";
 import {
   getLibPath
 } from "./chunk-RZRT7NGT.js";

package/dist/{chunk-2MOPHSMC.js → chunk-VV2U7NDN.js}

@@ -1,6 +1,6 @@
 import {
   resolveMemoryDir
-} from "./chunk-YOXXIXMQ.js";
+} from "./chunk-CDTQL4FI.js";
 import {
   getLibPath
 } from "./chunk-RZRT7NGT.js";

package/dist/{clean-HOVZN7PF.js → clean-MXIMMXDH.js}

@@ -1,7 +1,7 @@
 import {
   loadConfig,
   resolveMemoryDir
-} from "./chunk-YOXXIXMQ.js";
+} from "./chunk-CDTQL4FI.js";
 import "./chunk-57EGAXYI.js";
 import "./chunk-5UVDWG5L.js";
 import {

package/dist/{config-NG46PYON.js → config-B2P7TXL4.js}

@@ -11,10 +11,10 @@ import {
 } from "./chunk-YIXAQ4R2.js";
 import {
   memoryConfigMenu
-} from "./chunk-2MOPHSMC.js";
+} from "./chunk-VV2U7NDN.js";
 import {
   resolveLearnDir
-} from "./chunk-YOXXIXMQ.js";
+} from "./chunk-CDTQL4FI.js";
 import "./chunk-RZRT7NGT.js";
 import {
   findStatuslineHookPath,
@@ -145,7 +145,7 @@ async function editLearnOutputDir(globalCfg) {
   const locationChoices = [];
   if (hasDistinctCurrent) {
     locationChoices.push({
-      name: `Keep current (${oldOutputDir})`,
+      name: `Keep global (${oldOutputDir})`,
       value: "current"
     });
   }
@@ -256,14 +256,15 @@ async function editLearnLanguage(globalCfg) {
 }
 async function editLearnCategories(globalCfg) {
   const existingCats = globalCfg?.learn?.categories;
-  const defaultNames = DEFAULT_CONFIG.learn.categories.map((c) => c.name).join(", ");
+  const defaultCats = DEFAULT_CONFIG.learn.categories;
+  const defaultNames = defaultCats.map((c) => c.name).join(", ");
   const catChoices = [
     { name: `Use defaults (${defaultNames})`, value: "defaults" }
   ];
-  if (existingCats && existingCats.length > 0) {
+  if (existingCats && existingCats.length > 0 && JSON.stringify(existingCats) !== JSON.stringify(defaultCats)) {
     const existingNames = existingCats.map((c) => c.name).join(", ");
     catChoices.push({
-      name: `Keep current (${existingNames})`,
+      name: `Keep global (${existingNames})`,
       value: "existing"
     });
   }
@@ -278,7 +279,7 @@ async function editLearnCategories(globalCfg) {
   } else if (catChoice === "custom") {
     console.log();
     if (existingCats && existingCats.length > 0) {
-      console.log("Current categories:");
+      console.log("Global categories:");
       for (const c of existingCats) {
         log.dim(`  ${c.name}: ${c.description}`);
       }
@@ -375,6 +376,7 @@ async function learnSubMenu() {
     const langVal = globalCfg?.learn?.language;
     const autoCommitVal = globalCfg?.learn?.autoCommit;
     const readmeVal = globalCfg?.learn?.readmeIndex;
+    const catsVal = (globalCfg?.learn?.categories ?? DEFAULT_CONFIG.learn.categories).map((c) => c.name).join(", ");
     const isDisabled = globalCfg?.learn?.disabled ?? false;
     const disabledLabel = isDisabled ? chalk.yellow(" [disabled]") : "";
     const choice = await select({
@@ -390,7 +392,7 @@ async function learnSubMenu() {
             value: "language"
           },
           {
-            name: "Categories",
+            name: `Categories (${catsVal})`,
             value: "categories"
           },
           {
@@ -432,6 +434,85 @@ async function learnSubMenu() {
     }
   }
 }
+async function editDisableGUIPlan(globalCfg, localCfg) {
+  const currentValue = getMergedValue("disableGUIPlan", globalCfg, localCfg);
+  if (currentValue !== void 0) {
+    log.dim(`Current: ${currentValue}`);
+  }
+  const value = await confirm({
+    message: "Disable the human overview doc that /cf-plan generates alongside the agent plan?",
+    default: currentValue ?? false
+  });
+  const scope = await askScope();
+  if (scope === "back") return;
+  writeToScope(scope, { disableGUIPlan: value });
+}
+async function editGuiPlanFormat(globalCfg, localCfg) {
+  const currentValue = getMergedValue(
+    "guiPlanFormat",
+    globalCfg,
+    localCfg
+  );
+  if (currentValue !== void 0) {
+    log.dim(`Current: ${currentValue}`);
+  }
+  const choice = await select({
+    message: "Format for the /cf-plan human overview doc?",
+    choices: injectBackChoice(
+      [
+        { name: "HTML", value: "html" },
+        { name: "Markdown", value: "md" }
+      ],
+      "Back"
+    ),
+    default: currentValue ?? "html"
+  });
+  if (choice === BACK) return;
+  const scope = await askScope();
+  if (scope === "back") return;
+  writeToScope(scope, { guiPlanFormat: choice });
+}
+async function planDocsSubMenu() {
+  while (true) {
+    const globalCfg = readJson(globalConfigPath());
+    const localCfg = readJson(localConfigPath());
+    const disableVal = getMergedValue(
+      "disableGUIPlan",
+      globalCfg,
+      localCfg
+    );
+    const formatVal = getMergedValue(
+      "guiPlanFormat",
+      globalCfg,
+      localCfg
+    );
+    const choice = await select({
+      message: "Plan docs settings:",
+      choices: injectBackChoice(
+        [
+          {
+            name: `Disable overview doc (${disableVal ?? false})`,
+            value: "disableGUIPlan"
+          },
+          {
+            name: `Format (${formatVal ?? "html"})`,
+            value: "guiPlanFormat"
+          }
+        ],
+        "Back"
+      )
+    });
+    if (choice === BACK) return;
+    switch (choice) {
+      case "disableGUIPlan":
+        await editDisableGUIPlan(globalCfg, localCfg);
+        break;
+      case "guiPlanFormat":
+        await editGuiPlanFormat(globalCfg, localCfg);
+        break;
+    }
+  }
+}
 async function editTdd(globalCfg, localCfg) {
   const currentValue = getMergedValue("tdd", globalCfg, localCfg);
   if (currentValue !== void 0) {
@@ -705,6 +786,7 @@ async function configCommand() {
     );
     const reviewScope = getScopeLabel("review", globalCfg, localCfg);
     const withCodexVal = getMergedValue("review", globalCfg, localCfg)?.withCodex;
+    const planDocsScope = getScopeLabel("disableGUIPlan", globalCfg, localCfg);
     const statuslineStatus = isStatuslineConfigured() ? chalk.green("configured") : chalk.yellow("not configured");
     const completionStatus = hasShellCompletion() ? chalk.green("installed") : chalk.yellow("not installed");
     const projectRules = getExistingRules(claudeLocalSettingsPath());
@@ -755,6 +837,11 @@ async function configCommand() {
             value: "review",
             description: "  Run a Codex second-opinion review alongside Claude's on every /cf-review"
           },
+          {
+            name: `Plan docs ${formatScopeLabel(planDocsScope)}`,
+            value: "planDocs",
+            description: "  Human overview doc generated by /cf-plan \u2014 enable/disable + format (html/md)"
+          },
           {
             name: `Statusline (${statuslineStatus})`,
             value: "statusline",
@@ -804,6 +891,9 @@ async function configCommand() {
       case "review":
         await editReviewWithCodex(globalCfg, localCfg);
         break;
+      case "planDocs":
+        await planDocsSubMenu();
+        break;
       case "statusline":
         await editStatusline();
         break;

package/dist/{host-SN27RONR.js → host-PEKK7OOC.js}

@@ -1,6 +1,6 @@
 import {
   resolveLearnDir
-} from "./chunk-YOXXIXMQ.js";
+} from "./chunk-CDTQL4FI.js";
 import {
   getLibPath
 } from "./chunk-RZRT7NGT.js";

package/dist/index.js

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import {
+  installedPluginsPath
+} from "./chunk-X2H7JJMR.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -9,12 +12,38 @@ var __dirname = dirname(fileURLToPath(import.meta.url));
 var pkg = JSON.parse(
   readFileSync(join(__dirname, "..", "package.json"), "utf-8")
 );
+function getInstalledPluginVersion() {
+  try {
+    const data = JSON.parse(readFileSync(installedPluginsPath(), "utf-8"));
+    const plugins = data.plugins ?? data;
+    for (const [key, value] of Object.entries(plugins)) {
+      if (!key.includes("coding-friend")) continue;
+      if (Array.isArray(value) && value.length > 0) {
+        const entry = value[0];
+        if (typeof entry.version === "string") return entry.version;
+      }
+      if (typeof value === "object" && value !== null && "version" in value) {
+        return value.version;
+      }
+    }
+  } catch {
+  }
+  return null;
+}
+function buildVersionString() {
+  const pluginVersion = getInstalledPluginVersion();
+  return [
+    `CLI    ${pkg.version}`,
+    `plugin ${pluginVersion ?? "(not installed)"}`
+  ].join("\n");
+}
+var wantsVersion = process.argv.includes("-v") || process.argv.includes("--version");
 var program = new Command();
 program.name("cf").description(
   "coding-friend CLI \u2014 host learning docs, setup MCP, init projects"
-).version(pkg.version, "-v, --version");
+).version(wantsVersion ? buildVersionString() : pkg.version, "-v, --version");
 program.command("install").description("Install the Coding Friend plugin into Claude Code").option("--user", "Install at user scope (all projects)").option("--global", "Install at user scope (all projects)").option("--project", "Install at project scope (shared via git)").option("--local", "Install at local scope (this machine only)").action(async (opts) => {
-  const { installCommand } = await import("./install-H5VELYYZ.js");
+  const { installCommand } = await import("./install-VFMO45SP.js");
   await installCommand(opts);
 });
 program.command("uninstall").description("Uninstall the Coding Friend plugin from Claude Code").option("--user", "Uninstall from user scope (all projects)").option("--global", "Uninstall from user scope (all projects)").option("--project", "Uninstall from project scope").option("--local", "Uninstall from local scope").action(async (opts) => {
@@ -30,11 +59,11 @@ 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-ZEGE7T5H.js");
+  const { initCommand } = await import("./init-M5JJP5YO.js");
   await initCommand();
 });
 program.command("config").description("Manage Coding Friend configuration").action(async () => {
-  const { configCommand } = await import("./config-NG46PYON.js");
+  const { configCommand } = await import("./config-B2P7TXL4.js");
   await configCommand();
 });
 var learn = program.command("learn").description("Manage learning docs \u2014 host as a website or push to git");
@@ -46,19 +75,19 @@ Learn subcommands:
   learn push [path]   Commit and push learning docs (only if learn dir is the git root)`
 );
 learn.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-SN27RONR.js");
+  const { hostCommand } = await import("./host-PEKK7OOC.js");
   await hostCommand(path, opts);
 });
 learn.command("push").description("Commit and push learning docs to origin").argument("[path]", "path to docs folder").action(async (path) => {
-  const { learnPushCommand } = await import("./learn-27FL56ZT.js");
+  const { learnPushCommand } = await import("./learn-QQ7XEHDY.js");
   await learnPushCommand(path);
 });
 program.command("host", { hidden: true }).argument("[path]", "path to docs folder").option("-p, --port <port>", "port number", "3333").action(async (path, opts) => {
-  const { hostCommand } = await import("./host-SN27RONR.js");
+  const { hostCommand } = await import("./host-PEKK7OOC.js");
   await hostCommand(path, opts);
 });
 program.command("mcp").description("Setup MCP server for learning docs").action(async () => {
-  const { mcpCommand } = await import("./mcp-4ODYPJ4N.js");
+  const { mcpCommand } = await import("./mcp-372LGOZJ.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) => {
@@ -81,15 +110,15 @@ program.command("statusline").description("Setup coding-friend statusline in Cla
   await statuslineCommand();
 });
 program.command("update").description("Update coding-friend plugin, CLI, and statusline").option("--cli", "Update only the CLI (npm package)").option("--plugin", "Update only the Claude Code plugin").option("--statusline", "Update only the statusline").option("--user", "Update plugin at user scope (all projects)").option("--global", "Update plugin at user scope (all projects)").option("--project", "Update plugin at project scope").option("--local", "Update plugin at local scope").action(async (opts) => {
-  const { updateCommand } = await import("./update-DHY2EIY6.js");
+  const { updateCommand } = await import("./update-MY2DRJLV.js");
   await updateCommand(opts);
 });
 program.command("status").description("Show comprehensive Coding Friend status").action(async () => {
-  const { statusCommand } = await import("./status-EAVPCBVN.js");
+  const { statusCommand } = await import("./status-Z4V7IYOB.js");
   await statusCommand();
 });
 program.command("clean").description("Clean files generated by Coding Friend in docs/").action(async () => {
-  const { cleanCommand } = await import("./clean-HOVZN7PF.js");
+  const { cleanCommand } = await import("./clean-MXIMMXDH.js");
   await cleanCommand();
 });
 var session = program.command("session").description("[beta] Save and load Claude Code sessions across machines");
@@ -104,11 +133,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-YIQMX4BQ.js");
+  const { sessionSaveCommand } = await import("./session-2R7WWNML.js");
   await sessionSaveCommand(opts);
 });
 session.command("load").description("Load a saved session from sync folder").action(async () => {
-  const { sessionLoadCommand } = await import("./session-YIQMX4BQ.js");
+  const { sessionLoadCommand } = await import("./session-2R7WWNML.js");
   await sessionLoadCommand();
 });
 var memory = program.command("memory").description("AI memory system \u2014 store and search project knowledge");
@@ -128,43 +157,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-5U6GGTVI.js");
+  const { memoryStatusCommand } = await import("./memory-XINRMEWB.js");
   await memoryStatusCommand();
 });
 memory.command("search").description("Search memories by query").argument("<query>", "search query").action(async (query) => {
-  const { memorySearchCommand } = await import("./memory-5U6GGTVI.js");
+  const { memorySearchCommand } = await import("./memory-XINRMEWB.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-5U6GGTVI.js");
+  const { memoryListCommand } = await import("./memory-XINRMEWB.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-5U6GGTVI.js");
+  const { memoryInitCommand } = await import("./memory-XINRMEWB.js");
   await memoryInitCommand();
 });
 memory.command("config").description("Configure memory system settings").action(async () => {
-  const { memoryConfigCommand } = await import("./memory-5U6GGTVI.js");
+  const { memoryConfigCommand } = await import("./memory-XINRMEWB.js");
   await memoryConfigCommand();
 });
 memory.command("start-daemon").description("Start the memory daemon (Tier 2 \u2014 MiniSearch)").action(async () => {
-  const { memoryStartDaemonCommand } = await import("./memory-5U6GGTVI.js");
+  const { memoryStartDaemonCommand } = await import("./memory-XINRMEWB.js");
   await memoryStartDaemonCommand();
 });
 memory.command("stop-daemon").description("Stop the memory daemon").action(async () => {
-  const { memoryStopDaemonCommand } = await import("./memory-5U6GGTVI.js");
+  const { memoryStopDaemonCommand } = await import("./memory-XINRMEWB.js");
   await memoryStopDaemonCommand();
 });
 memory.command("rebuild").description("Rebuild the daemon search index").action(async () => {
-  const { memoryRebuildCommand } = await import("./memory-5U6GGTVI.js");
+  const { memoryRebuildCommand } = await import("./memory-XINRMEWB.js");
   await memoryRebuildCommand();
 });
 memory.command("mcp").description("Show MCP server setup instructions").action(async () => {
-  const { memoryMcpCommand } = await import("./memory-5U6GGTVI.js");
+  const { memoryMcpCommand } = await import("./memory-XINRMEWB.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(
@@ -172,7 +201,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-5U6GGTVI.js");
+    const { memoryRmCommand } = await import("./memory-XINRMEWB.js");
     await memoryRmCommand(opts);
   }
 );

package/dist/{init-ZEGE7T5H.js → init-M5JJP5YO.js}

@@ -15,12 +15,12 @@ import {
   ensureMemoryBuilt,
   isMemoryInitialized,
   memoryInitWizard
-} from "./chunk-HF7Y63JR.js";
-import "./chunk-HILXDUVZ.js";
+} from "./chunk-TPGAW67X.js";
+import "./chunk-MAGBNYZK.js";
 import {
   memoryConfigMenu
-} from "./chunk-2MOPHSMC.js";
-import "./chunk-YOXXIXMQ.js";
+} from "./chunk-VV2U7NDN.js";
+import "./chunk-CDTQL4FI.js";
 import {
   getLibPath
 } from "./chunk-RZRT7NGT.js";
@@ -408,7 +408,7 @@ async function stepLearnConfig(globalCfg) {
   const locationChoices = [];
   if (hasDistinctCurrent) {
     locationChoices.push({
-      name: `Keep current (${currentOutputDir})`,
+      name: `Keep global (${currentOutputDir})`,
       value: "current"
     });
   }
@@ -449,14 +449,15 @@ async function stepLearnConfig(globalCfg) {
     }
   }
   const existingCats = globalLearn?.categories;
-  const defaultNames = DEFAULT_CONFIG.learn.categories.map((c) => c.name).join(", ");
+  const defaultCats = DEFAULT_CONFIG.learn.categories;
+  const defaultNames = defaultCats.map((c) => c.name).join(", ");
   const catChoices = [
     { name: `Use defaults (${defaultNames})`, value: "defaults" }
   ];
-  if (existingCats && existingCats.length > 0) {
+  if (existingCats && existingCats.length > 0 && JSON.stringify(existingCats) !== JSON.stringify(defaultCats)) {
     const existingNames = existingCats.map((c) => c.name).join(", ");
     catChoices.push({
-      name: `Keep current (${existingNames})`,
+      name: `Keep global (${existingNames})`,
       value: "existing"
     });
   }
@@ -472,7 +473,7 @@ async function stepLearnConfig(globalCfg) {
   } else if (catChoice === "custom") {
     console.log();
     if (existingCats && existingCats.length > 0) {
-      console.log("Current categories in config.json:");
+      console.log("Global categories in config.json:");
       for (const c of existingCats) {
         log.dim(`  ${c.name}: ${c.description}`);
       }
@@ -712,6 +713,53 @@ async function stepAutoApprove(globalCfg, localCfg) {
     log.dim("Docs: https://cf.dinhanhthi.com/docs/reference/auto-approve/");
   }
 }
+async function stepPlanDocs(globalCfg, localCfg) {
+  const currentDisable = getMergedValue(
+    "disableGUIPlan",
+    globalCfg,
+    localCfg
+  );
+  const currentFormat = getMergedValue("guiPlanFormat", globalCfg, localCfg);
+  const scopeLabel = getScopeLabel("disableGUIPlan", globalCfg, localCfg);
+  printStepHeader(
+    `Plan docs ${formatScopeLabel(scopeLabel)}`,
+    "The human overview doc /cf-plan writes next to the agent plan \u2014 enable/disable and choose format."
+  );
+  const disableChoice = await confirm({
+    message: "Disable the /cf-plan human overview doc?",
+    default: currentDisable ?? false
+  });
+  let formatChoice;
+  if (!disableChoice) {
+    const fmt = await select({
+      message: "Format for the human overview doc?",
+      choices: injectBackChoice(
+        [
+          { name: "HTML", value: "html" },
+          { name: "Markdown", value: "md" }
+        ],
+        "Skip plan docs config"
+      ),
+      default: currentFormat ?? "html"
+    });
+    if (fmt === BACK) {
+      log.dim("Skipped plan docs config.");
+      return;
+    }
+    formatChoice = fmt;
+  }
+  const scope = await askScope();
+  if (scope === "back") {
+    log.dim("Skipped plan docs config.");
+    return;
+  }
+  const targetPath = scope === "global" ? globalConfigPath() : localConfigPath();
+  mergeJson(targetPath, {
+    disableGUIPlan: disableChoice,
+    ...formatChoice !== void 0 ? { guiPlanFormat: formatChoice } : {}
+  });
+  log.success(`Saved to ${targetPath}`);
+}
 async function stepClaudePermissions(externalLearnDir, autoCommit) {
   const scope = await select({
     message: "Where should permissions be saved?",
@@ -799,6 +847,17 @@ async function initMenu(gitAvailable) {
       globalCfg,
       localCfg
     );
+    const planDocsScope = getScopeLabel("disableGUIPlan", globalCfg, localCfg);
+    const planDocsDisableVal = getMergedValue(
+      "disableGUIPlan",
+      globalCfg,
+      localCfg
+    );
+    const planDocsFormatVal = getMergedValue(
+      "guiPlanFormat",
+      globalCfg,
+      localCfg
+    );
     const projectRules = getExistingRules(claudeLocalSettingsPath());
     const userRules = getExistingRules(claudeSettingsPath());
     const allRules = getAllRules();
@@ -855,6 +914,11 @@ async function initMenu(gitAvailable) {
         value: "autoApprove",
         description: "  Auto-approve safe tool calls, block destructive ones, prompt for ambiguous"
       },
+      {
+        name: `Plan docs ${formatScopeLabel(planDocsScope)}`,
+        value: "planDocs",
+        description: "  /cf-plan human overview doc \u2014 enable/disable + format (html/md)"
+      },
       {
         name: `Permissions (${permissionStatus} rules)`,
         value: "permissions",
@@ -936,6 +1000,41 @@ async function initMenu(gitAvailable) {
         }
         break;
       }
+      case "planDocs": {
+        const planDocsDisableChoice = await confirm({
+          message: "Disable the /cf-plan human overview doc?",
+          default: planDocsDisableVal ?? false
+        });
+        let planDocsFormatChoice;
+        if (!planDocsDisableChoice) {
+          const fmt = await select({
+            message: "Format for the human overview doc?",
+            choices: injectBackChoice(
+              [
+                { name: "HTML", value: "html" },
+                { name: "Markdown", value: "md" }
+              ],
+              "Skip plan docs config"
+            ),
+            default: planDocsFormatVal ?? "html"
+          });
+          if (fmt === BACK) {
+            log.dim("Skipped plan docs config.");
+            break;
+          }
+          planDocsFormatChoice = fmt;
+        }
+        const planDocsTargetScope = await askScope();
+        if (planDocsTargetScope !== "back") {
+          const targetPath = planDocsTargetScope === "global" ? globalConfigPath() : localConfigPath();
+          mergeJson(targetPath, {
+            disableGUIPlan: planDocsDisableChoice,
+            ...planDocsFormatChoice !== void 0 ? { guiPlanFormat: planDocsFormatChoice } : {}
+          });
+          log.success(`Saved to ${targetPath}`);
+        }
+        break;
+      }
       case "permissions": {
         const learnCfg = globalCfg?.learn;
         const learnOutputDir = learnCfg?.outputDir ?? DEFAULT_CONFIG.learn.outputDir;
@@ -1074,6 +1173,7 @@ async function initCommand() {
   const finalLocal = readJson(localConfigPath());
   await stepTdd(finalGlobal, finalLocal);
   await stepAutoApprove(finalGlobal, finalLocal);
+  await stepPlanDocs(finalGlobal, finalLocal);
   printStepHeader(
     "Configure Claude permissions",
     "Grants Coding Friend skills/hooks the permissions they need, so you get fewer prompts."

package/dist/{install-H5VELYYZ.js → install-VFMO45SP.js}

@@ -1,7 +1,7 @@
 import {
   getLatestVersion,
   semverCompare
-} from "./chunk-76GDRS54.js";
+} from "./chunk-EAJJVXAE.js";
 import {
   getInstalledVersion
 } from "./chunk-7SMP5CZ4.js";

package/dist/{learn-27FL56ZT.js → learn-QQ7XEHDY.js}

@@ -1,6 +1,6 @@
 import {
   resolveLearnDir
-} from "./chunk-YOXXIXMQ.js";
+} from "./chunk-CDTQL4FI.js";
 import "./chunk-57EGAXYI.js";
 import {
   commandExists,

package/dist/{mcp-4ODYPJ4N.js → mcp-372LGOZJ.js}

@@ -8,22 +8,22 @@ import {
 import {
   ensureMemoryBuilt,
   printMemoryMcpConfig
-} from "./chunk-HF7Y63JR.js";
+} from "./chunk-TPGAW67X.js";
 import {
   checkLearnMcpHealth,
   checkMemoryMcpHealth,
   detectMemoryMcpState,
   printHealthSection,
   warnStaleMcpJson
-} from "./chunk-HILXDUVZ.js";
+} from "./chunk-MAGBNYZK.js";
 import {
   getMemoryMcpStatus,
   writeMemoryMcpEntry
-} from "./chunk-2MOPHSMC.js";
+} from "./chunk-VV2U7NDN.js";
 import {
   resolveLearnDir,
   resolveMemoryDir
-} from "./chunk-YOXXIXMQ.js";
+} from "./chunk-CDTQL4FI.js";
 import {
   getLibPath
 } from "./chunk-RZRT7NGT.js";

package/dist/{memory-5U6GGTVI.js → memory-XINRMEWB.js}

@@ -14,10 +14,10 @@ import {
   memoryStopDaemonCommand,
   printMemoryMcpConfig,
   refreshMemoryAfterUpdate
-} from "./chunk-HF7Y63JR.js";
-import "./chunk-HILXDUVZ.js";
-import "./chunk-2MOPHSMC.js";
-import "./chunk-YOXXIXMQ.js";
+} from "./chunk-TPGAW67X.js";
+import "./chunk-MAGBNYZK.js";
+import "./chunk-VV2U7NDN.js";
+import "./chunk-CDTQL4FI.js";
 import "./chunk-RZRT7NGT.js";
 import "./chunk-57EGAXYI.js";
 import "./chunk-IKLMHJH6.js";

package/dist/{session-YIQMX4BQ.js → session-2R7WWNML.js}

@@ -1,6 +1,6 @@
 import {
   loadConfig
-} from "./chunk-YOXXIXMQ.js";
+} from "./chunk-CDTQL4FI.js";
 import "./chunk-57EGAXYI.js";
 import {
   readJson,

package/dist/{status-EAVPCBVN.js → status-Z4V7IYOB.js}

@@ -10,13 +10,13 @@ import {
 import {
   checkLearnMcpHealth,
   checkMemoryMcpHealth
-} from "./chunk-HILXDUVZ.js";
-import "./chunk-2MOPHSMC.js";
+} from "./chunk-MAGBNYZK.js";
+import "./chunk-VV2U7NDN.js";
 import {
   resolveLearnDir,
   resolveMemoryDir,
   sanitizeRawConfig
-} from "./chunk-YOXXIXMQ.js";
+} from "./chunk-CDTQL4FI.js";
 import {
   getLibPath
 } from "./chunk-RZRT7NGT.js";
@@ -25,7 +25,7 @@ import {
   getLatestCliVersion,
   getLatestVersion,
   semverCompare
-} from "./chunk-76GDRS54.js";
+} from "./chunk-EAJJVXAE.js";
 import {
   getInstalledVersion
 } from "./chunk-7SMP5CZ4.js";

package/dist/{update-DHY2EIY6.js → update-MY2DRJLV.js}

@@ -4,7 +4,7 @@ import {
   getLatestVersion,
   semverCompare,
   updateCommand
-} from "./chunk-76GDRS54.js";
+} from "./chunk-EAJJVXAE.js";
 import "./chunk-7SMP5CZ4.js";
 import "./chunk-57EGAXYI.js";
 import "./chunk-667NMPN4.js";

package/package.json

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