@luxkit/cli 1.1.1 → 1.1.2

package/README.md

@@ -18,48 +18,29 @@
 
 ### 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, CSpell, EditorConfig files and VSCode settings from battle-tested presets — with smart merge and conflict resolution.
+`lux` is a CLI tool that sets up project lint configs and VSCode workspace settings with a single command — saving you from repetitive configuration overhead and wasted tokens. It generates ESLint, Prettier, CSpell, Stylelint，EditorConfig configs and VSCode settings from presets — with smart merge and conflict resolution. Configurations can be customized to your needs.
 
 <div align="center">
   <img src="https://github.com/TTT1231/lux/blob/main/demo.gif?raw=true" alt="lux demo" width="640" />
 </div>
 
-### ✨ Key Highlights
-
-| 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 />
-
 ### Quick Start
 
 ```bash
 # Install globally (pick your package manager)
 npm install -g @luxkit/cli
-# or
-bun add -g @luxkit/cli
 
-# Initialize formatting configs
-lux fmt web-vue          # Generate ESLint, Prettier, CSpell
+# Initialize skill and preset
+lux init && lux init --preset
+
+# Lint usage
+lux fmt web-vue                # Configure web-vue lint — 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
+# VSCode config (optional)
+# If you've already configured globally, you can skip this
+lux vscode web-vue       # Generate .vscode/settings.json + extensions.json (per-project)
 
 # List available presets
 lux fmt list
@@ -68,15 +49,26 @@ lux vscode list
 
 <br />
 
+### Custom Configuration
+
+```bash
+# Check if skill and presets are initialized (skip if already done)
+lux init && lux init --preset
+
+# Use an agent to customize a preset
+/lux help me configure my web react lint template to fit my development project style
+```
+
 ### 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 fmt <preset>`          | Initialize lint configs                                           |
+| `lux fmt list`              | List available lint presets                                       |
+| `lux vscode <preset>`       | Configure VSCode settings (per-project)                           |
 | `lux vscode list`           | List available VSCode presets                                     |
-| `lux init`                  | Initialize AI coding tool skills in current project               |
+| `lux init`                  | Initialize skills                                                 |
+| `lux init --preset`         | Initialize all presets                                            |
 | `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                        |
@@ -88,19 +80,6 @@ lux vscode list
 
 <br />
 
-### Available Presets
-
-| 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 />
-
 ### Options
 
 ```bash
@@ -147,37 +126,6 @@ lux fmt web-vue
 
 <br />
 
