@luxkit/cli 1.1.44 → 1.1.45

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 1.1.45
+
+- Added global package manager override: `lux set lux_package_manager=pnpm` forces a specific package manager across all projects
+- Supports `auto`, `bun`, `pnpm`, `yarn`, `npm` values — `auto` (default) uses lockfile detection as before
+- Warns when global config conflicts with a project's existing lockfile
+
 ## 1.1.44
 
 - Merged English and Chinese README into a single file with in-page anchor switching

package/README.md

@@ -95,22 +95,22 @@ lux fmt list
 
 ### 📖CLI Commands
 
-| Command                     | Description                                                       |
-| :-------------------------- | :---------------------------------------------------------------- |
-| `lux fmt <preset>`          | Generate lint configs                                             |
-| `lux fmt list`              | List available lint presets                                       |
-| `lux vscode <preset>`       | Generate VSCode config (per-project)                              |
-| `lux vscode list`           | List available VSCode presets                                     |
-| `lux init`                  | Initialize Skill files to AI Agent                                |
-| `lux init --preset`         | Initialize all built-in presets to `~/.lux/preset/`               |
-| `lux set <key=value> [...]` | Persist proxy env vars (e.g. `https_proxy=http://127.0.0.1:7890`) |
-| `lux unset`                 | Clear all stored proxy configuration                              |
-| `lux show env`              | Display stored proxy environment variables                        |
-| `lux vpn cmd`               | Copy CMD proxy commands to clipboard                              |
-| `lux vpn pw`                | Copy PowerShell proxy commands to clipboard                       |
-| `lux vpn bash`              | Copy Bash proxy commands to clipboard                             |
-| `lux update`                | Update `@luxkit/cli` to the latest version                        |
-| `lux update --check`        | Check for available updates without installing                    |
+| Command                     | Description                                                                        |
+| :-------------------------- | :--------------------------------------------------------------------------------- |
+| `lux fmt <preset>`          | Generate lint configs                                                              |
+| `lux fmt list`              | List available lint presets                                                        |
+| `lux vscode <preset>`       | Generate VSCode config (per-project)                                               |
+| `lux vscode list`           | List available VSCode presets                                                      |
+| `lux init`                  | Initialize Skill files to AI Agent                                                 |
+| `lux init --preset`         | Initialize all built-in presets to `~/.lux/preset/`                                |
+| `lux set <key=value> [...]` | Set config values (proxy, global lux package management`lux_package_manager=pnpm`) |
+| `lux unset`                 | Clear all stored configuration                                                     |
+| `lux show env`              | Display stored configuration                                                       |
+| `lux vpn cmd`               | Copy CMD proxy commands to clipboard                                               |
+| `lux vpn pw`                | Copy PowerShell proxy commands to clipboard                                        |
+| `lux vpn bash`              | Copy Bash proxy commands to clipboard                                              |
+| `lux update`                | Update `@luxkit/cli` to the latest version                                         |
+| `lux update --check`        | Check for available updates without installing                                     |
 
 <br />
 
@@ -216,7 +216,7 @@ npm uninstall -g @luxkit/cli
 | :----------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `package.json` errors          | Ensure a valid `package.json` exists in the project root                                                                                            |
 | Preset not found               | Run `lux fmt list` to see all available presets — lux auto-suggests via fuzzy matching                                                              |
-| Wrong package manager detected | Ensure the lockfile exists (`bun.lock` / `package-lock.json` / `pnpm-lock.yaml`)                                                                    |
+| Wrong package manager detected | Ensure the lockfile exists (`bun.lock` / `package-lock.json` / `pnpm-lock.yaml`), or set globally: `lux set lux_package_manager=pnpm`               |
 | Skip dependency install        | Use `--no-install` to only write to `package.json`, install manually                                                                                |
 | Preview before applying        | Use `--dry-run` to see all operations without writing                                                                                               |
 | Flags have no effect           | Custom presets must include the corresponding config files and deps for `--stylelint`/`--cspell`/`--editorconfig`/`--husky`/`--lint-staged` to work |
@@ -340,22 +340,22 @@ lux fmt list
 
 ## 📖命令参考
 
