coding-friend-cli 1.10.0 → 1.11.0

package/README.md

@@ -16,10 +16,18 @@ 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 install              # Install plugin (interactive scope chooser)
+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)
+                        # 💡 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
+                        # 💡 Interactive — asks for confirmation before acting.
 cf init              # Initialize workspace (interactive)
                      # 💡 You can run this anywhere, anytime.
 cf config            # Manage Coding Friend configuration (interactive menu)
@@ -32,10 +40,12 @@ cf mcp [path]        # Setup MCP server for LLM integration
 cf permission        # Manage Claude Code permission rules for Coding Friend
 cf permission --all  # Apply all recommended permissions without prompts
 cf statusline        # Setup coding-friend statusline
-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               # 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 --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
 cf dev off           # Switch back to remote marketplace
 cf dev status        # Show current dev mode (local or remote)

package/dist/{chunk-BCYBFGVD.js → chunk-4JL3SR5V.js}

@@ -22,6 +22,8 @@ _cf_completions() {
   local cur="\${COMP_WORDS[COMP_CWORD]}"
   local prev="\${COMP_WORDS[COMP_CWORD-1]}"
   local commands="install uninstall init config host mcp permission statusline update dev session"
+  local scope_flags="--user --global --project --local"
+  local update_flags="--cli --plugin --statusline --user --global --project --local"
 
   # Subcommands for 'dev'
   if [[ "\${COMP_WORDS[1]}" == "dev" && \${COMP_CWORD} -eq 2 ]]; then
@@ -41,6 +43,18 @@ _cf_completions() {
     return
   fi
 
+  # Flag completion for install/uninstall
+  if [[ "\${COMP_WORDS[1]}" == "install" || "\${COMP_WORDS[1]}" == "uninstall" ]] && [[ "$cur" == -* ]]; then
+    COMPREPLY=($(compgen -W "$scope_flags" -- "$cur"))
+    return
+  fi
+
+  # Flag completion for update
+  if [[ "\${COMP_WORDS[1]}" == "update" && "$cur" == -* ]]; then
+    COMPREPLY=($(compgen -W "$update_flags" -- "$cur"))
+    return
+  fi
+
   COMPREPLY=($(compgen -W "$commands" -- "$cur"))
 }
 complete -o default -F _cf_completions cf
@@ -62,8 +76,31 @@ var ZSH_FUNCTION_BODY = `_cf() {
     'session:Save and load Claude Code sessions across machines'
   )
 
+  local -a scope_flags
+  scope_flags=(
+    '--user[Install at user scope (all projects)]'
+    '--global[Install at user scope (all projects)]'
+    '--project[Install at project scope (shared via git)]'
+    '--local[Install at local scope (this machine only)]'
+  )
+
+  local -a update_flags
+  update_flags=(
+    '--cli[Update only the CLI (npm package)]'
+    '--plugin[Update only the Claude Code plugin]'
+    '--statusline[Update only the statusline]'
+    '--user[Update plugin at user scope (all projects)]'
+    '--global[Update plugin at user scope (all projects)]'
+    '--project[Update plugin at project scope]'
+    '--local[Update plugin at local scope]'
+  )
+
   if (( CURRENT == 2 )); then
     _describe 'command' commands
+  elif (( CURRENT >= 3 )) && [[ "\${words[2]}" == "install" || "\${words[2]}" == "uninstall" ]]; then
+    _values 'flags' $scope_flags
+  elif (( CURRENT >= 3 )) && [[ "\${words[2]}" == "update" ]]; then
+    _values 'flags' $update_flags
   elif (( CURRENT == 3 )) && [[ "\${words[2]}" == "dev" ]]; then
     local -a subcommands
     subcommands=(
@@ -109,12 +146,27 @@ complete -c cf -n "__fish_use_subcommand" -a statusline -d "Setup coding-friend
 complete -c cf -n "__fish_use_subcommand" -a update -d "Update coding-friend plugin and refresh statusline"
 complete -c cf -n "__fish_use_subcommand" -a dev -d "Switch between local and remote plugin for development"
 complete -c cf -n "__fish_use_subcommand" -a session -d "Save and load Claude Code sessions across machines"
+# Scope flags for install/uninstall
+complete -c cf -n "__fish_seen_subcommand_from install uninstall" -l user -d "User scope (all projects)"
+complete -c cf -n "__fish_seen_subcommand_from install uninstall" -l global -d "User scope (all projects)"
+complete -c cf -n "__fish_seen_subcommand_from install uninstall" -l project -d "Project scope (shared via git)"
+complete -c cf -n "__fish_seen_subcommand_from install uninstall" -l local -d "Local scope (this machine only)"
+# Flags for update
+complete -c cf -n "__fish_seen_subcommand_from update" -l cli -d "Update only the CLI"
+complete -c cf -n "__fish_seen_subcommand_from update" -l plugin -d "Update only the plugin"
+complete -c cf -n "__fish_seen_subcommand_from update" -l statusline -d "Update only the statusline"
+complete -c cf -n "__fish_seen_subcommand_from update" -l user -d "User scope (all projects)"
+complete -c cf -n "__fish_seen_subcommand_from update" -l global -d "User scope (all projects)"
+complete -c cf -n "__fish_seen_subcommand_from update" -l project -d "Project scope"
+complete -c cf -n "__fish_seen_subcommand_from update" -l local -d "Local scope"
+# Dev subcommands
 complete -c cf -n "__fish_seen_subcommand_from dev" -a on -d "Switch to local plugin source"
 complete -c cf -n "__fish_seen_subcommand_from dev" -a off -d "Switch back to remote marketplace"
 complete -c cf -n "__fish_seen_subcommand_from dev" -a status -d "Show current dev mode"
 complete -c cf -n "__fish_seen_subcommand_from dev" -a restart -d "Restart dev mode"
 complete -c cf -n "__fish_seen_subcommand_from dev" -a sync -d "Sync local plugin files"
 complete -c cf -n "__fish_seen_subcommand_from dev" -a update -d "Update local dev plugin"
+# Session subcommands
 complete -c cf -n "__fish_seen_subcommand_from session" -a save -d "Save current session to docs/sessions/"
 complete -c cf -n "__fish_seen_subcommand_from session" -a load -d "Load a saved session from docs/sessions/"
 `;
@@ -126,6 +178,8 @@ Register-ArgumentCompleter -Native -CommandName cf -ScriptBlock {
   $commands = @('install','uninstall','init','config','host','mcp','permission','statusline','update','dev','session')
   $devSubcommands = @('on','off','status','restart','sync','update')
   $sessionSubcommands = @('save','load')
+  $scopeFlags = @('--user','--global','--project','--local')
+  $updateFlags = @('--cli','--plugin','--statusline','--user','--global','--project','--local')
   $words = $commandAst.CommandElements
   if ($words.Count -ge 2 -and $words[1].ToString() -eq 'dev') {
     $devSubcommands | Where-Object { $_ -like "$wordToComplete*" } |
@@ -133,6 +187,12 @@ Register-ArgumentCompleter -Native -CommandName cf -ScriptBlock {
   } elseif ($words.Count -ge 2 -and $words[1].ToString() -eq 'session') {
     $sessionSubcommands | Where-Object { $_ -like "$wordToComplete*" } |
       ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
+  } elseif ($words.Count -ge 2 -and ($words[1].ToString() -eq 'install' -or $words[1].ToString() -eq 'uninstall')) {
+    $scopeFlags | Where-Object { $_ -like "$wordToComplete*" } |
+      ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
+  } elseif ($words.Count -ge 2 -and $words[1].ToString() -eq 'update') {
+    $updateFlags | Where-Object { $_ -like "$wordToComplete*" } |
+      ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
   } else {
     $commands | Where-Object { $_ -like "$wordToComplete*" } |
       ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }

package/dist/{chunk-TLLWOWYU.js → chunk-E2XX5MIM.js}

@@ -2,7 +2,7 @@ import {
   installedPluginsPath,
   knownMarketplacesPath,
   readJson
-} from "./chunk-HQ5BPWEV.js";
+} from "./chunk-ZS7BLEYT.js";
 
 // src/lib/plugin-state.ts
 var MARKETPLACE_NAME = "coding-friend-marketplace";

package/dist/{chunk-4C4EKYM3.js → chunk-EL6BAAKL.js}

@@ -1,7 +1,7 @@
 import {
   readJson,
   writeJson
-} from "./chunk-HQ5BPWEV.js";
+} from "./chunk-ZS7BLEYT.js";
 
 // src/lib/permissions.ts
 var PERMISSION_RULES = [

package/dist/{chunk-AHGBESGW.js → chunk-GJLNN6X5.js}

@@ -5,7 +5,7 @@ import {
   globalConfigPath,
   localConfigPath,
   readJson
-} from "./chunk-HQ5BPWEV.js";
+} from "./chunk-ZS7BLEYT.js";
 import {
   log
 } from "./chunk-W5CD7WTX.js";
@@ -33,6 +33,51 @@ async function askScope(label = "Save to:") {
     ]
   });
 }