-### Tech Stack
-
-| Category | Technology                                 |
-| :------- | :----------------------------------------- |
-| Language | TypeScript 6.0 (ESM-only)                  |
-| Runtime  | Node.js 18+                                |
-| Build    | tsup                                       |
-| Test     | Vitest (unit + acceptance)                 |
-| CLI      | Commander.js                               |
-| Output   | Chalk                                      |
-| Bundle   | Minimal runtime deps (chalk + commander + @clack/prompts) |
-
-<br />
-
-### Development
-
-```bash
-git clone git@github.com:TTT1231/lux.git
-cd lux
-bun install
-
-bun link                  # Register `lux` globally for testing
-lux fmt web-vue          # Test it on any project
-
-bun test                  # Run tests
-bun build                 # Build to dist/
-bun code:check:all        # lint + format + spell check
-```
-
-<br />
-
 ### 🤝 Support
 
 If you have any questions or run into issues, feel free to [open an issue](https://github.com/TTT1231/lux/issues) on GitHub.

package/dist/index.js

@@ -12,13 +12,13 @@ var electronVueFmt = {
   name: "electron-vue",
   description: "Vue 3 + Electron desktop app",
   eslint: () => `import withVue from '@vue/eslint-config-typescript'
-import withPrettier from '@vue/eslint-config-prettier/skip-formatting'
+import prettierConfig from '@vue/eslint-config-prettier/skip-formatting'
 import pluginVue from 'eslint-plugin-vue'
 
 export default [
   ...pluginVue.configs['flat/recommended'],
   ...withVue(),
-  ...withPrettier(),
+  prettierConfig,
   {
     rules: {
       'vue/multi-word-component-names': 'off',
@@ -79,7 +79,8 @@ out/
       version: "0.2",
       language: "en,en-US",
       allowCompoundWords: true,
-      words: ["vite", "pinia", "vueuse", "unplugin", "electron", "electron-builder"]
+      words: ["vite", "pinia", "vueuse", "unplugin", "electron", "electron-builder"],
+      ignorePaths: ["**/*.svg", "**/*.png"]
     },
     null,
     2
@@ -115,18 +116,9 @@ trim_trailing_whitespace = false
     ]
   },
   scripts: {
-    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}"',
-    "stylelint:fix": 'stylelint "src/**/*.{css,scss,vue}" --fix',
-    cspell: 'cspell --gitignore "src/**/*"',
-    "type:check": "vue-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"
+    lint: 'eslint . --cache --cache-location node_modules/.cache/eslint && cspell --cache --cache-location node_modules/.cache/cspell --gitignore "src/**/*" && vue-tsc --noEmit && stylelint "src/**/*.{css,scss,vue}" --cache --cache-strategy content --cache-location node_modules/.cache/stylelint/',
+    "lint:fix": 'eslint . --cache --cache-location node_modules/.cache/eslint --fix && stylelint "src/**/*.{css,scss,vue}" --fix --cache --cache-strategy content --cache-location node_modules/.cache/stylelint/',
+    format: 'prettier --write "src/**/*.{ts,js,json,vue,css,scss}"'
   }
 };
 
@@ -163,7 +155,8 @@ coverage/
       version: "0.2",
       language: "en,en-US",
       allowCompoundWords: true,
-      words: ["nestjs", "typeorm", "dtos"]
+      words: ["nestjs", "typeorm", "dtos"],
+      ignorePaths: ["**/*.svg", "**/*.png"]
     },
     null,
     2
@@ -184,12 +177,10 @@ trim_trailing_whitespace = false
   dependencies: {
     dev: ["prettier", "cspell"]
   },
-  // NestJS: only append new scripts, don't conflict with existing ones
   scripts: {
-    cspell: 'cspell --gitignore "src/**/*"',
-    "type:check": "tsc --noEmit",
-    "code:check": "<pm> lint && <pm> format:check",
-    "code:check:all": "<pm> lint && <pm> format:check && <pm> cspell"
+    lint: 'eslint "{src,apps,libs,test}/**/*.ts" --cache --cache-location node_modules/.cache/eslint && cspell --cache --cache-location node_modules/.cache/cspell --gitignore "src/**/*" && tsc --noEmit',
+    "lint:fix": 'eslint "{src,apps,libs,test}/**/*.ts" --cache --cache-location node_modules/.cache/eslint --fix',
+    format: 'prettier --write "src/**/*.{ts,js,json}"'
   }
 };
 
@@ -268,7 +259,8 @@ coverage/
       version: "0.2",
       language: "en,en-US",
       allowCompoundWords: true,
-      words: []
+      words: [],
+      ignorePaths: ["**/*.svg", "**/*.png"]
     },
     null,
     2
@@ -298,16 +290,9 @@ trim_trailing_whitespace = false
     ]
   },
   scripts: {
-    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/**/*"',
-    "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> cspell",
-    "code:fix:all": "<pm> lint:fix && <pm> format"
+    lint: 'eslint . --cache --cache-location node_modules/.cache/eslint && cspell --cache --cache-location node_modules/.cache/cspell --gitignore "src/**/*" && tsc --noEmit',
+    "lint:fix": "eslint . --cache --cache-location node_modules/.cache/eslint --fix",
+    format: 'prettier --write "src/**/*.{ts,js,json}"'
   }
 };
 
@@ -316,13 +301,13 @@ var uniappFmt = {
   name: "uniapp",
   description: "Vue 3 + UniApp WeChat mini program",
   eslint: () => `import withVue from '@vue/eslint-config-typescript'
-import withPrettier from '@vue/eslint-config-prettier/skip-formatting'
+import prettierConfig from '@vue/eslint-config-prettier/skip-formatting'
 import pluginVue from 'eslint-plugin-vue'
 
 export default [
   ...pluginVue.configs['flat/recommended'],
   ...withVue(),
-  ...withPrettier(),
+  prettierConfig,
   {
     rules: {
       'vue/multi-word-component-names': 'off',
@@ -381,7 +366,8 @@ unpackage/
       version: "0.2",
       language: "en,en-US",
       allowCompoundWords: true,
-      words: ["vite", "pinia", "vueuse", "unplugin", "uniapp"]
+      words: ["vite", "pinia", "vueuse", "unplugin", "uniapp"],
+      ignorePaths: ["**/*.svg", "**/*.png"]
     },
     null,
     2
@@ -417,18 +403,9 @@ trim_trailing_whitespace = false
     ]
   },
   scripts: {
-    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}"',
-    "stylelint:fix": 'stylelint "src/**/*.{css,scss,vue}" --fix',
-    cspell: 'cspell --gitignore "src/**/*"',
-    "type:check": "vue-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"
+    lint: 'eslint . --cache --cache-location node_modules/.cache/eslint && cspell --cache --cache-location node_modules/.cache/cspell --gitignore "src/**/*" && vue-tsc --noEmit && stylelint "src/**/*.{css,scss,vue}" --cache --cache-strategy content --cache-location node_modules/.cache/stylelint/',
+    "lint:fix": 'eslint . --cache --cache-location node_modules/.cache/eslint --fix && stylelint "src/**/*.{css,scss,vue}" --fix --cache --cache-strategy content --cache-location node_modules/.cache/stylelint/',
+    format: 'prettier --write "src/**/*.{ts,js,json,vue,css,scss}"'
   }
 };
 