-| 命令                        | 说明                                                         |
-| :-------------------------- | :----------------------------------------------------------- |
-| `lux fmt <preset>`          | 生成 Lint 配置                                               |
-| `lux fmt list`              | 列出可用的 Lint 预设                                         |
-| `lux vscode <preset>`       | 生成 VSCode 配置（项目内）                                   |
-| `lux vscode list`           | 列出可用的 VSCode 预设                                       |
-| `lux init`                  | 初始化 Skill 文件到 AI Agent                                 |
-| `lux init --preset`         | 初始化所有内置预设到 `~/.lux/preset/`                        |
-| `lux set <key=value> [...]` | 设置代理环境变量（如 `https_proxy="http://127.0.0.1:7890"`） |
-| `lux unset`                 | 清除所有代理配置                                             |
-| `lux show env`              | 显示已配置的代理环境变量                                     |
-| `lux vpn cmd`               | 复制 CMD 代理命令到剪贴板                                    |
-| `lux vpn pw`                | 复制 PowerShell 代理命令到剪贴板                             |
-| `lux vpn bash`              | 复制 Bash 代理命令到剪贴板                                   |
-| `lux update`                | 更新 `@luxkit/cli` 到最新版本                                |
-| `lux update --check`        | 检查可用更新，不执行安装                                     |
+| 命令                        | 说明                                                        |
+| :-------------------------- | :---------------------------------------------------------- |
+| `lux fmt <preset>`          | 生成 Lint 配置                                              |
+| `lux fmt list`              | 列出可用的 Lint 预设                                        |
+| `lux vscode <preset>`       | 生成 VSCode 配置（项目内）                                  |
+| `lux vscode list`           | 列出可用的 VSCode 预设                                      |
+| `lux init`                  | 初始化 Skill 文件到 AI Agent                                |
+| `lux init --preset`         | 初始化所有内置预设到 `~/.lux/preset/`                       |
+| `lux set <key=value> [...]` | 设置配置值（代理、全局lux包管理`lux_package_manager=pnpm`） |
+| `lux unset`                 | 清除所有已存储的配置                                        |
+| `lux show env`              | 显示已存储的配置                                            |
+| `lux vpn cmd`               | 复制 CMD 代理命令到剪贴板                                   |
+| `lux vpn pw`                | 复制 PowerShell 代理命令到剪贴板                            |
+| `lux vpn bash`              | 复制 Bash 代理命令到剪贴板                                  |
+| `lux update`                | 更新 `@luxkit/cli` 到最新版本                               |
+| `lux update --check`        | 检查可用更新，不执行安装                                    |
 
 <br />
 
@@ -457,14 +457,14 @@ npm uninstall -g @luxkit/cli
 
 ## 🔍故障排查
 
-| 问题                    | 解决方案                                                                                                           |
-| :---------------------- | :----------------------------------------------------------------------------------------------------------------- |
-| `package.json` 相关错误 | 确保项目根目录存在合法的 `package.json`                                                                            |
-| 预设未找到              | 运行 `lux fmt list` 查看所有可用预设，lux 会自动模糊匹配建议                                                       |
-| 包管理器检测不正确      | 确保 lockfile 存在（`bun.lock` / `package-lock.json` / `pnpm-lock.yaml`）                                          |
-| 跳过依赖安装            | 使用 `--no-install` 仅写入 `package.json`，手动安装                                                                |
-| 预览操作结果            | 使用 `--dry-run` 查看将执行的所有操作                                                                              |
-| flag 无效果             | 自定义预设需包含对应的配置文件和依赖，`--stylelint`/`--cspell`/`--editorconfig`/`--husky`/`--lint-staged` 才能生效 |
+| 问题                    | 解决方案                                                                                                                  |
+| :---------------------- | :------------------------------------------------------------------------------------------------------------------------ |
+| `package.json` 相关错误 | 确保项目根目录存在合法的 `package.json`                                                                                   |
+| 预设未找到              | 运行 `lux fmt list` 查看所有可用预设，lux 会自动模糊匹配建议                                                              |
+| 包管理器检测不正确      | 确保 lockfile 存在（`bun.lock` / `package-lock.json` / `pnpm-lock.yaml`），或全局指定：`lux set lux_package_manager=pnpm` |
+| 跳过依赖安装            | 使用 `--no-install` 仅写入 `package.json`，手动安装                                                                       |
+| 预览操作结果            | 使用 `--dry-run` 查看将执行的所有操作                                                                                     |
+| flag 无效果             | 自定义预设需包含对应的配置文件和依赖，`--stylelint`/`--cspell`/`--editorconfig`/`--husky`/`--lint-staged` 才能生效        |
 
 <br />
 

package/dist/index.js

@@ -4,8 +4,8 @@
 import { program } from "commander";
 
 // src/commands/fmt.ts
-import fs3 from "fs";
-import path5 from "path";
+import fs4 from "fs";
+import path6 from "path";
 import chalk2 from "chalk";
 
 // src/presets/fmt/electron-vue.ts
@@ -875,7 +875,7 @@ function generateAllFmt(preset, opts) {
 }
 
 // src/utils/deps.ts
