coding-friend-cli 1.3.0 → 1.5.0

package/README.md

@@ -16,6 +16,10 @@ npm i -g coding-friend-cli
 ## Commands
 
 ```bash
+cf install           # Install the Coding Friend plugin into Claude Code
+                     # 💡 Safe to run multiple times (idempotent).
+cf uninstall         # Completely remove plugin, marketplace, statusline, completion
+                     # 💡 Interactive — asks for confirmation before acting.
 cf init              # Initialize workspace (interactive)
                      # 💡 You can run this anywhere, anytime.
 cf host [path]       # Build and serve learning docs at localhost:3333

package/dist/chunk-5OALHHKR.js

@@ -0,0 +1,77 @@
+import {
+  ALL_COMPONENT_IDS,
+  STATUSLINE_COMPONENTS
+} from "./chunk-JWAJ4XPK.js";
+import {
+  claudeSettingsPath,
+  globalConfigPath,
+  pluginCachePath
+} from "./chunk-WHCJT7E2.js";
+import {
+  mergeJson,
+  readJson,
+  writeJson
+} from "./chunk-IUTXHCP7.js";
+
+// src/lib/statusline.ts
+import { existsSync, readdirSync } from "fs";
+import { checkbox } from "@inquirer/prompts";
+function findLatestVersion() {
+  const cachePath = pluginCachePath();
+  if (!existsSync(cachePath)) return null;
+  const versions = readdirSync(cachePath, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name).sort().reverse();
+  return versions[0] ?? null;
+}
+function findStatuslineHookPath() {
+  const version = findLatestVersion();
+  if (!version) return null;
+  const hookPath = `${pluginCachePath()}/${version}/hooks/statusline.sh`;
+  if (!existsSync(hookPath)) return null;
+  return { hookPath, version };
+}
+function loadStatuslineComponents() {
+  const config = readJson(globalConfigPath());
+  const components = config?.statusline?.components;
+  if (!components) return ALL_COMPONENT_IDS;
+  return components.filter(
+    (c) => ALL_COMPONENT_IDS.includes(c)
+  );
+}
+async function selectStatuslineComponents(current) {
+  const enabled = current ?? loadStatuslineComponents();
+  const selected = await checkbox({
+    message: "Which components to show in the statusline?",
+    choices: STATUSLINE_COMPONENTS.map((c) => ({
+      name: c.label,
+      value: c.id,
+      checked: enabled.includes(c.id)
+    }))
+  });
+  return selected;
+}
+function saveStatuslineConfig(components) {
+  mergeJson(globalConfigPath(), { statusline: { components } });
+}
+function writeStatuslineSettings(hookPath) {
+  const settingsPath = claudeSettingsPath();
+  const settings = readJson(settingsPath) ?? {};
+  settings.statusLine = {
+    type: "command",
+    command: `bash ${hookPath}`
+  };
+  writeJson(settingsPath, settings);
+}
+function isStatuslineConfigured() {
+  const settings = readJson(claudeSettingsPath());
+  if (!settings) return false;
+  const sl = settings.statusLine;
+  return !!sl?.command;
+}
+
+export {
+  findStatuslineHookPath,
+  selectStatuslineComponents,
+  saveStatuslineConfig,
+  writeStatuslineSettings,
+  isStatuslineConfigured
+};

package/dist/{chunk-CSF4FAHL.js → chunk-DDISNOEK.js}

@@ -13,7 +13,7 @@ ${MARKER_START}
 _cf_completions() {
   local cur="\${COMP_WORDS[COMP_CWORD]}"
   local prev="\${COMP_WORDS[COMP_CWORD-1]}"
-  local commands="init host mcp statusline update dev"
+  local commands="install uninstall init host mcp statusline update dev"
 
   # Subcommands for 'dev'
   if [[ "\${COMP_WORDS[1]}" == "dev" && \${COMP_CWORD} -eq 2 ]]; then
@@ -38,6 +38,8 @@ ${MARKER_START}
 _cf() {
   local -a commands
   commands=(
+    'install:Install the Coding Friend plugin into Claude Code'
+    'uninstall:Uninstall the Coding Friend plugin from Claude Code'
     'init:Initialize coding-friend in current project'
     'host:Build and serve learning docs as a static website'
     'mcp:Setup MCP server for learning docs'
@@ -94,6 +96,17 @@ function replaceBlock(content, newBlock) {
   while (sliceStart > 0 && content[sliceStart - 1] === "\n") sliceStart--;
   return content.slice(0, sliceStart) + newBlock + content.slice(endIdx + MARKER_END.length);
 }
+function removeShellCompletion() {
+  const rcPath = getShellRcPath();
+  if (!existsSync(rcPath)) return false;
+  const content = readFileSync(rcPath, "utf-8");
+  if (!content.includes(MARKER_START)) return false;
+  const updated = replaceBlock(content, "");
+  writeFileSync(rcPath, updated, "utf-8");
+  const rcName = getRcName(rcPath);
+  log.success(`Tab completion removed from ~/${rcName}`);
+  return true;
+}
 function ensureShellCompletion(opts) {
   const rcPath = getShellRcPath();
   const rcName = getRcName(rcPath);
@@ -125,5 +138,6 @@ function ensureShellCompletion(opts) {
 
 export {
   hasShellCompletion,
+  removeShellCompletion,
   ensureShellCompletion
 };

package/dist/{update-GGCBM7U4.js → chunk-GTTSBOHM.js}

@@ -1,6 +1,6 @@
 import {
   ensureShellCompletion
-} from "./chunk-CSF4FAHL.js";
+} from "./chunk-DDISNOEK.js";
 import {
   commandExists,
   run,
@@ -10,7 +10,7 @@ import {
   claudeSettingsPath,
   installedPluginsPath,
   pluginCachePath
-} from "./chunk-6OI37OZX.js";
+} from "./chunk-WHCJT7E2.js";
 import {
   log
 } from "./chunk-6DUFTBTO.js";
@@ -248,6 +248,10 @@ async function updateCommand(opts) {
   console.log();
   log.dim("Restart Claude Code (or start a new session) to see changes.");
 }
+
 export {
+  semverCompare,
+  getInstalledVersion,
+  getLatestVersion,
   updateCommand
 };

package/dist/{chunk-HRVSKMNA.js → chunk-JWAJ4XPK.js}

@@ -1,4 +1,13 @@
 // src/types.ts
+var STATUSLINE_COMPONENTS = [
+  { id: "version", label: "Plugin version (cf v0.3.0)" },
+  { id: "folder", label: "Project name (MyProject)" },
+  { id: "model", label: "Active model (Opus 4.6)" },
+  { id: "branch", label: "Git branch (\u2387 main)" },
+  { id: "context", label: "Context window usage (ctx 42%)" },
+  { id: "usage", label: "API usage + reset time (15% \u2192 02:30)" }
+];
+var ALL_COMPONENT_IDS = STATUSLINE_COMPONENTS.map((c) => c.id);
 var DEFAULT_CONFIG = {
   language: "en",
   docsDir: "docs",
@@ -27,5 +36,7 @@ var DEFAULT_CONFIG = {
 };
 
 export {
+  STATUSLINE_COMPONENTS,
+  ALL_COMPONENT_IDS,
   DEFAULT_CONFIG
 };

package/dist/chunk-MRTR7TJ4.js

@@ -0,0 +1,27 @@
+import {
+  installedPluginsPath,
+  knownMarketplacesPath
+} from "./chunk-WHCJT7E2.js";
+import {
+  readJson
+} from "./chunk-IUTXHCP7.js";
+
+// src/lib/plugin-state.ts
+var MARKETPLACE_NAME = "coding-friend-marketplace";
+var PLUGIN_NAME = "coding-friend";
+function isPluginInstalled() {
+  const data = readJson(installedPluginsPath());
+  if (!data) return false;
+  const plugins = data.plugins ?? data;
+  return Object.keys(plugins).some((k) => k.includes(PLUGIN_NAME));
+}
+function isMarketplaceRegistered() {
+  const data = readJson(knownMarketplacesPath());
+  if (!data) return false;
+  return MARKETPLACE_NAME in data;
+}
+
+export {
+  isPluginInstalled,
+  isMarketplaceRegistered
+};

package/dist/{chunk-6OI37OZX.js → chunk-WHCJT7E2.js}

@@ -34,6 +34,27 @@ function devStatePath() {
 function knownMarketplacesPath() {
   return join(homedir(), ".claude", "plugins", "known_marketplaces.json");
 }
+function marketplaceCachePath() {
+  return join(
+    homedir(),
+    ".claude",
+    "plugins",
+    "cache",
+    "coding-friend-marketplace"
+  );
+}
+function marketplaceClonePath() {
+  return join(
+    homedir(),
+    ".claude",
+    "plugins",
+    "marketplaces",
+    "coding-friend-marketplace"
+  );
+}
+function globalConfigDir() {
+  return join(homedir(), ".coding-friend");
+}
 
 export {
   resolvePath,
@@ -43,5 +64,8 @@ export {
   installedPluginsPath,
   pluginCachePath,
   devStatePath,
-  knownMarketplacesPath
+  knownMarketplacesPath,
+  marketplaceCachePath,
+  marketplaceClonePath,
+  globalConfigDir
 };

package/dist/{chunk-Q4DKU5IG.js → chunk-X645ACZJ.js}

@@ -2,7 +2,7 @@ import {
   globalConfigPath,
   localConfigPath,
   resolvePath
-} from "./chunk-6OI37OZX.js";
+} from "./chunk-WHCJT7E2.js";
 import {
   readJson
 } from "./chunk-IUTXHCP7.js";

package/dist/{dev-VMN2JHA6.js → dev-WINMWRZK.js}

@@ -1,3 +1,7 @@
+import {
+  isMarketplaceRegistered,
+  isPluginInstalled
+} from "./chunk-MRTR7TJ4.js";
 import {
   commandExists,
   run
@@ -5,10 +9,9 @@ import {
 import {
   claudeSettingsPath,
   devStatePath,
-  installedPluginsPath,
   knownMarketplacesPath,
   pluginCachePath
-} from "./chunk-6OI37OZX.js";
+} from "./chunk-WHCJT7E2.js";
 import {
   log
 } from "./chunk-6DUFTBTO.js";
@@ -35,17 +38,6 @@ var PLUGIN_ID = `${PLUGIN_NAME}@${MARKETPLACE_NAME}`;
 function getDevState() {
   return readJson(devStatePath());
 }
-function isPluginInstalled() {
-  const data = readJson(installedPluginsPath());
-  if (!data) return false;
-  const plugins = data.plugins ?? data;
-  return Object.keys(plugins).some((k) => k.includes(PLUGIN_NAME));
-}
-function isMarketplaceRegistered() {
-  const data = readJson(knownMarketplacesPath());
-  if (!data) return false;
-  return MARKETPLACE_NAME in data;
-}
 function ensureClaude() {
   if (!commandExists("claude")) {
     log.error(

package/dist/{host-2WINWEW7.js → host-VR5POAVU.js}

@@ -1,13 +1,13 @@
 import {
   getLibPath,
   resolveDocsDir
-} from "./chunk-Q4DKU5IG.js";
-import "./chunk-HRVSKMNA.js";
+} from "./chunk-X645ACZJ.js";
+import "./chunk-JWAJ4XPK.js";
 import {
   run,
   streamExec
 } from "./chunk-UFGNO6CW.js";
-import "./chunk-6OI37OZX.js";
+import "./chunk-WHCJT7E2.js";
 import {
   log
 } from "./chunk-6DUFTBTO.js";

package/dist/index.js

@@ -13,24 +13,32 @@ var program = new Command();
 program.name("cf").description(
   "coding-friend CLI \u2014 host learning docs, setup MCP, init projects"
 ).version(pkg.version, "-v, --version");
+program.command("install").description("Install the Coding Friend plugin into Claude Code").action(async () => {
+  const { installCommand } = await import("./install-BEFMUMKE.js");
+  await installCommand();
+});
+program.command("uninstall").description("Uninstall the Coding Friend plugin from Claude Code").action(async () => {
+  const { uninstallCommand } = await import("./uninstall-BHYS52L3.js");
+  await uninstallCommand();
+});
 program.command("init").description("Initialize coding-friend in current project").action(async () => {
-  const { initCommand } = await import("./init-CTCDQKIQ.js");
+  const { initCommand } = await import("./init-K4EVPAHK.js");
   await initCommand();
 });
 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-2WINWEW7.js");
+  const { hostCommand } = await import("./host-VR5POAVU.js");
   await hostCommand(path, opts);
 });
 program.command("mcp").description("Setup MCP server for learning docs").argument("[path]", "path to docs folder").action(async (path) => {
-  const { mcpCommand } = await import("./mcp-43HCE2KD.js");
+  const { mcpCommand } = await import("./mcp-JCQUGUPJ.js");
   await mcpCommand(path);
 });
 program.command("statusline").description("Setup coding-friend statusline in Claude Code").action(async () => {
-  const { statuslineCommand } = await import("./statusline-ARI7I5YM.js");
+  const { statuslineCommand } = await import("./statusline-3MQQDRCI.js");
   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").action(async (opts) => {
-  const { updateCommand } = await import("./update-GGCBM7U4.js");
+  const { updateCommand } = await import("./update-TALQ7TAO.js");
   await updateCommand(opts);
 });
 var dev = program.command("dev").description("Development mode commands");
@@ -45,28 +53,28 @@ Dev subcommands:
   dev restart [path]  Reinstall local dev plugin (off + on)`
 );
 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-VMN2JHA6.js");