@@ -507,7 +484,8 @@ dist/
       version: "0.2",
       language: "en,en-US",
       allowCompoundWords: true,
-      words: ["vite", "react", "zustand", "tanstack"]
+      words: ["vite", "react", "zustand", "tanstack"],
+      ignorePaths: ["**/*.svg", "**/*.png"]
     },
     null,
     2
@@ -545,18 +523,9 @@ trim_trailing_whitespace = false
     ]
   },
   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"
+    lint: 'eslint . --cache --cache-location node_modules/.cache/eslint && cspell --cache --cache-location node_modules/.cache/cspell --gitignore "src/**/*" && tsc --noEmit && stylelint "src/**/*.{css,scss}" --cache --cache-strategy content --cache-location node_modules/.cache/stylelint/',
+    "lint:fix": 'eslint . --cache --cache-location node_modules/.cache/eslint --fix && stylelint "src/**/*.{css,scss}" --fix --cache --cache-strategy content --cache-location node_modules/.cache/stylelint/',
+    format: 'prettier --write "src/**/*.{ts,js,json,jsx,tsx,css,scss}"'
   }
 };
 
@@ -565,13 +534,13 @@ var webVueFmt = {
   name: "web-vue",
   description: "Vue 3 Web frontend (Vite + Vue + TypeScript)",
   eslint: () => `import withVue from '@vue/eslint-config-typescript'
-import withPrettier from '@vue/eslint-config-prettier/skip-formatting'
+import prettierConfig from '@vue/eslint-config-prettier/skip-formatting'
 import pluginVue from 'eslint-plugin-vue'
 
 export default [
   ...pluginVue.configs['flat/recommended'],
   ...withVue(),
-  ...withPrettier(),
+  prettierConfig,
   {
     rules: {
       'vue/multi-word-component-names': 'off',
@@ -628,7 +597,8 @@ dist/
       version: "0.2",
       language: "en,en-US",
       allowCompoundWords: true,
-      words: ["vite", "pinia", "vueuse", "unplugin"]
+      words: ["vite", "pinia", "vueuse", "unplugin"],
+      ignorePaths: ["**/*.svg", "**/*.png"]
     },
     null,
     2
@@ -664,18 +634,9 @@ trim_trailing_whitespace = false
     ]
   },
   scripts: {
-    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}"',
-    "stylelint:fix": 'stylelint "src/**/*.{css,scss,vue}" --fix',
-    cspell: 'cspell --gitignore "src/**/*"',
-    "type:check": "vue-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"
+    lint: 'eslint . --cache --cache-location node_modules/.cache/eslint && cspell --cache --cache-location node_modules/.cache/cspell --gitignore "src/**/*" && vue-tsc --noEmit && stylelint "src/**/*.{css,scss,vue}" --cache --cache-strategy content --cache-location node_modules/.cache/stylelint/',
+    "lint:fix": 'eslint . --cache --cache-location node_modules/.cache/eslint --fix && stylelint "src/**/*.{css,scss,vue}" --fix --cache --cache-strategy content --cache-location node_modules/.cache/stylelint/',
+    format: 'prettier --write "src/**/*.{ts,js,json,vue,css,scss}"'
   }
 };
 
@@ -1113,6 +1074,15 @@ function materializeVscodePreset(cwd, presetName) {
   }
   logger.log(`Local preset created at ${presetDir}`);
 }
+function materializeVscodePresetFromBuiltin(presetName, preset) {
+  const presetDir = getLocalPresetDir("vscode", presetName);
+  ensureDir(presetDir);
+  const settings = preset.settings();
+  writeJson(path4.join(presetDir, "settings.json"), settings);
+  const extensions = preset.extensions();
+  writeJson(path4.join(presetDir, "extensions.json"), { recommendations: extensions });
+  logger.log(`Local preset created at ${presetDir}`);
+}
 var InvalidPackageJsonError = class extends Error {
   constructor(filePath) {
     super(`package.json exists but is not valid JSON: ${filePath}`);
@@ -1220,7 +1190,9 @@ function applyLocalVscodePreset(cwd, presetName, opts) {
     if (extensionsData) {
       let presetRecommendations = extensionsData.recommendations ?? [];
       if (opts.noStylelint) {
-        presetRecommendations = presetRecommendations.filter((ext) => ext !== STYLELINT_EXTENSION);
+        presetRecommendations = presetRecommendations.filter(
+          (ext) => ext !== STYLELINT_EXTENSION
+        );
       }
       if (opts.dryRun) {
         result.created.push(".vscode/extensions.json");
@@ -1273,8 +1245,10 @@ function mergeTemplateIntoProject(templatePkg, projectPkg, pm, opts, result) {
     const existingScripts = merged.scripts ?? {};
     const newScripts = { ...existingScripts };
     for (const [key, value] of Object.entries(templatePkg.scripts)) {
-      if (opts.noStylelint && key.startsWith("stylelint")) continue;
-      const resolved = value.replace(/<pm>/g, prefix);
+      let resolved = value.replace(/<pm>/g, prefix);
+      if (opts.noStylelint) {
+        resolved = resolved.replace(/\s*&&\s*stylelint\s+"[^"]*".*/g, "");
+      }
       if (existingScripts[key] !== void 0 && !opts.force) {
         result.scriptsSkipped++;
         if (opts.dryRun) {
@@ -1325,8 +1299,7 @@ function resolveLocalDeps(deps) {
 function filterStylelintScripts(scripts) {
   const filtered = {};
   for (const [key, value] of Object.entries(scripts)) {
-    if (key.startsWith("stylelint")) continue;
-    filtered[key] = value.replace(/\s*&&\s*<pm>\s+stylelint\S*/g, "");
+    filtered[key] = value.replace(/\s*&&\s*stylelint\s+"[^"]*".*/g, "");
   }
   return filtered;
 }
@@ -1419,18 +1392,26 @@ async function executeLocalPath(cwd, presetName, options) {
   const existingDeps = projectPkg.devDependencies ?? {};
   const missing = depsToInstall.filter((dep) => !existingDeps[dep]);
   if (missing.length === 0) return;
-  if (options.install === false) {
-    const resolved = resolveLocalDeps(templatePkg.devDependencies);
-    const added = await addDepsToManifest(resolved, cwd);
-    if (added.length > 0) {
-      logger.success(`Added to package.json (skipped install): ${added.join(", ")}`);
-    } else {
-      logger.log("All dependencies already in package.json");
-    }
+  if (opts.dryRun) {
+    logger.log(`[dry-run] Would add to package.json: ${missing.join(", ")}`);
     return;
   }
-  if (opts.dryRun) {
-    logger.log(`[dry-run] Would install: ${missing.join(", ")}`);
+  if (options.install === false) {
+    try {
+      const filteredTemplateDeps = Object.fromEntries(
+        Object.entries(templatePkg.devDependencies).filter(([k]) => missing.includes(k))
+      );
+      const resolved = resolveLocalDeps(filteredTemplateDeps);
+      const added = await addDepsToManifest(resolved, cwd);
+      if (added.length > 0) {
+        logger.success(`Added to package.json (skipped install): ${added.join(", ")}`);
+      } else {
+        logger.log("All dependencies already in package.json");
+      }
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      logger.warn(`Failed to fetch versions: ${message}. You can add dependencies manually.`);
+    }
     return;
   }
   try {
@@ -1478,17 +1459,22 @@ async function executeBuiltinPath(cwd, presetName, preset, options) {
   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) {
-    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");
-    }
+  if (opts.dryRun) {
+    logger.log(`[dry-run] Would add to package.json: ${finalDeps.join(", ")}`);
     return;
   }
-  if (opts.dryRun) {
-    logger.log(`[dry-run] Would install: ${finalDeps.join(", ")}`);
+  if (options.install === false) {
+    try {
+      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");
+      }
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      logger.warn(`Failed to fetch versions: ${message}. You can add dependencies manually.`);
+    }
     return;
   }
   try {
@@ -1622,206 +1608,6 @@ var INIT_TOOLS = [
   }
 ];
 
-// src/generators/init.ts
-import fs4 from "fs";
-import path6 from "path";
-function resolveSkillsDir() {
-  const entryDir = path6.dirname(process.argv[1] ?? "");
-  return path6.resolve(entryDir, "skills");
-}
-function listFilesRecursive(dir, base) {
-  const entries = fs4.readdirSync(dir, { withFileTypes: true });
-  const files = [];
-  for (const entry of entries) {
-    const childBase = `${base}/${entry.name}`;
-    const fullPath = path6.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 (!fs4.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);
-  try {
-    fs4.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) : [];
-  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 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();
-  const entries = Object.entries(config);
-  if (entries.length === 0) {
-    logger.log("No env config.");
-    return;
-  }
-  for (const [key, value] of entries) {
-    logger.log(`${key}="${value}"`);
-  }
-}
-function registerShowCommand(program2) {
-  const show = program2.command("show");
-  show.command("env").description("Display stored proxy environment variables").action(() => handleShowEnv());
-}
-
-// src/utils/version.ts
-import { existsSync, readFileSync } from "fs";
-import { dirname, join } from "path";
-import { fileURLToPath } from "url";
-var PACKAGE_NAME = "@luxkit/cli";
-var cachedVersion;
-function getCurrentVersion() {
-  if (cachedVersion) return cachedVersion;
-  const __dirname = dirname(fileURLToPath(import.meta.url));
-  const candidates = [
-    join(__dirname, "..", "package.json"),
-    join(__dirname, "..", "..", "package.json")
-  ];
-  const pkgPath = candidates.find((p) => existsSync(p));
-  if (!pkgPath) {
-    throw new Error("Cannot locate package.json for version reading");
-  }
-  const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
-  cachedVersion = pkg.version;
-  return cachedVersion;
-}
-
-// src/commands/update.ts
-var GLOBAL_UPDATE_CMDS = {
-  npm: ["npm", ["install", "-g", `${PACKAGE_NAME}@latest`]],
-  bun: ["bun", ["install", "-g", `${PACKAGE_NAME}@latest`]]
-};
-function detectGlobalPackageManager() {
-  return process.execPath.toLowerCase().includes("bun") ? "bun" : "npm";
-}
-async function fetchLatestVersion() {
-  const { stdout, exitCode } = await execFileNoThrow("npm", ["view", PACKAGE_NAME, "version"]);
-  if (exitCode !== 0 || !stdout) {
-    throw new Error(`Failed to fetch latest version from npm registry.`);
-  }
-  const lines = stdout.split("\n").filter((line) => line.trim().length > 0);
-  return lines[lines.length - 1].trim();
-}
-async function performUpdate(pm) {
-  const [command, args] = GLOBAL_UPDATE_CMDS[pm];
-  const { exitCode, stderr } = await execFileNoThrow(command, args);
-  if (exitCode !== 0) {
-    const hint = /EACCES|permission/i.test(stderr) ? "\nTry running with elevated privileges (e.g. sudo)." : "";
-    throw new Error(`Update failed: ${stderr}${hint}`);
-  }
-}
-function registerUpdateCommand(program2) {
-  program2.command("update").description("Update @luxkit/cli to the latest version").option("--check", "Only check for updates without installing").action(async (options) => {
-    try {
-      const current = getCurrentVersion();
-      const latest = await fetchLatestVersion();
-      if (current === latest) {
-        logger.log(`Already up to date (v${current})`);
-        return;
-      }
-      if (options.check) {
-        logger.log(`Update available: v${current} \u2192 v${latest}`);
-        return;
-      }
-      const pm = detectGlobalPackageManager();
-      await performUpdate(pm);
-      logger.log(`Updated to v${latest}`);
-    } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      logger.error(message);
-      logger.warn(`You can also update manually: npm install -g ${PACKAGE_NAME}@latest`);
-    }
-  });
-}
-
 // src/presets/vscode/web-vue.ts
 var webVueVscode = {
   name: "web-vue",
@@ -2580,6 +2366,226 @@ var VSCODE_PRESETS = [
   goVscode
 ];
 
+// src/generators/init.ts
+import fs4 from "fs";
+import path6 from "path";
+function resolveSkillsDir() {
+  const entryDir = path6.dirname(process.argv[1] ?? "");
+  return path6.resolve(entryDir, "skills");
+}
+function listFilesRecursive(dir, base) {
+  const entries = fs4.readdirSync(dir, { withFileTypes: true });
+  const files = [];
+  for (const entry of entries) {
+    const childBase = `${base}/${entry.name}`;
+    const fullPath = path6.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 (!fs4.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);
+  try {
+    fs4.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) : [];
+  return { copiedFiles, targetDir: targetBaseDir };
+}
+
+// src/commands/init.ts
+function registerInitCommand(program2) {
+  program2.command("init").description("Initialize skills or materialize presets").option("--preset", "Materialize all presets to ~/.lux/preset/ without writing to cwd").action(async (options) => {
+    if (options.preset) {
+      materializeAllPresets();
+      return;
+    }
+    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}/`);
+  });
+}
+function materializeAllPresets() {
+  const opts = {
+    cwd: process.cwd(),
+    force: false,
+    dryRun: false,
+    noStylelint: false,
+    noEditorconfig: false
+  };
+  for (const preset of FMT_PRESETS) {
+    materializeFmtPreset(preset.name, preset, opts);
+  }
+  for (const preset of VSCODE_PRESETS) {
+    materializeVscodePresetFromBuiltin(preset.name, preset);
+  }
+  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();
+  const entries = Object.entries(config);
+  if (entries.length === 0) {
+    logger.log("No env config.");
+    return;
+  }
+  for (const [key, value] of entries) {
+    logger.log(`${key}="${value}"`);
+  }
+}
+function registerShowCommand(program2) {
+  const show = program2.command("show");
+  show.command("env").description("Display stored proxy environment variables").action(() => handleShowEnv());
+}
+
+// src/utils/version.ts
+import { existsSync, readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+var PACKAGE_NAME = "@luxkit/cli";
+var cachedVersion;
+function getCurrentVersion() {
+  if (cachedVersion) return cachedVersion;
+  const __dirname = dirname(fileURLToPath(import.meta.url));
+  const candidates = [
+    join(__dirname, "..", "package.json"),
+    join(__dirname, "..", "..", "package.json")
+  ];
+  const pkgPath = candidates.find((p) => existsSync(p));
+  if (!pkgPath) {
+    throw new Error("Cannot locate package.json for version reading");
+  }
+  const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+  cachedVersion = pkg.version;
+  return cachedVersion;
+}
+
+// src/commands/update.ts
+var GLOBAL_UPDATE_CMDS = {
+  npm: ["npm", ["install", "-g", `${PACKAGE_NAME}@latest`]],
+  bun: ["bun", ["install", "-g", `${PACKAGE_NAME}@latest`]]
+};
+function detectGlobalPackageManager() {
+  return process.execPath.toLowerCase().includes("bun") ? "bun" : "npm";
+}
+async function fetchLatestVersion() {
+  const { stdout, exitCode } = await execFileNoThrow("npm", ["view", PACKAGE_NAME, "version"]);
+  if (exitCode !== 0 || !stdout) {
+    throw new Error(`Failed to fetch latest version from npm registry.`);
+  }
+  const lines = stdout.split("\n").filter((line) => line.trim().length > 0);
+  return lines[lines.length - 1].trim();
+}
+async function performUpdate(pm) {
+  const [command, args] = GLOBAL_UPDATE_CMDS[pm];
+  const { exitCode, stderr } = await execFileNoThrow(command, args);
+  if (exitCode !== 0) {
+    const hint = /EACCES|permission/i.test(stderr) ? "\nTry running with elevated privileges (e.g. sudo)." : "";
+    throw new Error(`Update failed: ${stderr}${hint}`);
+  }
+}
+function registerUpdateCommand(program2) {
+  program2.command("update").description("Update @luxkit/cli to the latest version").option("--check", "Only check for updates without installing").action(async (options) => {
+    try {
+      const current = getCurrentVersion();
+      const latest = await fetchLatestVersion();
+      if (current === latest) {
+        logger.log(`Already up to date (v${current})`);
+        return;
+      }
+      if (options.check) {
+        logger.log(`Update available: v${current} \u2192 v${latest}`);
+        return;
+      }
+      const pm = detectGlobalPackageManager();
+      await performUpdate(pm);
+      logger.log(`Updated to v${latest}`);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      logger.error(message);
+      logger.warn(`You can also update manually: npm install -g ${PACKAGE_NAME}@latest`);
+    }
+  });
+}
+
 // src/generators/vscode.ts
 var STYLELINT_SETTINGS_PREFIXES2 = [
   "stylelint.",

package/dist/skills/lux/references/custom-preset-setting.md

@@ -0,0 +1,67 @@
+# Custom Preset Configuration
+
+> ⚠️ **Always use `lux init --preset` to initialize presets.** Running `lux fmt` / `lux vscode` directly generates config files in cwd and requires `package.json` — only use in real project directories.
+
+## Quick Start
+
+```bash
+lux init --preset                # materialize all built-in presets to ~/.lux/preset/
+```
+
+After materialization, edit files under `~/.lux/preset/<type>/<preset-name>/` to customize. Changes take effect on the next `lux fmt` / `lux vscode` run.
+
+`lux init --preset` can be run repeatedly — each run overwrites with built-in defaults. To reset a single preset, use `lux fmt <name> --reset` or `lux vscode <name> --reset` (deletes local preset dir only; re-generated from built-in on next run).
+
+## Storage Location
+
+`~/.lux/preset/` (i.e. `os.homedir()/.lux/preset/`). Override with `LUX_HOME` env var.
+
+```
+~/.lux/preset/
+├── fmt/                  # fmt presets (web-vue, web-react, electron-vue, uniapp, node, nest)
+└── vscode/               # vscode presets (same + go)
+```
+
+## File Reference
+
+### fmt preset
+
+| File                   | Description                                    |
+| :--------------------- | :--------------------------------------------- |
+| `eslint.config.mjs`    | ESLint flat config                             |
+| `.prettierrc`          | Prettier JSON config                           |
+| `.prettierignore`      | Prettier ignore rules                          |
+| `stylelint.config.mjs` | Stylelint config                               |
+| `.stylelintignore`     | Stylelint ignore rules                         |
+| `cspell.json`          | CSpell dictionary config                       |
+| `.editorconfig`        | EditorConfig config                            |
+| `package.json`         | Template with `devDependencies` and `scripts`  |
+
+### vscode preset
+
+| File              | Description                 |
+| :---------------- | :-------------------------- |
+| `settings.json`   | VSCode workspace settings   |
+| `extensions.json` | VSCode extension recommendations |
+
+## Template Placeholders (fmt preset)
+
+| Placeholder | Replaced with |
+| :---------- | :------------ |
+| `<pm>`      | Package manager prefix (`bun run` / `pnpm run` / `npm run`) |
+| `<lockfile>` | Project lockfile name (`bun.lock` / `pnpm-lock.yaml` etc.) |
+| `"<latest>"` | Resolved to latest version at install time, or pin like `"3.3.0"` |
+
+## Workflow
+
+```
+lux init --preset
+  → materialize all built-in presets to ~/.lux/preset/ (no cwd writes)
+
+lux fmt web-vue (in target project)
+  → local preset exists → use local version (with custom edits)
+  → local preset missing → generate from built-in + materialize (also writes to cwd)
+
+lux vscode web-vue (in target project)
+  → same as above
+```

package/dist/skills/lux/skill.md

@@ -13,6 +13,7 @@ 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
+- `--reset` — reset local preset, re-materialize from built-in defaults
 
 Presets: `web-vue` `web-react` `electron-vue` `uniapp` `node` `nest`
 
@@ -23,12 +24,17 @@ lux vscode <preset> [--dry-run]
 lux vscode list
 ```
 
+- `--force` — overwrite existing settings (default: skip)
+- `--dry-run` — preview what would be generated, write nothing
+- `--reset` — reset local preset, re-materialize from built-in defaults
+
 Presets: `web-vue` `web-react` `electron-vue` `uniapp` `node` `nest` `go`
 
-## init — lux skill（human interaction）
+## init — initialize skills or presets
 
 ```bash
-lux init
+lux init                  # interactively select AI tool, copy skill files to project
+lux init --preset         # materialize all built-in presets to ~/.lux/preset/ (no cwd writes, no package.json required)
 ```
 
 ## vpn — proxy clipboard helper
@@ -53,3 +59,7 @@ lux show env      # show stored proxy env
 lux update        # update to latest
 lux update --check
 ```
+
+## Custom presets
+
+To customize preset rules, see `references/custom-preset-setting.md`.

package/package.json

@@ -1,6 +1,6 @@
 {
    "name": "@luxkit/cli",
-   "version": "1.1.1",
+   "version": "1.1.2",
    "description": "One-click project formatting & VSCode config CLI",
    "type": "module",
    "bin": {
@@ -15,16 +15,9 @@
    "scripts": {
       "build": "tsup && node scripts/copy-assets.mjs",
       "dev": "tsup --watch",
-      "lint": "eslint .",
+      "lint": "eslint . --cache --cache-location node_modules/.cache/eslint && cspell --cache --cache-location node_modules/.cache/cspell --gitignore \"src/**/*\" && tsc --noEmit",
+      "lint:fix": "eslint . --cache --cache-location node_modules/.cache/eslint --fix",
       "format": "prettier --write \"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: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",