@luxkit/cli 1.0.8 → 1.1.0

package/README.md

@@ -18,7 +18,7 @@
 
 ### What is lux?
 
-`lux` is a CLI tool that initializes project formatting configs and VSCode workspace settings with a single command. It generates ESLint, Prettier, Stylelint, CSpell, EditorConfig files and VSCode settings from battle-tested presets — with smart merge and conflict resolution.
+`lux` is a CLI tool that initializes project formatting configs and VSCode workspace settings with a single command. It generates ESLint, Prettier, CSpell, EditorConfig files and VSCode settings from battle-tested presets — with smart merge and conflict resolution.
 
 <div align="center">
   <img src="https://github.com/TTT1231/lux/blob/main/demo.gif?raw=true" alt="lux demo" width="640" />
@@ -26,19 +26,19 @@
 
 ### ✨ Key Highlights
 
-| Feature                    | Description                                                                    |
-| :------------------------- | :----------------------------------------------------------------------------- |
-| 🎯 **One Command Setup**   | `lux fmt web-vue` generates all linting & formatting configs instantly             |
-| 🔧 **5 Fmt Presets**       | `web-vue` · `electron-vue` · `uniapp` · `node` · `nest` — each with curated rules      |
-| 🖥️ **6 VSCode Presets**    | `web-vue` · `electron-vue` · `uniapp` · `node` · `nest` · `go` — settings + extensions |
-| 🔀 **Smart Merge**         | Preset wins for linting keys; user wins for personal preferences               |
-| 🛡️ **Conflict Resolution** | `neverOverwrite` / `forceOverwrite` lists + `--force` flag                     |
-| 📦 **Auto Install**        | Detects bun / pnpm / yarn / npm and installs devDependencies                   |
-| 🔍 **Fuzzy Matching**      | Typo a preset name? Levenshtein distance finds the closest match               |
-| 🧪 **Dry Run**             | Preview all changes with `--dry-run` before writing anything                   |
-| 🔗 **Script Injection**    | Auto-injects `<pm> lint` / `<pm> format` scripts into package.json             |
-| 🌐 **Proxy Management**    | Persistent proxy config with `set` / `unset` — copy to CMD / PowerShell / Bash |
-| 🔄 **Self-Update**         | `lux update` checks and installs the latest version automatically              |
+| Feature                    | Description                                                                                          |
+| :------------------------- | :--------------------------------------------------------------------------------------------------- |
+| 🎯 **One Command Setup**   | `lux fmt web-vue` generates all linting & formatting configs instantly                               |
+| 🔧 **6 Fmt Presets**       | `web-vue` · `web-react` · `electron-vue` · `uniapp` · `node` · `nest` — each with curated rules      |
+| 🖥️ **7 VSCode Presets**    | `web-vue` · `web-react` · `electron-vue` · `uniapp` · `node` · `nest` · `go` — settings + extensions |
+| 🔀 **Smart Merge**         | Preset wins for linting keys; user wins for personal preferences                                     |
+| 🛡️ **Conflict Resolution** | `neverOverwrite` / `forceOverwrite` lists + `--force` flag                                           |
+| 📦 **Auto Install**        | Detects bun / pnpm / yarn / npm and installs devDependencies                                         |
+| 🔍 **Fuzzy Matching**      | Typo a preset name? Levenshtein distance finds the closest match                                     |
+| 🧪 **Dry Run**             | Preview all changes with `--dry-run` before writing anything                                         |
+| 🔗 **Script Injection**    | Auto-injects `<pm> lint` / `<pm> format` scripts into package.json                                   |
+| 🌐 **Proxy Management**    | Persistent proxy config with `set` / `unset` — copy to CMD / PowerShell / Bash                       |
+| 🔄 **Self-Update**         | `lux update` checks and installs the latest version automatically                                    |
 
 <br />
 
@@ -51,11 +51,16 @@ npm install -g @luxkit/cli
 bun add -g @luxkit/cli
 
 # Initialize formatting configs
-lux fmt web-vue          # Generate ESLint, Prettier, Stylelint, CSpell, EditorConfig
+lux fmt web-vue          # Generate ESLint, Prettier, CSpell
+lux fmt web-vue --stylelint    # Also include Stylelint
+lux fmt web-vue --editorconfig # Also include EditorConfig
 
 # Initialize VSCode settings
 lux vscode web-vue       # Generate .vscode/settings.json + extensions.json
 
+# Initialize AI coding tool skills
+lux init                 # Select tool interactively, copy skills to project
+
 # List available presets
 lux fmt list
 lux vscode list
@@ -65,33 +70,34 @@ lux vscode list
 
 ### CLI Commands
 