+  const { devOnCommand } = await import("./dev-WINMWRZK.js");
   await devOnCommand(path);
 });
 dev.command("off").description("Switch back to remote marketplace").action(async () => {
-  const { devOffCommand } = await import("./dev-VMN2JHA6.js");
+  const { devOffCommand } = await import("./dev-WINMWRZK.js");
   await devOffCommand();
 });
 dev.command("status").description("Show current dev mode").action(async () => {
-  const { devStatusCommand } = await import("./dev-VMN2JHA6.js");
+  const { devStatusCommand } = await import("./dev-WINMWRZK.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-VMN2JHA6.js");
+  const { devSyncCommand } = await import("./dev-WINMWRZK.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-VMN2JHA6.js");
+  const { devRestartCommand } = await import("./dev-WINMWRZK.js");
   await devRestartCommand(path);
 });
 program.parse();

package/dist/{init-CTCDQKIQ.js → init-K4EVPAHK.js}

@@ -1,10 +1,17 @@
 import {
-  DEFAULT_CONFIG
-} from "./chunk-HRVSKMNA.js";
+  findStatuslineHookPath,
+  isStatuslineConfigured,
+  saveStatuslineConfig,
+  selectStatuslineComponents,
+  writeStatuslineSettings
+} from "./chunk-5OALHHKR.js";
 import {
   ensureShellCompletion,
   hasShellCompletion
-} from "./chunk-CSF4FAHL.js";
+} from "./chunk-DDISNOEK.js";
+import {
+  DEFAULT_CONFIG
+} from "./chunk-JWAJ4XPK.js";
 import {
   run
 } from "./chunk-UFGNO6CW.js";