+async function askPluginScope() {
+  return select({
+    message: "Where should the plugin be installed?",
+    choices: [
+      {
+        name: "User / Global \u2014 available in all projects",
+        value: "user"
+      },
+      {
+        name: "Project \u2014 shared with team via .claude/settings.json",
+        value: "project"
+      },
+      {
+        name: "Local \u2014 this machine only, not shared (gitignored)",
+        value: "local"
+      }
+    ]
+  });
+}
+async function resolveScope(opts) {
+  const flags = [
+    { key: "user", scope: "user" },
+    { key: "global", scope: "user" },
+    { key: "project", scope: "project" },
+    { key: "local", scope: "local" }
+  ];
+  const active = flags.filter((f) => opts[f.key] === true);
+  const uniqueScopes = new Set(active.map((f) => f.scope));
+  if (uniqueScopes.size > 1) {
+    log.error(
+      "Only one scope flag can be used at a time: --user, --global, --project, or --local"
+    );
+    process.exit(1);
+  }
+  if (uniqueScopes.size === 1) {
+    return active[0].scope;
+  }
+  if (!process.stdin.isTTY) {
+    log.error(
+      "No scope flag provided and stdin is not interactive. Use --user (or --global), --project, or --local."
+    );
+    process.exit(1);
+  }
+  return askPluginScope();
+}
 function showConfigHint() {
   console.log(chalk.dim("Config files:"));
   console.log(chalk.dim("  Global: ~/.coding-friend/config.json"));
@@ -127,6 +172,7 @@ export {
   BACK,
   injectBackChoice,
   askScope,
+  resolveScope,
   showConfigHint,
   getScopeLabel,
   formatScopeLabel,

package/dist/{chunk-YAOUAJZP.js → chunk-HYLS67T7.js}

@@ -10,7 +10,7 @@ import {
   pluginCachePath,
   readJson,
   writeJson
-} from "./chunk-HQ5BPWEV.js";
+} from "./chunk-ZS7BLEYT.js";
 
 // src/lib/statusline.ts
 import { existsSync, readdirSync } from "fs";

package/dist/{chunk-UR5XUEH5.js → chunk-RN5UYDIT.js}

@@ -1,10 +1,13 @@
 import {
   ensureStatusline,
   getInstalledVersion
-} from "./chunk-YAOUAJZP.js";
+} from "./chunk-HYLS67T7.js";
+import {
+  resolveScope
+} from "./chunk-GJLNN6X5.js";
 import {
   ensureShellCompletion
-} from "./chunk-BCYBFGVD.js";
+} from "./chunk-4JL3SR5V.js";
 import {
   commandExists,
   run,
@@ -13,7 +16,7 @@ import {
 import {
   claudeSettingsPath,
   readJson
-} from "./chunk-HQ5BPWEV.js";
+} from "./chunk-ZS7BLEYT.js";
 import {
   log
 } from "./chunk-W5CD7WTX.js";
@@ -86,6 +89,13 @@ async function updateCommand(opts) {
   const doCli = updateAll || !!opts.cli;
   const doPlugin = updateAll || !!opts.plugin;
   const doStatusline = updateAll || !!opts.statusline;
+  const hasScopeFlag = !!(opts.user || opts.global || opts.project || opts.local);
+  let scope;
+  if (doPlugin && hasScopeFlag) {
+    scope = await resolveScope(opts);
+  } else if (doPlugin && !hasScopeFlag) {
+    scope = "user";
+  }
   console.log("=== \u{1F33F} Coding Friend Update \u{1F33F} ===");
   console.log();
   const currentVersion = getInstalledVersion();
@@ -135,12 +145,18 @@ async function updateCommand(opts) {
             "Claude CLI not found. Install it first, or run: claude plugin update coding-friend@coding-friend-marketplace"
           );
         } else {
-          log.step("Updating plugin...");
-          const result = run("claude", [
+          log.step(
+            `Updating plugin${scope && scope !== "user" ? ` (${scope} scope)` : ""}...`
+          );
+          const updateArgs = [
             "plugin",
             "update",
             "coding-friend@coding-friend-marketplace"
-          ]);
+          ];
+          if (scope) {
+            updateArgs.push("--scope", scope);
+          }
+          const result = run("claude", updateArgs);
           if (result === null) {
             log.error(
               "Plugin update failed. Try manually: claude plugin update coding-friend@coding-friend-marketplace"

package/dist/{chunk-EDVZPZ3B.js → chunk-XIZJ64JK.js}

@@ -6,7 +6,7 @@ import {
   localConfigPath,
   readJson,
   resolvePath
-} from "./chunk-HQ5BPWEV.js";
+} from "./chunk-ZS7BLEYT.js";
 
 // src/lib/config.ts
 function loadConfig() {

package/dist/{chunk-HQ5BPWEV.js → chunk-ZS7BLEYT.js}

@@ -1,26 +1,3 @@
-// src/lib/json.ts
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
-import { dirname } from "path";
-function readJson(filePath) {
-  try {
-    const content = readFileSync(filePath, "utf-8");
-    return JSON.parse(content);
-  } catch {
-    return null;
-  }
-}
-function writeJson(filePath, data) {
-  const dir = dirname(filePath);
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true });
-  }
-  writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n", "utf-8");
-}
-function mergeJson(filePath, data) {
-  const existing = readJson(filePath) ?? {};
-  writeJson(filePath, { ...existing, ...data });
-}
-
 // src/lib/paths.ts
 import { homedir } from "os";
 import { resolve, join } from "path";
@@ -91,10 +68,30 @@ function claudeSessionDir(encodedPath) {
   return join(claudeProjectsDir(), encodedPath);
 }
 
+// src/lib/json.ts
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { dirname } from "path";
+function readJson(filePath) {
+  try {
+    const content = readFileSync(filePath, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+function writeJson(filePath, data) {
+  const dir = dirname(filePath);
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n", "utf-8");
+}
+function mergeJson(filePath, data) {
+  const existing = readJson(filePath) ?? {};
+  writeJson(filePath, { ...existing, ...data });
+}
+
 export {
-  readJson,
-  writeJson,
-  mergeJson,
   resolvePath,
   localConfigPath,
   globalConfigPath,
@@ -108,5 +105,8 @@ export {
   marketplaceClonePath,
   globalConfigDir,
   encodeProjectPath,
-  claudeSessionDir
+  claudeSessionDir,
+  readJson,
+  writeJson,
+  mergeJson
 };

package/dist/{config-6P3SE3NS.js → config-GYJGDXGV.js}

@@ -1,3 +1,10 @@
+import {
+  findStatuslineHookPath,
+  isStatuslineConfigured,
+  saveStatuslineConfig,
+  selectStatuslineComponents,
+  writeStatuslineSettings
+} from "./chunk-HYLS67T7.js";
 import {
   BACK,
   applyDocsDirChange,
@@ -7,19 +14,12 @@ import {
   getScopeLabel,
   injectBackChoice,
   showConfigHint
-} from "./chunk-AHGBESGW.js";
-import {
-  findStatuslineHookPath,
-  isStatuslineConfigured,
-  saveStatuslineConfig,
-  selectStatuslineComponents,
-  writeStatuslineSettings
-} from "./chunk-YAOUAJZP.js";
+} from "./chunk-GJLNN6X5.js";
 import {
   ensureShellCompletion,
   hasShellCompletion,
   removeShellCompletion
-} from "./chunk-BCYBFGVD.js";
+} from "./chunk-4JL3SR5V.js";
 import {
   ALL_COMPONENT_IDS,
   DEFAULT_CONFIG
@@ -33,7 +33,7 @@ import {
   mergeJson,
   readJson,
   resolvePath
-} from "./chunk-HQ5BPWEV.js";
+} from "./chunk-ZS7BLEYT.js";
 import {
   log
 } from "./chunk-W5CD7WTX.js";

package/dist/{dev-4NLCK6YG.js → dev-GFFXRZJC.js}

@@ -1,13 +1,13 @@
 import {
   isMarketplaceRegistered,
   isPluginInstalled
-} from "./chunk-TLLWOWYU.js";
+} from "./chunk-E2XX5MIM.js";
 import {
   ensureStatusline
-} from "./chunk-YAOUAJZP.js";
+} from "./chunk-HYLS67T7.js";
 import {
   ensureShellCompletion
-} from "./chunk-BCYBFGVD.js";
+} from "./chunk-4JL3SR5V.js";
 import "./chunk-PGLUEN7D.js";
 import {
   commandExists,
@@ -19,7 +19,7 @@ import {
   pluginCachePath,
   readJson,
   writeJson
-} from "./chunk-HQ5BPWEV.js";
+} from "./chunk-ZS7BLEYT.js";
 import {
   log
 } from "./chunk-W5CD7WTX.js";

package/dist/{host-BPO2STZA.js → host-SWIWQRRL.js}

@@ -3,13 +3,13 @@ import {
 } from "./chunk-RZRT7NGT.js";
 import {
   resolveDocsDir
-} from "./chunk-EDVZPZ3B.js";
+} from "./chunk-XIZJ64JK.js";
 import "./chunk-PGLUEN7D.js";
 import {
   run,
   streamExec
 } from "./chunk-UFGNO6CW.js";