-| Command                     | Description                                        |
-| :-------------------------- | :------------------------------------------------- |
-| `lux fmt <preset>`          | Initialize formatting config files                 |
-| `lux fmt list`              | List available fmt presets                         |
-| `lux vscode <preset>`       | Initialize VSCode workspace settings               |
-| `lux vscode list`           | List available VSCode presets                      |
+| Command                     | Description                                                       |
+| :-------------------------- | :---------------------------------------------------------------- |
+| `lux fmt <preset>`          | Initialize formatting config files                                |
+| `lux fmt list`              | List available fmt presets                                        |
+| `lux vscode <preset>`       | Initialize VSCode workspace settings                              |
+| `lux vscode list`           | List available VSCode presets                                     |
+| `lux init`                  | Initialize AI coding tool skills in current project               |
 | `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     |
+| `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                    |
 
 <br />
 
 ### Available Presets
 
-| Preset     | Fmt | VSCode | Stack                        |
-| :--------- | :-: | :----: | :--------------------------- |
-| `web-vue`  | ✅  |   ✅   | Vue / React / TS / CSS       |
-| `electron-vue` | ✅  |   ✅   | Electron + Web stack         |
-| `uniapp`   | ✅  |   ✅   | UniApp / WeChat Mini Program |
-| `node`     | ✅  |   ✅   | Node.js backend              |
-| `nest`     | ✅  |   ✅   | NestJS backend               |
-| `go`       |  —  |   ✅   | Go backend                   |
+| Preset         | Fmt | VSCode | Stack                      |
+| :------------- | :-: | :----: | :------------------------- |
+| `web-vue`      | ✅  |   ✅   | Vue 3 / Vite / TS / CSS    |
+| `web-react`    | ✅  |   ✅   | React / Vite / TS / CSS    |
+| `electron-vue` | ✅  |   ✅   | Electron + Vue / Web stack |
+| `node`         | ✅  |   ✅   | Node.js backend            |
+| `nest`         | ✅  |   ✅   | NestJS backend             |
+| `go`           |  —  |   ✅   | Go backend                 |
 
 <br />
 
@@ -100,9 +106,11 @@ lux vscode list
 ```bash
 lux fmt <preset> [options]
 
-  --force       Force overwrite existing files
-  --no-install  Skip dependency installation
-  --dry-run     Preview without writing files
+  --force         Force overwrite existing files
+  --no-install    Skip dependency installation
+  --dry-run       Preview without writing files
+  --stylelint     Include Stylelint config generation (opt-in)
+  --editorconfig  Include EditorConfig config generation (opt-in)
 ```
 
 <br />
@@ -142,7 +150,7 @@ lux fmt web-vue
 | Test     | Vitest (unit + acceptance)                 |
 | CLI      | Commander.js                               |
 | Output   | Chalk                                      |
-| Bundle   | Zero runtime deps (chalk + commander only) |
+| Bundle   | Minimal runtime deps (chalk + commander + @clack/prompts) |
 
 <br />
 

package/dist/index.js

@@ -114,8 +114,8 @@ trim_trailing_whitespace = false
     ]
   },
   scripts: {
-    lint: "eslint .",
-    "lint:fix": 'eslint "src/**/*.{js,ts,vue}" --fix',
+    lint: "eslint . --cache --cache-location node_modules/.cache/.eslintcache",
+    "lint:fix": 'eslint "src/**/*.{js,ts,vue}" --fix --cache --cache-location node_modules/.cache/.eslintcache',
     format: 'prettier --write "src/**/*.{ts,js,json,vue,css,scss}"',
     "format:check": 'prettier --check "src/**/*.{ts,js,json,vue,css,scss}"',
     stylelint: 'stylelint "src/**/*.{css,scss,vue}"',
@@ -297,8 +297,8 @@ trim_trailing_whitespace = false
     ]
   },
   scripts: {
-    lint: "eslint .",
-    "lint:fix": 'eslint "src/**/*.{js,ts}" --fix',
+    lint: "eslint . --cache --cache-location node_modules/.cache/.eslintcache",
+    "lint:fix": 'eslint "src/**/*.{js,ts}" --fix --cache --cache-location node_modules/.cache/.eslintcache',
     format: 'prettier --write "src/**/*.{ts,js,json}"',
     "format:check": 'prettier --check "src/**/*.{ts,js,json}"',
     cspell: 'cspell --gitignore "src/**/*"',
@@ -416,8 +416,8 @@ trim_trailing_whitespace = false
     ]
   },
   scripts: {
-    lint: "eslint .",
-    "lint:fix": 'eslint "src/**/*.{js,ts,vue}" --fix',
+    lint: "eslint . --cache --cache-location node_modules/.cache/.eslintcache",
+    "lint:fix": 'eslint "src/**/*.{js,ts,vue}" --fix --cache --cache-location node_modules/.cache/.eslintcache',
     format: 'prettier --write "src/**/*.{ts,js,json,vue,css,scss}"',
     "format:check": 'prettier --check "src/**/*.{ts,js,json,vue,css,scss}"',
     stylelint: 'stylelint "src/**/*.{css,scss,vue}"',
@@ -431,6 +431,134 @@ trim_trailing_whitespace = false
   }
 };
 