@@ -13,7 +20,7 @@ import {
   globalConfigPath,
   localConfigPath,
   resolvePath
-} from "./chunk-6OI37OZX.js";
+} from "./chunk-WHCJT7E2.js";
 import {
   log
 } from "./chunk-6DUFTBTO.js";
@@ -338,6 +345,11 @@ async function initCommand() {
       name: "completion",
       label: "Setup shell tab completion",
       done: hasShellCompletion()
+    },
+    {
+      name: "statusline",
+      label: "Configure statusline",
+      done: isStatuslineConfigured()
     }
   ];
   if (hasExternalDir && resolvedOutputDir) {
@@ -417,6 +429,20 @@ async function initCommand() {
       case "completion":
         ensureShellCompletion();
         break;
+      case "statusline": {
+        const hookResult = findStatuslineHookPath();
+        if (!hookResult) {
+          log.warn(
+            "coding-friend plugin not found. Install it via Claude Code first, then re-run."
+          );
+          break;
+        }
+        const components = await selectStatuslineComponents();
+        saveStatuslineConfig(components);
+        writeStatuslineSettings(hookResult.hookPath);
+        log.success("Statusline configured!");
+        break;
+      }
       case "permissions":
         if (resolvedOutputDir) {
           await setupClaudePermissions(resolvedOutputDir, learnAutoCommit);

package/dist/install-BEFMUMKE.js

@@ -0,0 +1,93 @@
+import {
+  getInstalledVersion,
+  getLatestVersion,
+  semverCompare
+} from "./chunk-GTTSBOHM.js";
+import {
+  isMarketplaceRegistered
+} from "./chunk-MRTR7TJ4.js";
+import "./chunk-DDISNOEK.js";
+import {
+  commandExists,
+  run
+} from "./chunk-UFGNO6CW.js";
+import "./chunk-WHCJT7E2.js";
+import {
+  log
+} from "./chunk-6DUFTBTO.js";
+import "./chunk-IUTXHCP7.js";
+
+// src/commands/install.ts
+import chalk from "chalk";
+async function installCommand() {
+  console.log("=== \u{1F33F} Coding Friend Install \u{1F33F} ===");
+  console.log();
+  if (!commandExists("claude")) {
+    log.error(
+      "Claude CLI not found. Install it first: https://docs.anthropic.com/en/docs/claude-code/getting-started"
+    );
+    process.exit(1);
+  }
+  if (isMarketplaceRegistered()) {
+    log.success("Marketplace already registered.");
+  } else {
+    log.step("Adding coding-friend marketplace...");
+    const result = run("claude", [
+      "plugin",
+      "marketplace",
+      "add",
+      "dinhanhthi/coding-friend"
+    ]);
+    if (result === null) {
+      log.error(
+        "Failed to add marketplace. Try manually: claude plugin marketplace add dinhanhthi/coding-friend"
+      );
+      process.exit(1);
+    }
+    log.success("Marketplace added.");
+  }
+  const installedVersion = getInstalledVersion();
+  if (!installedVersion) {
+    log.step("Installing plugin...");
+    const result = run("claude", [
+      "plugin",
+      "install",
+      "coding-friend@coding-friend-marketplace"
+    ]);
+    if (result === null) {
+      log.error(
+        "Failed to install plugin. Try manually: claude plugin install coding-friend@coding-friend-marketplace"
+      );
+      process.exit(1);
+    }
+    log.success("Plugin installed!");
+  } else {
+    log.success(
+      `Plugin already installed (${chalk.green(`v${installedVersion}`)}).`
+    );
+    const latestVersion = getLatestVersion();
+    if (latestVersion) {
+      const cmp = semverCompare(installedVersion, latestVersion);
+      if (cmp < 0) {
+        log.warn(
+          `Update available: ${chalk.yellow(`v${installedVersion}`)} \u2192 ${chalk.green(`v${latestVersion}`)}. Run ${chalk.cyan("cf update")} to update.`
+        );
+      } else {
+        log.success("Already on the latest version.");
+      }
+    } else {
+      log.dim("Could not check for updates (no network or GitHub rate limit).");
+    }
+  }
+  console.log();
+  log.info("Next steps:");
+  log.dim(
+    `  ${chalk.cyan("cf init")}         Initialize workspace (docs folders, config)`
+  );
+  log.dim(`  ${chalk.cyan("cf statusline")}   Setup statusline in Claude Code`);
+  console.log();
+  log.dim("Restart Claude Code (or start a new session) to use the plugin.");
+}
+export {
+  installCommand
+};

package/dist/{mcp-43HCE2KD.js → mcp-JCQUGUPJ.js}

@@ -1,12 +1,12 @@
 import {
   getLibPath,
   resolveDocsDir
-} from "./chunk-Q4DKU5IG.js";
-import "./chunk-HRVSKMNA.js";
+} from "./chunk-X645ACZJ.js";
+import "./chunk-JWAJ4XPK.js";
 import {
   run
 } from "./chunk-UFGNO6CW.js";
-import "./chunk-6OI37OZX.js";
+import "./chunk-WHCJT7E2.js";
 import {
   log
 } from "./chunk-6DUFTBTO.js";

package/dist/postinstall.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   ensureShellCompletion
-} from "./chunk-CSF4FAHL.js";
+} from "./chunk-DDISNOEK.js";
 import "./chunk-6DUFTBTO.js";
 
 // src/postinstall.ts