-import "./chunk-HQ5BPWEV.js";
+import "./chunk-ZS7BLEYT.js";
 import {
   log
 } from "./chunk-W5CD7WTX.js";

package/dist/index.js

@@ -13,40 +13,40 @@ 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-YEAWW7ZX.js");
-  await installCommand();
+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-FQTMSBGK.js");
+  await installCommand(opts);
 });
-program.command("uninstall").description("Uninstall the Coding Friend plugin from Claude Code").action(async () => {
-  const { uninstallCommand } = await import("./uninstall-3ISPGQHE.js");
-  await uninstallCommand();
+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) => {
+  const { uninstallCommand } = await import("./uninstall-A2LJR2OD.js");
+  await uninstallCommand(opts);
 });
 program.command("init").description("Initialize coding-friend in current project").action(async () => {
-  const { initCommand } = await import("./init-BG2ESQQC.js");
+  const { initCommand } = await import("./init-QRUDHFME.js");
   await initCommand();
 });
 program.command("config").description("Manage Coding Friend configuration").action(async () => {
-  const { configCommand } = await import("./config-6P3SE3NS.js");
+  const { configCommand } = await import("./config-GYJGDXGV.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-BPO2STZA.js");
+  const { hostCommand } = await import("./host-SWIWQRRL.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-54UB5MF2.js");
+  const { mcpCommand } = await import("./mcp-H3K67N2P.js");
   await mcpCommand(path);
 });
 program.command("permission").description("Manage Claude Code permission rules for Coding Friend").option("--all", "Apply all recommended permissions without prompts").action(async (opts) => {
-  const { permissionCommand } = await import("./permission-GPOUJUZS.js");
+  const { permissionCommand } = await import("./permission-DIJMCOZX.js");
   await permissionCommand(opts);
 });
 program.command("statusline").description("Setup coding-friend statusline in Claude Code").action(async () => {
-  const { statuslineCommand } = await import("./statusline-L2CYEV4H.js");
+  const { statuslineCommand } = await import("./statusline-H2WUKOJ6.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-EN6S3FKT.js");
+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-RJSWHCCR.js");
   await updateCommand(opts);
 });
 var session = program.command("session").description("Save and load Claude Code sessions across machines");