+// src/presets/fmt/web-react.ts
+var webReactFmt = {
+  name: "web-react",
+  description: "React Web frontend (Vite + React + TypeScript)",
+  eslint: () => `import js from '@eslint/js'
+import tseslint from 'typescript-eslint'
+import reactHooks from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+import globals from 'globals'
+import prettierConfig from 'eslint-config-prettier'
+
+export default tseslint.config(
+  { ignores: ['dist'] },
+  {
+    extends: [js.configs.recommended, ...tseslint.configs.recommended],
+    files: ['**/*.{ts,tsx}'],
+    languageOptions: {
+      ecmaVersion: 2020,
+      globals: globals.browser,
+    },
+    plugins: {
+      'react-hooks': reactHooks,
+      'react-refresh': reactRefresh,
+    },
+    rules: {
+      ...reactHooks.configs.recommended.rules,
+      'react-refresh/only-export-components': ['warn', { allowConstantExport: true }],
+      '@typescript-eslint/no-explicit-any': 'warn',
+      '@typescript-eslint/no-unused-vars': ['warn', { argsIgnorePattern: '^_' }],
+    },
+  },
+  prettierConfig,
+)
+`,
+  prettier: () => JSON.stringify(
+    {
+      semi: false,
+      singleQuote: true,
+      tabWidth: 2,
+      trailingComma: "all",
+      printWidth: 100,
+      endOfLine: "lf"
+    },
+    null,
+    2
+  ) + "\n",
+  prettierIgnore: () => `node_modules/
+<lockfile>
+dist/
+coverage/
+`,
+  stylelint: () => `export default {
+  plugins: ['stylelint-order', '@stylistic/stylelint-plugin'],
+  extends: [
+    'stylelint-config-standard-scss',
+    'stylelint-config-recess-order',
+  ],
+  rules: {
+    'selector-class-pattern': null,
+    'scss/dollar-variable-pattern': null,
+    'scss/percent-placeholder-pattern': null,
+    'scss/at-mixin-pattern': null,
+    'order/properties-order': null,
+  },
+}
+`,
+  stylelintIgnore: () => `node_modules/
+dist/
+`,
+  cspell: () => JSON.stringify(
+    {
+      $schema: "https://raw.githubusercontent.com/streetsidesoftware/cspell/main/cspell.schema.json",
+      version: "0.2",
+      language: "en,en-US",
+      allowCompoundWords: true,
+      words: ["vite", "react", "zustand", "tanstack"]
+    },
+    null,
+    2
+  ) + "\n",
+  editorconfig: () => `root = true
+
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 2
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+`,
+  dependencies: {
+    dev: [
+      "eslint",
+      "@eslint/js",
+      "typescript-eslint",
+      "eslint-plugin-react-hooks",
+      "eslint-plugin-react-refresh",
+      "eslint-config-prettier",
+      "globals",
+      "prettier",
+      "stylelint",
+      "stylelint-config-standard-scss",
+      "stylelint-order",
+      "stylelint-scss",
+      "@stylistic/stylelint-plugin",
+      "postcss-scss",
+      "cspell"
+    ]
+  },
+  scripts: {
+    lint: "eslint . --cache --cache-location node_modules/.cache/.eslintcache",
+    "lint:fix": 'eslint "src/**/*.{js,ts,jsx,tsx}" --fix --cache --cache-location node_modules/.cache/.eslintcache',
+    format: 'prettier --write "src/**/*.{ts,js,json,jsx,tsx,css,scss}"',
+    "format:check": 'prettier --check "src/**/*.{ts,js,json,jsx,tsx,css,scss}"',
+    stylelint: 'stylelint "src/**/*.{css,scss}"',
+    "stylelint:fix": 'stylelint "src/**/*.{css,scss}" --fix',
+    cspell: 'cspell --gitignore "src/**/*"',
+    "type:check": "tsc --noEmit",
+    "code:check": "<pm> lint && <pm> format:check",
+    "code:fix": "<pm> lint:fix && <pm> format",
+    "code:check:all": "<pm> lint && <pm> format:check && <pm> stylelint && <pm> cspell",
+    "code:fix:all": "<pm> lint:fix && <pm> format && <pm> stylelint:fix"
+  }
+};
+
 // src/presets/fmt/web-vue.ts
 var webVueFmt = {
   name: "web-vue",
@@ -535,8 +663,8 @@ trim_trailing_whitespace = false
     ]
   },
   scripts: {
-    lint: "eslint .",
-    "lint:fix": 'eslint "src/**/*.{js,ts,vue}" --fix',
+    lint: "eslint . --cache --cache-location node_modules/.cache/.eslintcache",
+    "lint:fix": 'eslint "src/**/*.{js,ts,vue}" --fix --cache --cache-location node_modules/.cache/.eslintcache',
     format: 'prettier --write "src/**/*.{ts,js,json,vue,css,scss}"',
     "format:check": 'prettier --check "src/**/*.{ts,js,json,vue,css,scss}"',
     stylelint: 'stylelint "src/**/*.{css,scss,vue}"',
@@ -551,7 +679,14 @@ trim_trailing_whitespace = false
 };
 
 // src/presets/fmt/index.ts