package/dist/statusline-3MQQDRCI.js

@@ -0,0 +1,55 @@
+import {
+  findStatuslineHookPath,
+  isStatuslineConfigured,
+  saveStatuslineConfig,
+  selectStatuslineComponents,
+  writeStatuslineSettings
+} from "./chunk-5OALHHKR.js";
+import {
+  ALL_COMPONENT_IDS
+} from "./chunk-JWAJ4XPK.js";
+import "./chunk-WHCJT7E2.js";
+import {
+  log
+} from "./chunk-6DUFTBTO.js";
+import "./chunk-IUTXHCP7.js";
+
+// src/commands/statusline.ts
+import { confirm } from "@inquirer/prompts";
+import chalk from "chalk";
+async function statuslineCommand() {
+  console.log("=== \u{1F33F} Coding Friend Statusline \u{1F33F} ===");
+  console.log();
+  const result = findStatuslineHookPath();
+  if (!result) {
+    log.error(
+      "coding-friend plugin not found in cache. Install it first via Claude Code."
+    );
+    return;
+  }
+  log.info(`Found plugin ${chalk.green(`v${result.version}`)}`);
+  if (isStatuslineConfigured()) {
+    log.warn("Statusline already configured.");
+    const overwrite = await confirm({
+      message: "Reconfigure statusline?",
+      default: true
+    });
+    if (!overwrite) {
+      log.dim("Skipped.");
+      return;
+    }
+  }
+  const components = await selectStatuslineComponents();
+  saveStatuslineConfig(components);
+  writeStatuslineSettings(result.hookPath);
+  log.success("Statusline configured!");
+  log.dim("Restart Claude Code (or start a new session) to see it.");
+  if (components.length < ALL_COMPONENT_IDS.length) {
+    log.dim(`Showing: ${components.join(", ")}`);
+  } else {
+    log.dim("Showing all components.");
+  }
+}
+export {
+  statuslineCommand
+};