@@ -61,11 +61,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-STYOO4A4.js");
+  const { sessionSaveCommand } = await import("./session-2APBPDZF.js");
   await sessionSaveCommand(opts);
 });
 session.command("load").description("Load a saved session from sync folder").action(async () => {
-  const { sessionLoadCommand } = await import("./session-STYOO4A4.js");
+  const { sessionLoadCommand } = await import("./session-2APBPDZF.js");
   await sessionLoadCommand();
 });
 var dev = program.command("dev").description("Development mode commands");
@@ -81,35 +81,35 @@ 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-4NLCK6YG.js");
+  const { devOnCommand } = await import("./dev-GFFXRZJC.js");
   await devOnCommand(path);
 });
 dev.command("off").description("Switch back to remote marketplace").action(async () => {
-  const { devOffCommand } = await import("./dev-4NLCK6YG.js");
+  const { devOffCommand } = await import("./dev-GFFXRZJC.js");
   await devOffCommand();
 });
 dev.command("status").description("Show current dev mode").action(async () => {
-  const { devStatusCommand } = await import("./dev-4NLCK6YG.js");
+  const { devStatusCommand } = await import("./dev-GFFXRZJC.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-4NLCK6YG.js");
+  const { devSyncCommand } = await import("./dev-GFFXRZJC.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-4NLCK6YG.js");
+  const { devRestartCommand } = await import("./dev-GFFXRZJC.js");
   await devRestartCommand(path);
 });
 dev.command("update").description("Update local dev plugin to latest version (off + on)").argument(
   "[path]",
   "path to local coding-friend repo (default: saved path or cwd)"
 ).action(async (path) => {
-  const { devUpdateCommand } = await import("./dev-4NLCK6YG.js");
+  const { devUpdateCommand } = await import("./dev-GFFXRZJC.js");
   await devUpdateCommand(path);
 });
 program.parse();