-import path3 from "path";
+import path4 from "path";
 import { spawn } from "child_process";
 
 // src/utils/execFileNoThrow.ts
@@ -899,13 +899,76 @@ async function execFileNoThrow(command, args, options) {
   }
 }
 
+// src/utils/config.ts
+import fs2 from "fs";
+import os from "os";
+import path3 from "path";
+var CONFIG_DIR = ".lux";
+var ENV_FILE = "env.txt";
+function getEnvConfigPath() {
+  return path3.join(os.homedir(), CONFIG_DIR, ENV_FILE);
+}
+function getEnvConfig() {
+  let content;
+  try {
+    content = fs2.readFileSync(getEnvConfigPath(), "utf-8");
+  } catch {
+    return {};
+  }
+  const result = {};
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const eqIndex = trimmed.indexOf("=");
+    if (eqIndex === -1) continue;
+    const key = trimmed.slice(0, eqIndex).trim();
+    const raw = trimmed.slice(eqIndex + 1).trim();
+    const value = raw.replace(/^["']|["']$/g, "");
+    if (key) result[key] = value;
+  }
+  return result;
+}
+function setEnvConfig(data) {
+  const lines = Object.entries(data).filter(([, v]) => v !== "").map(([k, v]) => `${k}="${v}"`);
+  writeFile(getEnvConfigPath(), lines.join("\n") + "\n");
+}
+function clearEnvConfig() {
+  try {
+    fs2.unlinkSync(getEnvConfigPath());
+  } catch {
+  }
+}
+
 // src/utils/deps.ts
-function detectPackageManager(cwd) {
+var PM_LOCKFILE_MAP = {
+  bun: ["bun.lockb", "bun.lock"],
+  pnpm: ["pnpm-lock.yaml"],
+  yarn: ["yarn.lock"],
+  npm: ["package-lock.json"]
+};
+function detectFromLockfile(cwd) {
   if (fileExists(`${cwd}/bun.lockb`) || fileExists(`${cwd}/bun.lock`)) return "bun";
   if (fileExists(`${cwd}/pnpm-lock.yaml`)) return "pnpm";
   if (fileExists(`${cwd}/yarn.lock`)) return "yarn";
   return "npm";
 }
+function detectPackageManager(cwd) {
+  const env = getEnvConfig();
+  const configured = env.lux_package_manager;
+  if (configured && configured !== "auto") {
+    const pm = configured;
+    const lockfiles = PM_LOCKFILE_MAP[pm] ?? [];
+    const hasMatch = lockfiles.some((f) => fileExists(`${cwd}/${f}`));
+    if (!hasMatch) {
+      const detected = detectFromLockfile(cwd);
+      if (detected !== "npm") {
+        logger.warn(`Global config is ${pm} but detected ${detected} lockfile`);
+      }
+    }
+    return pm;
+  }
+  return detectFromLockfile(cwd);
+}
 function getLockfileName(pm) {
   switch (pm) {
     case "bun":
@@ -939,7 +1002,7 @@ async function fetchPackageVersion(pkg) {
   return lines[lines.length - 1].trim();
 }
 async function addDepsToManifest(packages, cwd) {
-  const pkgPath = path3.join(cwd, "package.json");
+  const pkgPath = path4.join(cwd, "package.json");
   const pkg = readJson(pkgPath);
   if (!pkg) {
     throw new Error("package.json not found");
@@ -963,7 +1026,7 @@ async function addDepsToManifest(packages, cwd) {
 }
 async function installDevDeps(packages, cwd, pm) {
   const manager = pm ?? detectPackageManager(cwd);
-  const pkg = readJson(path3.join(cwd, "package.json"));
+  const pkg = readJson(path4.join(cwd, "package.json"));
   if (!pkg) {
     throw new Error("package.json not found");
   }
@@ -999,9 +1062,9 @@ async function installDevDeps(packages, cwd, pm) {
 }
 
 // src/core/local-preset.ts
-import fs2 from "fs";
-import os from "os";
-import path4 from "path";
+import fs3 from "fs";
+import os2 from "os";
+import path5 from "path";
 
 // src/core/merge-settings.ts
 var USER_PRIORITY_KEYS = /* @__PURE__ */ new Set([
@@ -1082,27 +1145,27 @@ var STYLELINT_EXTENSION = "stylelint.vscode-stylelint";
 var HUSKY_DEPS = /* @__PURE__ */ new Set(["husky"]);
 var LINTSTAGED_DEPS = /* @__PURE__ */ new Set(["lint-staged"]);
 function getLuxDir() {
-  return process.env.LUX_HOME || path4.join(os.homedir(), ".lux");
+  return process.env.LUX_HOME || path5.join(os2.homedir(), ".lux");
 }
 function getLocalPresetDir(type, presetName) {
   if (!isValidPresetName(presetName)) {
     throw new Error(`Invalid preset name: "${presetName}"`);
   }
-  return path4.join(getLuxDir(), "preset", type, presetName);
+  return path5.join(getLuxDir(), "preset", type, presetName);
 }
 function isValidPresetName(name) {
   return name.length > 0 && !name.includes("/") && !name.includes("\\") && !name.includes("..");
 }
 function listCustomPresets() {
-  const fmtDir = path4.join(getLuxDir(), "preset", "fmt");
-  if (!fs2.existsSync(fmtDir)) return [];
-  const entries = fs2.readdirSync(fmtDir, { withFileTypes: true });
+  const fmtDir = path5.join(getLuxDir(), "preset", "fmt");
+  if (!fs3.existsSync(fmtDir)) return [];
+  const entries = fs3.readdirSync(fmtDir, { withFileTypes: true });
   const result = [];
   for (const entry of entries) {
     if (!entry.isDirectory()) continue;
     if (!isValidPresetName(entry.name)) continue;
-    const pkgPath = path4.join(fmtDir, entry.name, "package.json");
-    if (fs2.existsSync(pkgPath)) {
+    const pkgPath = path5.join(fmtDir, entry.name, "package.json");
+    if (fs3.existsSync(pkgPath)) {
       result.push(entry.name);
     }
   }
@@ -1110,19 +1173,19 @@ function listCustomPresets() {
 }
 function isValidCustomPreset(name) {
   if (!isValidPresetName(name)) return false;
-  const presetDir = path4.join(getLuxDir(), "preset", "fmt", name);
-  if (!fs2.existsSync(presetDir)) return false;
-  const pkgPath = path4.join(presetDir, "package.json");
-  return fs2.existsSync(pkgPath);
+  const presetDir = path5.join(getLuxDir(), "preset", "fmt", name);
+  if (!fs3.existsSync(presetDir)) return false;
+  const pkgPath = path5.join(presetDir, "package.json");
+  return fs3.existsSync(pkgPath);
 }
 function localPresetExists(type, presetName) {
   const dir = getLocalPresetDir(type, presetName);
-  return fs2.existsSync(dir);
+  return fs3.existsSync(dir);
 }
 function resetLocalPreset(type, presetName) {
   const dir = getLocalPresetDir(type, presetName);
-  if (fs2.existsSync(dir)) {
-    fs2.rmSync(dir, { recursive: true, force: true });
+  if (fs3.existsSync(dir)) {
+    fs3.rmSync(dir, { recursive: true, force: true });
     logger.log(`Reset local preset: ${dir}`);
   }
 }
@@ -1137,24 +1200,24 @@ function materializeFmtPreset(presetName, preset, opts) {
     const content = getContent(preset);
     if (content === void 0) continue;
     const resolved = opts.lockfile ? content.replace(/<lockfile>/g, opts.lockfile) : content.replace(/<lockfile>\n?/g, "");
-    writeFile(path4.join(presetDir, filename), resolved);
+    writeFile(path5.join(presetDir, filename), resolved);
   }
   const templatePkg = buildTemplatePackageJson(preset);
-  writeJson(path4.join(presetDir, "package.json"), templatePkg);
+  writeJson(path5.join(presetDir, "package.json"), templatePkg);
   logger.log(`Local preset created at ${presetDir}`);
 }
 function materializeVscodePreset(cwd, presetName) {
   const presetDir = getLocalPresetDir("vscode", presetName);
   ensureDir(presetDir);
-  const settingsSrc = path4.join(cwd, ".vscode", "settings.json");
+  const settingsSrc = path5.join(cwd, ".vscode", "settings.json");
   if (fileExists(settingsSrc)) {
-    const content = fs2.readFileSync(settingsSrc, "utf-8");
-    writeFile(path4.join(presetDir, "settings.json"), content);
+    const content = fs3.readFileSync(settingsSrc, "utf-8");
+    writeFile(path5.join(presetDir, "settings.json"), content);
   }
-  const extensionsSrc = path4.join(cwd, ".vscode", "extensions.json");
+  const extensionsSrc = path5.join(cwd, ".vscode", "extensions.json");
   if (fileExists(extensionsSrc)) {
-    const content = fs2.readFileSync(extensionsSrc, "utf-8");
-    writeFile(path4.join(presetDir, "extensions.json"), content);
+    const content = fs3.readFileSync(extensionsSrc, "utf-8");
+    writeFile(path5.join(presetDir, "extensions.json"), content);
   }
   logger.log(`Local preset created at ${presetDir}`);
 }
@@ -1162,9 +1225,9 @@ function materializeVscodePresetFromBuiltin(presetName, preset) {
   const presetDir = getLocalPresetDir("vscode", presetName);
   ensureDir(presetDir);
   const settings = preset.settings();
-  writeJson(path4.join(presetDir, "settings.json"), settings);
+  writeJson(path5.join(presetDir, "settings.json"), settings);
   const extensions = preset.extensions();
-  writeJson(path4.join(presetDir, "extensions.json"), { recommendations: extensions });
+  writeJson(path5.join(presetDir, "extensions.json"), { recommendations: extensions });
   logger.log(`Local preset created at ${presetDir}`);
 }
 var InvalidPackageJsonError = class extends Error {
@@ -1183,25 +1246,25 @@ function applyLocalFmtPreset(cwd, presetName, opts) {
     scriptsSkipped: 0
   };
   const presetDir = getLocalPresetDir("fmt", presetName);
-  if (!fs2.existsSync(presetDir)) {
+  if (!fs3.existsSync(presetDir)) {
     logger.warn(`Local preset not found at ${presetDir}`);
     return result;
   }
-  const projectPkgPath = path4.join(cwd, "package.json");
+  const projectPkgPath = path5.join(cwd, "package.json");
   if (fileExists(projectPkgPath)) {
     try {
-      JSON.parse(fs2.readFileSync(projectPkgPath, "utf-8"));
+      JSON.parse(fs3.readFileSync(projectPkgPath, "utf-8"));
     } catch {
       throw new InvalidPackageJsonError(projectPkgPath);
     }
   }
-  const entries = fs2.readdirSync(presetDir).filter((name) => name !== "package.json" && fs2.statSync(path4.join(presetDir, name)).isFile());
+  const entries = fs3.readdirSync(presetDir).filter((name) => name !== "package.json" && fs3.statSync(path5.join(presetDir, name)).isFile());
   for (const filename of entries) {
     if (opts.noStylelint && STYLELINT_FILES.has(filename)) continue;
     if (opts.noEditorconfig && filename === EDITORCONFIG_FILE) continue;
     if (opts.noCspell && filename === CSPELL_FILE) continue;
     if (opts.noLintStaged && filename === LINTSTAGED_FILE) continue;
-    const destPath = path4.join(cwd, filename);
+    const destPath = path5.join(cwd, filename);
     const exists = fileExists(destPath);
     if (exists && !opts.force) {
       result.skipped.push(filename);
@@ -1215,14 +1278,14 @@ function applyLocalFmtPreset(cwd, presetName, opts) {
       logger.log(`[dry-run] Would copy ${filename} from local preset`);
       continue;
     }
-    const content = fs2.readFileSync(path4.join(presetDir, filename), "utf-8");
+    const content = fs3.readFileSync(path5.join(presetDir, filename), "utf-8");
     writeFile(destPath, content);
     (exists ? result.overwritten : result.created).push(filename);
   }
-  const templatePkg = readJson(path4.join(presetDir, "package.json"));
+  const templatePkg = readJson(path5.join(presetDir, "package.json"));
   const projectPkg = readJson(projectPkgPath);
   if (templatePkg && projectPkg) {
-    const pm = fileExists(path4.join(cwd, "package.json")) ? detectPackageManager(cwd) : void 0;
+    const pm = fileExists(path5.join(cwd, "package.json")) ? detectPackageManager(cwd) : void 0;
     const merged = mergeTemplateIntoProject(templatePkg, projectPkg, pm, opts, result);
     if (!opts.dryRun) {
       writeJson(projectPkgPath, merged);
@@ -1239,16 +1302,16 @@ function applyLocalVscodePreset(cwd, presetName, opts) {
     scriptsSkipped: 0
   };
   const presetDir = getLocalPresetDir("vscode", presetName);
-  if (!fs2.existsSync(presetDir)) {
+  if (!fs3.existsSync(presetDir)) {
     logger.warn(`Local preset not found at ${presetDir}`);
     return result;
   }
-  const settingsSrc = path4.join(presetDir, "settings.json");
+  const settingsSrc = path5.join(presetDir, "settings.json");
   if (fileExists(settingsSrc)) {
     const presetSettings = readJson(settingsSrc);
     const filteredSettings = opts.noStylelint ? filterStylelintSettings(presetSettings ?? {}) : presetSettings;
     if (filteredSettings) {
-      const settingsDest = path4.join(cwd, ".vscode", "settings.json");
+      const settingsDest = path5.join(cwd, ".vscode", "settings.json");
       const existingSettings = readJson(settingsDest);
       if (existingSettings) {
         if (opts.dryRun) {
@@ -1270,7 +1333,7 @@ function applyLocalVscodePreset(cwd, presetName, opts) {
       }
     }
   }
-  const extensionsSrc = path4.join(presetDir, "extensions.json");
+  const extensionsSrc = path5.join(presetDir, "extensions.json");
   if (fileExists(extensionsSrc)) {
     const extensionsData = readJson(extensionsSrc);
     if (extensionsData) {
@@ -1284,7 +1347,7 @@ function applyLocalVscodePreset(cwd, presetName, opts) {
         result.created.push(".vscode/extensions.json");
         logger.log("[dry-run] Would create .vscode/extensions.json from local preset");
       } else {
-        const extensionsDest = path4.join(cwd, ".vscode", "extensions.json");
+        const extensionsDest = path5.join(cwd, ".vscode", "extensions.json");
         const existingExtensions = readJson(extensionsDest);
         const existingRecommendations = existingExtensions?.recommendations ?? [];
         const merged = [.../* @__PURE__ */ new Set([...existingRecommendations, ...presetRecommendations])];
@@ -1396,11 +1459,11 @@ function filterScripts(scripts, noStylelint, noEditorconfig, noCspell, noLintSta
   return filtered;
 }
 function detectPresetCapabilities(presetName) {
-  const presetDir = path4.join(getLuxDir(), "preset", "fmt", presetName);
-  const entries = fs2.readdirSync(presetDir);
+  const presetDir = path5.join(getLuxDir(), "preset", "fmt", presetName);
+  const entries = fs3.readdirSync(presetDir);
   const hasStylelintFile = entries.some((f) => STYLELINT_FILES.has(f));
   const pkg = readJson(
-    path4.join(presetDir, "package.json")
+    path5.join(presetDir, "package.json")
   );
   const hasStylelintDep = pkg?.devDependencies ? Object.keys(pkg.devDependencies).some((d) => isNotStylelintDep(d) === false) : false;
   const hasEditorconfigFile = entries.includes(EDITORCONFIG_FILE);
@@ -1468,10 +1531,10 @@ function registerFmtCommand(program2) {
         return;
       }
       const cwd = process.cwd();
-      const pkgPath = path5.join(cwd, "package.json");
+      const pkgPath = path6.join(cwd, "package.json");
       if (fileExists(pkgPath)) {
         try {
-          JSON.parse(fs3.readFileSync(pkgPath, "utf-8"));
+          JSON.parse(fs4.readFileSync(pkgPath, "utf-8"));
         } catch {
           logger.error(
             "package.json exists but is not valid JSON. Fix it first, then re-run this command."
@@ -1568,9 +1631,9 @@ async function executeLocalPath(cwd, presetName, options) {
       `Added ${result.scriptsAdded} script${result.scriptsAdded > 1 ? "s" : ""} to package.json${result.scriptsSkipped > 0 ? ` (${result.scriptsSkipped} skipped)` : ""}`
     );
   }
-  const pm = fileExists(path5.join(cwd, "package.json")) ? detectPackageManager(cwd) : void 0;
+  const pm = fileExists(path6.join(cwd, "package.json")) ? detectPackageManager(cwd) : void 0;
   if (!pm) return;
-  const templatePkgPath = path5.join(getLocalPresetDir("fmt", presetName), "package.json");
+  const templatePkgPath = path6.join(getLocalPresetDir("fmt", presetName), "package.json");
   const templatePkg = readJson(templatePkgPath);
   if (!templatePkg?.devDependencies) return;
   const depsToInstall = filterDeps(
@@ -1581,7 +1644,7 @@ async function executeLocalPath(cwd, presetName, options) {
     opts.noHusky,
     opts.noLintStaged
   );
-  const projectPkgPath = path5.join(cwd, "package.json");
+  const projectPkgPath = path6.join(cwd, "package.json");
   const projectPkg = readJson(projectPkgPath);
   if (!projectPkg) return;
   const existingDeps = projectPkg.devDependencies ?? {};
@@ -1633,7 +1696,7 @@ async function executeLocalPath(cwd, presetName, options) {
   }
 }
 async function executeBuiltinPath(cwd, presetName, preset, options) {
-  const pm = fileExists(path5.join(cwd, "package.json")) ? detectPackageManager(cwd) : void 0;
+  const pm = fileExists(path6.join(cwd, "package.json")) ? detectPackageManager(cwd) : void 0;
   const noHusky = options.husky !== true && options.lintStaged !== true;
   const noLintStaged = options.lintStaged !== true;
   const opts = {
@@ -1788,7 +1851,7 @@ function summarizeFiles(filenames) {
   return [...categories].join(", ");
 }
 async function injectScripts(scripts, opts, pm) {
-  const pkgPath = path5.join(opts.cwd, "package.json");
+  const pkgPath = path6.join(opts.cwd, "package.json");
   const pkg = readJson(pkgPath);
   if (!pkg) {
     logger.warn("package.json not found, skipping script injection");
@@ -1823,7 +1886,7 @@ async function injectScripts(scripts, opts, pm) {
   }
 }
 async function initHusky(cwd, pm, opts) {
-  const pkgPath = path5.join(cwd, "package.json");
+  const pkgPath = path6.join(cwd, "package.json");
   const pkg = readJson(pkgPath);
   if (!pkg) {
     logger.warn("package.json not found, skipping husky setup");
@@ -1833,8 +1896,8 @@ async function initHusky(cwd, pm, opts) {
   const isYarn = pm === "yarn";
   const initScriptName = isYarn ? "postinstall" : "prepare";
   const hookCommand = opts.noLintStaged ? `${prefix} lint` : `${prefix} lint-staged`;
-  const huskyDir = path5.join(cwd, ".husky");
-  const preCommitPath = path5.join(huskyDir, "pre-commit");
+  const huskyDir = path6.join(cwd, ".husky");
+  const preCommitPath = path6.join(huskyDir, "pre-commit");
   if (opts.dryRun) {
     logger.log(`[dry-run] Would create .husky/pre-commit with: ${hookCommand}`);
     logger.log(`[dry-run] Would inject "${initScriptName}": "husky" script`);
@@ -1847,7 +1910,7 @@ async function initHusky(cwd, pm, opts) {
     ensureDir(huskyDir);
     writeFile(preCommitPath, `${hookCommand}
 `);
-    fs3.chmodSync(preCommitPath, 493);
+    fs4.chmodSync(preCommitPath, 493);
   }
   const scripts = pkg.scripts ?? {};
   if (scripts[initScriptName] !== void 0 && !opts.force) {
@@ -2651,18 +2714,18 @@ var VSCODE_PRESETS = [
 ];
 
 // src/generators/init.ts
-import fs4 from "fs";
-import path6 from "path";
+import fs5 from "fs";
+import path7 from "path";
 function resolveSkillsDir() {
-  const entryDir = path6.dirname(process.argv[1] ?? "");
-  return path6.resolve(entryDir, "skills");
+  const entryDir = path7.dirname(process.argv[1] ?? "");
+  return path7.resolve(entryDir, "skills");
 }
 function listFilesRecursive(dir, base) {
-  const entries = fs4.readdirSync(dir, { withFileTypes: true });
+  const entries = fs5.readdirSync(dir, { withFileTypes: true });
   const files = [];
   for (const entry of entries) {
     const childBase = `${base}/${entry.name}`;
-    const fullPath = path6.join(dir, entry.name);
+    const fullPath = path7.join(dir, entry.name);
     if (entry.isDirectory()) {
       files.push(...listFilesRecursive(fullPath, childBase));
     } else {
@@ -2673,20 +2736,20 @@ function listFilesRecursive(dir, base) {
 }
 function generateInitSkills(targetBaseDir, cwd) {
   const skillsDir = resolveSkillsDir();
-  if (!fs4.existsSync(skillsDir)) {
+  if (!fs5.existsSync(skillsDir)) {
     logger.error(`Bundled skills directory not found: ${skillsDir}`);
     logger.error('Please run "lux build" or reinstall lux.');
     return { copiedFiles: [], targetDir: targetBaseDir };
   }
-  const targetPath = path6.resolve(cwd, targetBaseDir);
+  const targetPath = path7.resolve(cwd, targetBaseDir);
   try {
-    fs4.cpSync(skillsDir, targetPath, { recursive: true, force: true });
+    fs5.cpSync(skillsDir, targetPath, { recursive: true, force: true });
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     logger.error(`Failed to copy skills to ${targetPath}: ${message}`);
     return { copiedFiles: [], targetDir: targetBaseDir };
   }
-  const copiedFiles = fs4.existsSync(targetPath) ? listFilesRecursive(targetPath, targetBaseDir) : [];
+  const copiedFiles = fs5.existsSync(targetPath) ? listFilesRecursive(targetPath, targetBaseDir) : [];
   return { copiedFiles, targetDir: targetBaseDir };
 }
 
@@ -2746,46 +2809,6 @@ function materializeAllPresets() {
   logger.success("All presets materialized to ~/.lux/preset/");
 }
 
-// src/utils/config.ts
-import fs5 from "fs";
-import os2 from "os";
-import path7 from "path";
-var CONFIG_DIR = ".lux";
-var ENV_FILE = "env.txt";
-function getEnvConfigPath() {
-  return path7.join(os2.homedir(), CONFIG_DIR, ENV_FILE);
-}
-function getEnvConfig() {
-  let content;
-  try {
-    content = fs5.readFileSync(getEnvConfigPath(), "utf-8");
-  } catch {
-    return {};
-  }
-  const result = {};
-  for (const line of content.split("\n")) {
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith("#")) continue;
-    const eqIndex = trimmed.indexOf("=");
-    if (eqIndex === -1) continue;
-    const key = trimmed.slice(0, eqIndex).trim();
-    const raw = trimmed.slice(eqIndex + 1).trim();
-    const value = raw.replace(/^["']|["']$/g, "");
-    if (key) result[key] = value;
-  }
-  return result;
-}
-function setEnvConfig(data) {
-  const lines = Object.entries(data).filter(([, v]) => v !== "").map(([k, v]) => `${k}="${v}"`);
-  writeFile(getEnvConfigPath(), lines.join("\n") + "\n");
-}
-function clearEnvConfig() {
-  try {
-    fs5.unlinkSync(getEnvConfigPath());
-  } catch {
-  }
-}
-
 // src/commands/show.ts
 function handleShowEnv() {
   const config = getEnvConfig();
@@ -3041,7 +3064,8 @@ function executeVscodeBuiltinPath(cwd, presetName, preset, options) {
 
 // src/commands/vpn.ts
 import { spawnSync } from "child_process";
-var ALLOWED_KEYS = ["https_proxy", "http_proxy", "all_proxy"];
+var ALLOWED_KEYS = ["https_proxy", "http_proxy", "all_proxy", "lux_package_manager"];
+var VALID_PM_VALUES = ["auto", "bun", "pnpm", "yarn", "npm"];
 function buildCommands(shell, env) {
   const entries = Object.entries(env);
   if (shell === "cmd") {
@@ -3099,6 +3123,12 @@ function handleSet(args) {
       logger.error(`Invalid key: "${key}". Allowed keys: ${ALLOWED_KEYS.join(", ")}`);
       return;
     }
+    if (key === "lux_package_manager" && !VALID_PM_VALUES.includes(value)) {
+      logger.error(
+        `Invalid package manager: "${value}". Allowed values: ${VALID_PM_VALUES.join(", ")}`
+      );
+      return;
+    }
     merged[key] = value;
   }
   setEnvConfig(merged);
@@ -3123,6 +3153,9 @@ registerVscodeCommand(program);
 registerVpnCommand(program);
 registerShowCommand(program);
 registerUpdateCommand(program);
-program.command("set").description("Set proxy env vars using key=value pairs").argument("[args...]", "key=value pairs (e.g. https_proxy=http://127.0.0.1:7890)").action((args) => handleSet(args));
-program.command("unset").description("Clear stored proxy configuration").action(() => handleUnset());
+program.command("set").description("Set config values using key=value pairs (proxy, lux_package_manager)").argument(
+  "[args...]",
+  "key=value pairs (e.g. https_proxy=http://127.0.0.1:7890, lux_package_manager=pnpm)"
+).action((args) => handleSet(args));
+program.command("unset").description("Clear stored configuration").action(() => handleUnset());
 program.parse();

package/dist/skills/lux/skill.md

@@ -1,6 +1,6 @@
 ---
 name: lux
-description: Use when setting up ESLint, Prettier, CSpell, Stylelint, EditorConfig, VSCode workspace settings, proxy env
+description: Use it only when users want to configure lint, ESLint, Prettier,Husky etc, and VSCode with lux.
 ---
 
 ## fmt — generate lint/format configs
@@ -73,10 +73,20 @@ lux vpn bash      # copy Bash proxy commands
 
 ```bash
 lux set https_proxy=http://127.0.0.1:7890
-lux unset         # clear all proxy config
-lux show env      # show stored proxy env
+lux unset         # clear all config
+lux show env      # show stored config
 ```
 
+## package manager — global override
+
+```bash
+lux set lux_package_manager=pnpm    # force pnpm globally (auto, bun, pnpm, yarn, npm)
+lux set lux_package_manager=auto     # revert to lockfile detection
+lux unset                            # clear all config (reverts to auto)
+```
+
+By default lux detects the package manager from lockfile (`bun.lock`, `pnpm-lock.yaml`, `yarn.lock`, `package-lock.json`). Setting `lux_package_manager` overrides this globally — lux will use the configured PM for all projects, with a warning if the project's lockfile doesn't match.
+
 ## update — self-update
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
    "name": "@luxkit/cli",
-   "version": "1.1.44",
+   "version": "1.1.45",
    "description": "One-click project formatting & VSCode config CLI",
    "type": "module",
    "bin": {