-var FMT_PRESETS = [webVueFmt, electronVueFmt, uniappFmt, nodeFmt, nestFmt];
+var FMT_PRESETS = [
+  webVueFmt,
+  webReactFmt,
+  electronVueFmt,
+  uniappFmt,
+  nodeFmt,
+  nestFmt
+];
 
 // src/utils/logger.ts
 import chalk from "chalk";
@@ -667,7 +802,10 @@ function readJson(filePath) {
   try {
     const raw = fs.readFileSync(filePath, "utf-8");
     return JSON.parse(raw);
-  } catch {
+  } catch (error) {
+    if (error.code === "ENOENT") return null;
+    const message = error instanceof Error ? error.message : String(error);
+    logger.error(`Failed to read or parse ${path.basename(filePath)}: ${message}`);
     return null;
   }
 }
@@ -693,13 +831,20 @@ function generateConfigFile(preset, filename, content, opts) {
   if (action === "skip") return "skipped";
   if (opts.dryRun) return exists ? "overwritten" : "created";
   const resolved = opts.lockfile ? content.replace(/<lockfile>/g, opts.lockfile) : content.replace(/<lockfile>\n?/g, "");
-  writeFile(filepath, resolved);
+  try {
+    writeFile(filepath, resolved);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    logger.error(`Failed to write ${filename}: ${message}`);
+    return null;
+  }
   return exists ? "overwritten" : "created";
 }
 function generateAllFmt(preset, opts) {
   const result = { created: [], overwritten: [], skipped: [] };
   for (const { filename, getContent } of CONFIG_FILES) {
     if (opts.noStylelint && filename.includes("stylelint")) continue;
+    if (opts.noEditorconfig && filename === ".editorconfig") continue;
     const content = getContent(preset);
     if (content === void 0) continue;
     const action = generateConfigFile(preset, filename, content, opts);
@@ -713,6 +858,29 @@ function generateAllFmt(preset, opts) {
 // src/utils/deps.ts
 import path3 from "path";
 import { spawn } from "child_process";
+
+// src/utils/execFileNoThrow.ts
+import { exec } from "child_process";
+import { promisify } from "util";
+var execAsync = promisify(exec);
+async function execFileNoThrow(command, args, options) {
+  const cmdStr = args.length > 0 ? `${command} ${args.join(" ")}` : command;
+  try {
+    const { stdout, stderr } = await execAsync(cmdStr, {
+      cwd: options?.cwd
+    });
+    return { stdout: stdout.trim(), stderr: stderr.trim(), exitCode: 0 };
+  } catch (err) {
+    const error = err;
+    return {
+      stdout: (error.stdout ?? "").trim(),
+      stderr: (error.stderr ?? "").trim(),
+      exitCode: error.code === "ENOENT" ? null : 1
+    };
+  }
+}
+
+// src/utils/deps.ts
 function detectPackageManager(cwd) {
   if (fileExists(`${cwd}/bun.lockb`) || fileExists(`${cwd}/bun.lock`)) return "bun";
   if (fileExists(`${cwd}/pnpm-lock.yaml`)) return "pnpm";
@@ -743,6 +911,37 @@ function getRunPrefix(pm) {
       return "npm run";
   }
 }
+async function fetchPackageVersion(pkg) {
+  const { stdout, exitCode } = await execFileNoThrow("npm", ["view", pkg, "version"]);
+  if (exitCode !== 0 || !stdout) {
+    throw new Error(`Failed to fetch version for "${pkg}" from npm registry.`);
+  }
+  const lines = stdout.split("\n").filter((line) => line.trim().length > 0);
+  return lines[lines.length - 1].trim();
+}
+async function addDepsToManifest(packages, cwd) {
+  const pkgPath = path3.join(cwd, "package.json");
+  const pkg = readJson(pkgPath);
+  if (!pkg) {
+    throw new Error("package.json not found");
+  }
+  const devDeps = pkg.devDependencies ?? {};
+  const missing = packages.filter((p) => !devDeps[p]);
+  if (missing.length === 0) return [];
+  const results = await Promise.all(
+    missing.map(async (pkgName) => {
+      const version = await fetchPackageVersion(pkgName);
+      return { pkgName, version };
+    })
+  );
+  const updatedDevDeps = { ...devDeps };
+  for (const { pkgName, version } of results) {
+    updatedDevDeps[pkgName] = `^${version}`;
+  }
+  pkg.devDependencies = updatedDevDeps;
+  writeJson(pkgPath, pkg);
+  return results.map((r) => r.pkgName);
+}
 async function installDevDeps(packages, cwd, pm) {
   const manager = pm ?? detectPackageManager(cwd);
   const pkg = readJson(path3.join(cwd, "package.json"));
@@ -794,9 +993,12 @@ function isNotStylelintDep(dep) {
   if (dep === "postcss-html" || dep === "postcss-scss") return false;
   return true;
 }
+function isNotEditorconfigDep(dep) {
+  return !dep.includes("editorconfig");
+}
 function registerFmtCommand(program2) {
   const fmt = program2.command("fmt").description("Initialize formatting config with preset");
-  fmt.argument("<preset>").option("-F, --force", "Force overwrite existing files").option("--no-install", "Skip dependency installation").option("--dry-run", "Preview without writing files").option("--no-stylelint", "Skip Stylelint config generation").action(
+  fmt.argument("<preset>").option("-F, --force", "Force overwrite existing files").option("--no-install", "Skip dependency installation").option("--dry-run", "Preview without writing files").option("--stylelint", "Include Stylelint config generation").option("--editorconfig", "Include EditorConfig config generation").action(
     async (presetName, options) => {
       const preset = resolvePreset(FMT_PRESETS, presetName);
       if (!preset) return;
@@ -806,7 +1008,8 @@ function registerFmtCommand(program2) {
         cwd,
         force: options.force ?? false,
         dryRun: options.dryRun ?? false,
-        noStylelint: options.stylelint === false,
+        noStylelint: options.stylelint !== true,
+        noEditorconfig: options.editorconfig !== true,
         lockfile: pm ? getLockfileName(pm) : void 0
       };
       const result = generateAllFmt(preset, opts);
@@ -826,20 +1029,27 @@ function registerFmtCommand(program2) {
       }
       if (!preset.dependencies?.dev) return;
       const devDeps = opts.noStylelint ? preset.dependencies.dev.filter(isNotStylelintDep) : preset.dependencies.dev;
+      const finalDeps = opts.noEditorconfig ? devDeps.filter(isNotEditorconfigDep) : devDeps;
       if (options.install === false) {
-        logger.log(`Dependencies: ${devDeps.join(", ")}`);
+        const added = await addDepsToManifest(finalDeps, cwd);
+        if (added.length > 0) {
+          logger.success(`Added to package.json (skipped install): ${added.join(", ")}`);
+        } else {
+          logger.log("All dependencies already in package.json");
+        }
         return;
       }
       if (opts.dryRun) {
-        logger.log(`[dry-run] Would install: ${devDeps.join(", ")}`);
+        logger.log(`[dry-run] Would install: ${finalDeps.join(", ")}`);
         return;
       }
       try {
         logger.log(`Installing dependencies with ${pm}...`);
-        await installDevDeps(devDeps, cwd, pm);
+        await installDevDeps(finalDeps, cwd, pm);
         logger.success("Dependencies installed successfully");
-      } catch {
-        logger.warn("Dependency installation failed. You can install manually.");
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.warn(`Dependency installation failed: ${message}. You can install manually.`);
       }
     }
   );
@@ -931,19 +1141,109 @@ async function injectScripts(scripts, opts, pm) {
   }
 }
 
-// src/utils/config.ts
+// src/commands/init.ts
+import { select, isCancel, cancel, outro } from "@clack/prompts";
+
+// src/presets/init.ts
+var INIT_TOOLS = [
+  {
+    name: "claude",
+    label: "Claude Code",
+    targetDir: ".claude/skills"
+  },
+  {
+    name: "opencode",
+    label: "OpenCode",
+    targetDir: ".opencode/skills"
+  }
+];
+
+// src/generators/init.ts
 import fs2 from "fs";
-import os from "os";
 import path5 from "path";
+function resolveSkillsDir() {
+  const entryDir = path5.dirname(process.argv[1] ?? "");
+  return path5.resolve(entryDir, "skills");
+}
+function listFilesRecursive(dir, base) {
+  const entries = fs2.readdirSync(dir, { withFileTypes: true });
+  const files = [];
+  for (const entry of entries) {
+    const childBase = `${base}/${entry.name}`;
+    const fullPath = path5.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...listFilesRecursive(fullPath, childBase));
+    } else {
+      files.push(childBase);
+    }
+  }
+  return files;
+}
+function generateInitSkills(targetBaseDir, cwd) {
+  const skillsDir = resolveSkillsDir();
+  if (!fs2.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 = path5.resolve(cwd, targetBaseDir);
+  try {
+    fs2.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 = fs2.existsSync(targetPath) ? listFilesRecursive(targetPath, targetBaseDir) : [];
+  return { copiedFiles, targetDir: targetBaseDir };
+}
+
+// src/commands/init.ts
+function registerInitCommand(program2) {
+  program2.command("init").description("Initialize AI coding tool skills in current project").action(async () => {
+    const toolOptions = INIT_TOOLS.map((tool2) => ({
+      value: tool2.name,
+      label: tool2.label
+    }));
+    const selected = await select({
+      message: "Which AI coding tool do you use?",
+      options: toolOptions
+    });
+    if (isCancel(selected)) {
+      cancel("Operation cancelled.");
+      return;
+    }
+    const tool = INIT_TOOLS.find((t) => t.name === selected);
+    if (!tool) {
+      logger.error(`Unknown tool: ${String(selected)}`);
+      return;
+    }
+    const cwd = process.cwd();
+    const result = generateInitSkills(tool.targetDir, cwd);
+    if (result.copiedFiles.length === 0) {
+      logger.warn("No skill files were copied.");
+      return;
+    }
+    for (const file of result.copiedFiles) {
+      logger.log(`  ${file}`);
+    }
+    outro(`Skills installed to ${tool.targetDir}/`);
+  });
+}
+
+// src/utils/config.ts
+import fs3 from "fs";
+import os from "os";
+import path6 from "path";
 var CONFIG_DIR = ".lux";
 var ENV_FILE = "env.txt";
 function getEnvConfigPath() {
-  return path5.join(os.homedir(), CONFIG_DIR, ENV_FILE);
+  return path6.join(os.homedir(), CONFIG_DIR, ENV_FILE);
 }
 function getEnvConfig() {
   let content;
   try {
-    content = fs2.readFileSync(getEnvConfigPath(), "utf-8");
+    content = fs3.readFileSync(getEnvConfigPath(), "utf-8");
   } catch {
     return {};
   }
@@ -966,7 +1266,7 @@ function setEnvConfig(data) {
 }
 function clearEnvConfig() {
   try {
-    fs2.unlinkSync(getEnvConfigPath());
+    fs3.unlinkSync(getEnvConfigPath());
   } catch {
   }
 }
@@ -988,27 +1288,6 @@ function registerShowCommand(program2) {
   show.command("env").description("Display stored proxy environment variables").action(() => handleShowEnv());
 }
 
-// src/utils/execFileNoThrow.ts
-import { exec } from "child_process";
-import { promisify } from "util";
-var execAsync = promisify(exec);
-async function execFileNoThrow(command, args, options) {
-  const cmdStr = args.length > 0 ? `${command} ${args.join(" ")}` : command;
-  try {
-    const { stdout, stderr } = await execAsync(cmdStr, {
-      cwd: options?.cwd
-    });
-    return { stdout: stdout.trim(), stderr: stderr.trim(), exitCode: 0 };
-  } catch (err) {
-    const error = err;
-    return {
-      stdout: (error.stdout ?? "").trim(),
-      stderr: (error.stderr ?? "").trim(),
-      exitCode: error.code === "ENOENT" ? null : 1
-    };
-  }
-}
-
 // src/utils/version.ts
 import { existsSync, readFileSync } from "fs";
 import { dirname, join } from "path";
@@ -1206,6 +1485,138 @@ var webVueVscode = {
   ]
 };
 
+// src/presets/vscode/web-react.ts
+var webReactVscode = {
+  name: "web-react",
+  description: "VSCode config for React Web",
+  settings: () => ({
+    // ===== Editor Preferences =====
+    "editor.tabSize": 2,
+    "editor.detectIndentation": false,
+    "editor.insertSpaces": true,
+    "editor.renderWhitespace": "selection",
+    "editor.guides.indentation": true,
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "editor.formatOnSave": true,
+    "editor.codeActionsOnSave": {
+      "source.fixAll.eslint": "explicit",
+      "source.fixAll.stylelint": "explicit",
+      "source.organizeImports": "never"
+    },
+    // Cursor & Animation
+    "editor.cursorBlinking": "expand",
+    "editor.cursorSmoothCaretAnimation": "on",
+    "editor.largeFileOptimizations": true,
+    // Code Assistance
+    "editor.inlineSuggest.enabled": true,
+    "editor.suggestSelection": "recentlyUsedByPrefix",
+    "editor.acceptSuggestionOnEnter": "smart",
+    "editor.bracketPairColorization.enabled": true,
+    "editor.autoClosingBrackets": "beforeWhitespace",
+    "editor.autoClosingOvertype": "always",
+    // ===== TypeScript =====
+    "js/ts.inlayHints.enumMemberValues.enabled": true,
+    "js/ts.preferences.preferTypeOnlyAutoImports": true,
+    "js/ts.preferences.includePackageJsonAutoImports": "on",
+    "js/ts.preferences.importModuleSpecifier": "relative",
+    "js/ts.suggest.autoImports": true,
+    "js/ts.tsserver.exclude": ["**/node_modules", "**/dist", "**/.turbo"],
+    // ===== Language-specific Formatting =====
+    "[html]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
+    "[css]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
+    "[scss]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
+    "[typescript]": {
+      "editor.defaultFormatter": "esbenp.prettier-vscode",
+      "editor.formatOnSave": true
+    },
+    "[javascript]": {
+      "editor.defaultFormatter": "esbenp.prettier-vscode",
+      "editor.formatOnSave": true
+    },
+    "[typescriptreact]": {
+      "editor.defaultFormatter": "esbenp.prettier-vscode",
+      "editor.formatOnSave": true
+    },
+    "[javascriptreact]": {
+      "editor.defaultFormatter": "esbenp.prettier-vscode",
+      "editor.formatOnSave": true
+    },
+    "[json]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
+    "[jsonc]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
+    // ===== Terminal =====
+    "terminal.integrated.cursorBlinking": true,
+    "terminal.integrated.tabs.enabled": true,
+    "terminal.integrated.scrollback": 1e4,
+    // ===== File Exclusion =====
+    "files.watcherExclude": {
+      "**/.git/objects/**": true,
+      "**/.git/subtree-cache/**": true,
+      "**/.vscode/**": true,
+      "**/node_modules/**": true,
+      "**/tmp/**": true,
+      "**/dist/**": true,
+      "**/pnpm-lock.yaml": true,
+      "**/package-lock.json": true,
+      "**/bun.lock": true,
+      "**/yarn.lock": true
+    },
+    "search.exclude": {
+      "**/node_modules": true,
+      "**/*.log": true,
+      "**/*.log*": true,
+      "**/dist": true,
+      "**/.git": true,
+      "**/.vscode": false,
+      "**/tmp": true,
+      node_modules: true,
+      "**/pnpm-lock.yaml": true,
+      "**/package-lock.json": true,
+      "**/bun.lock": true,
+      "**/yarn.lock": true
+    },
+    // ===== File Nesting =====
+    "explorer.fileNesting.enabled": true,
+    "explorer.fileNesting.expand": false,
+    "explorer.fileNesting.patterns": {
+      "package.json": "pnpm-lock.yaml,yarn.lock,bun.lock, .gitignore, .browserslistrc, .npmrc, cspell.json,README.md, LICENSE*,.editorconfig",
+      "eslint.config.mjs": ".prettierignore, .prettierrc, .prettierrc.json, .editorconfig",
+      "tsconfig.json": "tsconfig.*.json",
+      "tailwind.config.js": "postcss.config.js",
+      "vite.config.{js,ts}": "vite.*.{js,ts}",
+      ".env": ".env.*"
+    },
+    // ===== ESLint =====
+    "eslint.validate": [
+      "javascript",
+      "typescript",
+      "javascriptreact",
+      "typescriptreact",
+      "html",
+      "markdown",
+      "json",
+      "jsonc",
+      "json5"
+    ],
+    // ===== Stylelint =====
+    "stylelint.enable": true,
+    "stylelint.validate": ["css", "scss"],
+    "stylelint.snippet": ["css", "scss"],
+    "css.validate": false,
+    "less.validate": false,
+    "scss.validate": false,
+    // ===== CSpell =====
+    "cSpell.language": "en"
+  }),
+  extensions: () => [
+    "dbaeumer.vscode-eslint",
+    "esbenp.prettier-vscode",
+    "stylelint.vscode-stylelint",
+    "mrmlnc.vscode-scss",
+    "streetsidesoftware.code-spell-checker",
+    "editorconfig.editorconfig"
+  ]
+};
+
 // src/presets/vscode/electron.ts
 var electronVueVscode = {
   name: "electron-vue",
@@ -1697,6 +2108,7 @@ var goVscode = {
 // src/presets/vscode/index.ts
 var VSCODE_PRESETS = [
   webVueVscode,
+  webReactVscode,
   electronVueVscode,
   uniappVscode,
   nodeVscode,
@@ -1769,20 +2181,45 @@ function generateVscodeSettings(preset, opts) {
   if (existingSettings) {
     const backupPath = `${settingsPath}.bak`;
     if (!fileExists(backupPath)) {
-      writeFile(backupPath, JSON.stringify(existingSettings, null, 2) + "\n");
-      logger.log(`Backed up .vscode/settings.json \u2192 settings.json.bak`);
+      try {
+        writeFile(backupPath, JSON.stringify(existingSettings, null, 2) + "\n");
+        logger.log("Backed up .vscode/settings.json \u2192 settings.json.bak");
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.warn(
+          `Failed to backup .vscode/settings.json: ${message}. Continuing without backup.`
+        );
+      }
+    }
+    try {
+      const merged = mergeVscodeSettings(presetSettings, existingSettings);
+      writeJson(settingsPath, merged);
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error);
+      logger.error(`Failed to write .vscode/settings.json: ${msg}`);
+      return null;
     }
-    const merged = mergeVscodeSettings(presetSettings, existingSettings);
-    writeJson(settingsPath, merged);
     return "overwritten";
   }
-  writeJson(settingsPath, presetSettings);
+  try {
+    writeJson(settingsPath, presetSettings);
+  } catch (error) {
+    const msg = error instanceof Error ? error.message : String(error);
+    logger.error(`Failed to write .vscode/settings.json: ${msg}`);
+    return null;
+  }
   return "created";
 }
 function generateVscodeExtensions(preset, opts) {
   if (opts.dryRun) return "created";
   const extensions = opts.noStylelint ? preset.extensions().filter((ext) => ext !== STYLELINT_EXTENSION) : preset.extensions();
-  writeJson(`${opts.cwd}/.vscode/extensions.json`, { recommendations: extensions });
+  try {
+    writeJson(`${opts.cwd}/.vscode/extensions.json`, { recommendations: extensions });
+  } catch (error) {
+    const msg = error instanceof Error ? error.message : String(error);
+    logger.error(`Failed to write .vscode/extensions.json: ${msg}`);
+    return null;
+  }
   return "created";
 }
 function generateAllVscode(preset, opts) {
@@ -1811,7 +2248,7 @@ function filterStylelintSettings(settings) {
 // src/commands/vscode.ts
 function registerVscodeCommand(program2) {
   const vscode = program2.command("vscode").description("Initialize VSCode config with preset");
-  vscode.argument("<preset>").option("-F, --force", "Force overwrite existing files").option("--dry-run", "Preview without writing files").option("--no-stylelint", "Skip Stylelint settings and extension").action(
+  vscode.argument("<preset>").option("-F, --force", "Force overwrite existing files").option("--dry-run", "Preview without writing files").option("--stylelint", "Include Stylelint settings and extension").action(
     async (presetName, options) => {
       const preset = resolvePreset(VSCODE_PRESETS, presetName);
       if (!preset) return;
@@ -1820,7 +2257,8 @@ function registerVscodeCommand(program2) {
         cwd,
         force: options.force ?? false,
         dryRun: options.dryRun ?? false,
-        noStylelint: options.stylelint === false
+        noStylelint: options.stylelint !== true,
+        noEditorconfig: false
       };
       const result = generateAllVscode(preset, opts);
       const files = [...result.created, ...result.overwritten];
@@ -1921,6 +2359,7 @@ function registerVpnCommand(program2) {
 // src/index.ts
 program.name("lux").description("One-click project formatting & VSCode config CLI").version(getCurrentVersion());
 registerFmtCommand(program);
+registerInitCommand(program);
 registerVscodeCommand(program);
 registerVpnCommand(program);
 registerShowCommand(program);

package/dist/skills/lux/skill.md

@@ -0,0 +1,55 @@
+---
+name: lux
+description: Use when setting up ESLint, Prettier, CSpell, Stylelint, EditorConfig, VSCode workspace settings, proxy env
+---
+
+## fmt — generate lint/format configs
+
+```bash
+lux fmt <preset> [--stylelint] [--editorconfig]
+lux fmt list
+```
+
+- `--force` — overwrite existing config files (default: skip)
+- `--dry-run` — preview what would be generated, write nothing
+- `--no-install` — write deps to package.json but skip install
+
+Presets: `web-vue` `web-react` `electron-vue` `uniapp` `node` `nest`
+
+## vscode — generate editor settings
+
+```bash
+lux vscode <preset> [--dry-run]
+lux vscode list
+```
+
+Presets: `web-vue` `web-react` `electron-vue` `uniapp` `node` `nest` `go`
+
+## init — lux skill（human interaction）
+
+```bash
+lux init
+```
+
+## vpn — proxy clipboard helper
+
+```bash
+lux vpn cmd       # copy CMD proxy commands
+lux vpn pw        # copy PowerShell proxy commands
+lux vpn bash      # copy Bash proxy commands
+```
+
+## env — proxy env management
+
+```bash
+lux set https_proxy=http://127.0.0.1:7890
+lux unset         # clear all proxy config
+lux show env      # show stored proxy env
+```
+
+## update — self-update
+
+```bash
+lux update        # update to latest
+lux update --check
+```

package/package.json

@@ -1,6 +1,6 @@
 {
    "name": "@luxkit/cli",
-   "version": "1.0.8",
+   "version": "1.1.0",
    "description": "One-click project formatting & VSCode config CLI",
    "type": "module",
    "bin": {
@@ -13,27 +13,39 @@
       "access": "public"
    },
    "scripts": {
-      "build": "tsup",
+      "build": "tsup && node scripts/copy-assets.mjs",
       "dev": "tsup --watch",
       "lint": "eslint .",
-      "lint:fix": "eslint \"src/**/*.{js,ts}\" --fix",
       "format": "prettier --write \"src/**/*.{ts,js,json}\"",
-      "format:check": "prettier --check \"src/**/*.{ts,js,json}\"",
       "cspell": "cspell --gitignore \"src/**/*\"",
+      "format:check": "prettier --check \"src/**/*.{ts,js,json}\"",
       "type:check": "tsc --noEmit",
       "code:check": "bun run lint && bun run format:check",
-      "code:fix": "bun run lint:fix && bun run format",
       "code:check:all": "bun run lint && bun run format:check && bun run cspell",
+      "lint:fix": "eslint \"src/**/*.{js,ts}\" --fix",
+      "code:fix": "bun run lint:fix && bun run format",
       "code:fix:all": "bun run lint:fix && bun run format",
       "prepublishOnly": "cross-env NODE_ENV=production bun run build",
       "test": "vitest run",
       "test:watch": "vitest",
       "test:coverage": "vitest run --coverage"
    },
-   "keywords": [],
-   "author": "",
+   "keywords": [
+      "cli",
+      "eslint",
+      "prettier",
+      "stylelint",
+      "cspell",
+      "editorconfig",
+      "vscode",
+      "formatting",
+      "config-generator",
+      "preset"
+   ],
+   "author": "TTT1231",
    "license": "ISC",
    "dependencies": {
+      "@clack/prompts": "^1.4.0",
       "chalk": "5",
       "commander": "^14.0.3"
    },