package/dist/{init-BG2ESQQC.js → init-QRUDHFME.js}

@@ -3,7 +3,14 @@ import {
   buildLearnDirRules,
   getExistingRules,
   getMissingRules
-} from "./chunk-4C4EKYM3.js";
+} from "./chunk-EL6BAAKL.js";
+import {
+  findStatuslineHookPath,
+  isStatuslineConfigured,
+  saveStatuslineConfig,
+  selectStatuslineComponents,
+  writeStatuslineSettings
+} from "./chunk-HYLS67T7.js";
 import {
   BACK,
   applyDocsDirChange,
@@ -13,18 +20,11 @@ import {
   getScopeLabel,
   injectBackChoice,
   showConfigHint
-} from "./chunk-AHGBESGW.js";
-import {
-  findStatuslineHookPath,
-  isStatuslineConfigured,
-  saveStatuslineConfig,
-  selectStatuslineComponents,
-  writeStatuslineSettings
-} from "./chunk-YAOUAJZP.js";
+} from "./chunk-GJLNN6X5.js";
 import {
   ensureShellCompletion,
   hasShellCompletion
-} from "./chunk-BCYBFGVD.js";
+} from "./chunk-4JL3SR5V.js";
 import {
   DEFAULT_CONFIG
 } from "./chunk-PGLUEN7D.js";
@@ -38,7 +38,7 @@ import {
   mergeJson,
   readJson,
   resolvePath
-} from "./chunk-HQ5BPWEV.js";
+} from "./chunk-ZS7BLEYT.js";
 import {
   log
 } from "./chunk-W5CD7WTX.js";

package/dist/{install-YEAWW7ZX.js → install-FQTMSBGK.js}

@@ -1,27 +1,35 @@
 import {
   getLatestVersion,
   semverCompare
-} from "./chunk-UR5XUEH5.js";
+} from "./chunk-RN5UYDIT.js";
 import {
   isMarketplaceRegistered
-} from "./chunk-TLLWOWYU.js";
+} from "./chunk-E2XX5MIM.js";
 import {
   getInstalledVersion
-} from "./chunk-YAOUAJZP.js";
-import "./chunk-BCYBFGVD.js";
+} from "./chunk-HYLS67T7.js";
+import {
+  resolveScope
+} from "./chunk-GJLNN6X5.js";
+import {
+  ensureShellCompletion
+} from "./chunk-4JL3SR5V.js";
 import "./chunk-PGLUEN7D.js";
 import {
   commandExists,
   run
 } from "./chunk-UFGNO6CW.js";
-import "./chunk-HQ5BPWEV.js";
+import {
+  devStatePath
+} from "./chunk-ZS7BLEYT.js";
 import {
   log
 } from "./chunk-W5CD7WTX.js";
 
 // src/commands/install.ts
+import { existsSync } from "fs";
 import chalk from "chalk";
-async function installCommand() {
+async function installCommand(opts = {}) {
   console.log("=== \u{1F33F} Coding Friend Install \u{1F33F} ===");
   console.log();
   if (!commandExists("claude")) {
@@ -30,6 +38,14 @@ async function installCommand() {
     );
     process.exit(1);
   }
+  if (existsSync(devStatePath())) {
+    log.warn("Dev mode is currently active.");
+    log.dim(
+      `Run ${chalk.bold("cf dev off")} first, then install. Or use ${chalk.bold("cf dev sync")} to update the dev plugin.`
+    );
+    return;
+  }
+  const scope = await resolveScope(opts);
   if (isMarketplaceRegistered()) {
     log.success("Marketplace already registered.");
   } else {
@@ -49,12 +65,14 @@ async function installCommand() {
     log.success("Marketplace added.");
   }
   const installedVersion = getInstalledVersion();
-  if (!installedVersion) {
-    log.step("Installing plugin...");
+  if (!installedVersion || scope !== "user") {
+    log.step(`Installing plugin (${chalk.cyan(scope)} scope)...`);
     const result = run("claude", [
       "plugin",
       "install",
-      "coding-friend@coding-friend-marketplace"
+      "coding-friend@coding-friend-marketplace",
+      "--scope",
+      scope
     ]);
     if (result === null) {
       log.error(
@@ -81,12 +99,15 @@ async function installCommand() {
       log.dim("Could not check for updates (no network or GitHub rate limit).");
     }
   }
+  ensureShellCompletion({ silent: false });
   console.log();
   log.info("Next steps:");
-  log.dim(
+  console.log(
     `  ${chalk.cyan("cf init")}         Initialize workspace (docs folders, config)`
   );
-  log.dim(`  ${chalk.cyan("cf statusline")}   Setup statusline in Claude Code`);
+  console.log(
+    `  ${chalk.cyan("cf statusline")}   Setup statusline in Claude Code to show more real-time info`
+  );
   console.log();
   log.dim("Restart Claude Code (or start a new session) to use the plugin.");
 }

package/dist/{mcp-54UB5MF2.js → mcp-H3K67N2P.js}

@@ -3,12 +3,12 @@ import {
 } from "./chunk-RZRT7NGT.js";
 import {
   resolveDocsDir
-} from "./chunk-EDVZPZ3B.js";
+} from "./chunk-XIZJ64JK.js";
 import "./chunk-PGLUEN7D.js";
 import {
   run
 } from "./chunk-UFGNO6CW.js";
-import "./chunk-HQ5BPWEV.js";
+import "./chunk-ZS7BLEYT.js";
 import {
   log
 } from "./chunk-W5CD7WTX.js";

package/dist/{permission-GPOUJUZS.js → permission-DIJMCOZX.js}

@@ -3,10 +3,10 @@ import {
   applyPermissions,
   getExistingRules,
   groupByCategory
-} from "./chunk-4C4EKYM3.js";
+} from "./chunk-EL6BAAKL.js";
 import {
   claudeLocalSettingsPath
-} from "./chunk-HQ5BPWEV.js";
+} from "./chunk-ZS7BLEYT.js";
 import {
   log
 } from "./chunk-W5CD7WTX.js";

package/dist/postinstall.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   ensureShellCompletion
-} from "./chunk-BCYBFGVD.js";
+} from "./chunk-4JL3SR5V.js";
 import "./chunk-W5CD7WTX.js";
 
 // src/postinstall.ts

package/dist/{session-STYOO4A4.js → session-2APBPDZF.js}

@@ -1,13 +1,14 @@
 import {
   loadConfig
-} from "./chunk-EDVZPZ3B.js";
+} from "./chunk-XIZJ64JK.js";
 import "./chunk-PGLUEN7D.js";
 import {
   claudeSessionDir,
   encodeProjectPath,
   readJson,
+  resolvePath,
   writeJson
-} from "./chunk-HQ5BPWEV.js";
+} from "./chunk-ZS7BLEYT.js";
 import {
   log
 } from "./chunk-W5CD7WTX.js";
@@ -212,6 +213,7 @@ Remapped to:   ${remapped}`
     });
     localProjectPath = confirmed.trim() || remapped;
   }
+  localProjectPath = resolvePath(localProjectPath);
   loadSession(chosen, localProjectPath, docsDir);
   log.success(`Session "${chosen.label}" loaded.`);
   log.info(`To resume, run:`);

package/dist/{statusline-L2CYEV4H.js → statusline-H2WUKOJ6.js}

@@ -4,11 +4,11 @@ import {
   saveStatuslineConfig,
   selectStatuslineComponents,
   writeStatuslineSettings
-} from "./chunk-YAOUAJZP.js";
+} from "./chunk-HYLS67T7.js";
 import {
   ALL_COMPONENT_IDS
 } from "./chunk-PGLUEN7D.js";
-import "./chunk-HQ5BPWEV.js";
+import "./chunk-ZS7BLEYT.js";
 import {
   log
 } from "./chunk-W5CD7WTX.js";

package/dist/{uninstall-3ISPGQHE.js → uninstall-A2LJR2OD.js}

@@ -1,11 +1,14 @@
 import {
   isMarketplaceRegistered,
   isPluginInstalled
-} from "./chunk-TLLWOWYU.js";
+} from "./chunk-E2XX5MIM.js";
+import {
+  resolveScope
+} from "./chunk-GJLNN6X5.js";
 import {
   hasShellCompletion,
   removeShellCompletion
-} from "./chunk-BCYBFGVD.js";
+} from "./chunk-4JL3SR5V.js";
 import {
   commandExists,
   run
@@ -18,7 +21,7 @@ import {
   marketplaceClonePath,
   readJson,
   writeJson
-} from "./chunk-HQ5BPWEV.js";
+} from "./chunk-ZS7BLEYT.js";
 import {
   log
 } from "./chunk-W5CD7WTX.js";
@@ -76,7 +79,43 @@ function displayDetection(d) {
 function nothingToRemove(d) {
   return !d.pluginInstalled && !d.marketplaceRegistered && !d.cacheExists && !d.cloneExists && !d.statuslineConfigured && !d.shellCompletionExists && !d.globalConfigExists;
 }
-async function uninstallCommand() {
+async function uninstallScoped(scope) {
+  const proceed = await confirm({
+    message: `Uninstall Coding Friend from ${chalk.cyan(scope)} scope?`,
+    default: false
+  });
+  if (!proceed) {
+    log.info("Uninstall cancelled.");
+    return;
+  }
+  log.step(`Uninstalling plugin from ${scope} scope...`);
+  const result = run("claude", [
+    "plugin",
+    "uninstall",
+    PLUGIN_ID,
+    "--scope",
+    scope
+  ]);
+  if (result === null) {
+    const fallback = run("claude", [
+      "plugin",
+      "uninstall",
+      PLUGIN_NAME,
+      "--scope",
+      scope
+    ]);
+    if (fallback === null) {
+      log.warn(
+        "Could not uninstall plugin (may not be installed at this scope)."
+      );
+      return;
+    }
+  }
+  log.success(`Plugin uninstalled from ${scope} scope.`);
+  console.log();
+  log.dim("Restart Claude Code to complete the uninstall.");
+}
+async function uninstallCommand(opts = {}) {
   console.log(`
 === \u{1F44B} ${chalk.red("Coding Friend Uninstall")} \u{1F44B} ===`);
   if (!commandExists("claude")) {
@@ -86,12 +125,17 @@ async function uninstallCommand() {
     );
     return;
   }
-  const detection = detect();
-  if (detection.devModeActive) {
+  if (existsSync(devStatePath())) {
     log.warn("Dev mode is currently active.");
     log.dim(`Run ${chalk.bold("cf dev off")} first, then try again.`);
     return;
   }
+  const scope = await resolveScope(opts);
+  if (scope === "project" || scope === "local") {
+    await uninstallScoped(scope);
+    return;
+  }
+  const detection = detect();
   if (nothingToRemove(detection)) {
     log.info("Nothing to uninstall \u2014 Coding Friend is not installed.");
     return;

package/dist/{update-EN6S3FKT.js → update-RJSWHCCR.js}

@@ -2,12 +2,13 @@ import {
   getLatestVersion,
   semverCompare,
   updateCommand
-} from "./chunk-UR5XUEH5.js";
-import "./chunk-YAOUAJZP.js";
-import "./chunk-BCYBFGVD.js";
+} from "./chunk-RN5UYDIT.js";
+import "./chunk-HYLS67T7.js";
+import "./chunk-GJLNN6X5.js";
+import "./chunk-4JL3SR5V.js";
 import "./chunk-PGLUEN7D.js";
 import "./chunk-UFGNO6CW.js";
-import "./chunk-HQ5BPWEV.js";
+import "./chunk-ZS7BLEYT.js";
 import "./chunk-W5CD7WTX.js";
 export {
   getLatestVersion,

package/package.json

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