zcf 2.9.7 → 2.9.9

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import cac from 'cac';
 import ansis from 'ansis';
-import { J as getTranslation, Z as ZCF_CONFIG_FILE, h as SUPPORTED_LANGS, K as addNumbersToChoices, j as LANG_LABELS, N as updateZcfConfig, o as openSettingsJson, b as importRecommendedPermissions, a as importRecommendedEnv, O as readZcfConfig, x as applyAiLanguageDirective, P as configureAiPersonality, v as getExistingModelConfig, u as updateDefaultModel, Q as isWindows, z as readMcpConfig, G as fixWindowsMcpConfig, B as writeMcpConfig, R as selectMcpServices, D as backupMcpConfig, M as MCP_SERVICES, F as buildMcpServerConfig, E as mergeMcpServers, w as getExistingApiConfig, T as formatApiKeyDisplay, H as addCompletedOnboarding, U as modifyApiConfigPartially, V as isCcrInstalled, W as installCcr, X as setupCcrConfiguration, Y as validateApiKey, r as configureApi, _ as readZcfConfigAsync, I as I18N, $ as readCcrConfig, a0 as configureCcrFeature, a1 as handleExitPromptError, a2 as handleGeneralError, a3 as displayBanner, a4 as selectScriptLanguage, a5 as resolveAiOutputLanguage, a6 as updatePromptOnly, a7 as selectAndInstallWorkflows, a8 as version, a9 as checkAndUpdateTools, aa as displayBannerWithInfo, i as init } from './chunks/simple-config.mjs';
+import { J as getTranslation, Z as ZCF_CONFIG_FILE, h as SUPPORTED_LANGS, K as addNumbersToChoices, j as LANG_LABELS, N as updateZcfConfig, o as openSettingsJson, b as importRecommendedPermissions, a as importRecommendedEnv, O as readZcfConfig, x as applyAiLanguageDirective, P as configureAiPersonality, v as getExistingModelConfig, u as updateDefaultModel, Q as isWindows, z as readMcpConfig, G as fixWindowsMcpConfig, B as writeMcpConfig, R as selectMcpServices, D as backupMcpConfig, M as MCP_SERVICES, F as buildMcpServerConfig, E as mergeMcpServers, w as getExistingApiConfig, T as formatApiKeyDisplay, H as addCompletedOnboarding, U as modifyApiConfigPartially, V as isCcrInstalled, W as installCcr, X as setupCcrConfiguration, Y as validateApiKey, r as configureApi, _ as readZcfConfigAsync, I as I18N, $ as readCcrConfig, a0 as configureCcrFeature, a1 as handleExitPromptError, a2 as handleGeneralError, a3 as COMETIX_COMMANDS, a4 as COMETIX_COMMAND_NAME, a5 as displayBanner, a6 as selectScriptLanguage, a7 as resolveAiOutputLanguage, a8 as updatePromptOnly, a9 as selectAndInstallWorkflows, aa as version, ab as checkAndUpdateTools, ac as displayBannerWithInfo, i as init } from './chunks/simple-config.mjs';
 import inquirer from 'inquirer';
 import { existsSync, unlinkSync } from 'node:fs';
 import { x } from 'tinyexec';
@@ -9,14 +9,14 @@ import { homedir } from 'node:os';
 import { join } from 'node:path';
 import { exec } from 'child_process';
 import { promisify } from 'util';
+import { exec as exec$1 } from 'node:child_process';
+import { promisify as promisify$1 } from 'node:util';
 import 'pathe';
 import 'dayjs';
 import 'node:url';
 import 'ora';
 import 'semver';
 import 'node:fs/promises';
-import 'node:child_process';
-import 'node:util';
 
 function handleCancellation(scriptLang) {
   const i18n = getTranslation(scriptLang);
@@ -294,7 +294,7 @@ async function configureAiMemoryFeature(scriptLang) {
         return;
       }
     }
-    const { selectAiOutputLanguage } = await import('./chunks/simple-config.mjs').then(function (n) { return n.ab; });
+    const { selectAiOutputLanguage } = await import('./chunks/simple-config.mjs').then(function (n) { return n.ad; });
     const aiOutputLang = await selectAiOutputLanguage(scriptLang, scriptLang);
     applyAiLanguageDirective(aiOutputLang);
     updateZcfConfig({ aiOutputLang });
@@ -438,7 +438,7 @@ async function executeCcusage(args = []) {
   }
 }
 
-const execAsync = promisify(exec);
+const execAsync$1 = promisify(exec);
 async function runCcrUi(scriptLang, apiKey) {
   const i18n = I18N[scriptLang];
   console.log(ansis.cyan(`
@@ -450,7 +450,7 @@ async function runCcrUi(scriptLang, apiKey) {
 `));
   }
   try {
-    const { stdout, stderr } = await execAsync("ccr ui");
+    const { stdout, stderr } = await execAsync$1("ccr ui");
     if (stdout) console.log(stdout);
     if (stderr) console.error(ansis.yellow(stderr));
     console.log(ansis.green(`\u2714 ${i18n.ccr.ccrUiStarted}`));
@@ -464,7 +464,7 @@ async function runCcrStatus(scriptLang) {
   console.log(ansis.cyan(`
 \u{1F4CA} ${i18n.ccr.checkingCcrStatus}`));
   try {
-    const { stdout, stderr } = await execAsync("ccr status");
+    const { stdout, stderr } = await execAsync$1("ccr status");
     if (stdout) {
       console.log("\n" + ansis.bold(i18n.ccr.ccrStatusTitle));
       console.log(stdout);
@@ -480,7 +480,7 @@ async function runCcrRestart(scriptLang) {
   console.log(ansis.cyan(`
 \u{1F504} ${i18n.ccr.restartingCcr}`));
   try {
-    const { stdout, stderr } = await execAsync("ccr restart");
+    const { stdout, stderr } = await execAsync$1("ccr restart");
     if (stdout) console.log(stdout);
     if (stderr) console.error(ansis.yellow(stderr));
     console.log(ansis.green(`\u2714 ${i18n.ccr.ccrRestarted}`));
@@ -494,7 +494,7 @@ async function runCcrStart(scriptLang) {
   console.log(ansis.cyan(`
 \u25B6\uFE0F  ${i18n.ccr.startingCcr}`));
   try {
-    const { stdout, stderr } = await execAsync("ccr start");
+    const { stdout, stderr } = await execAsync$1("ccr start");
     if (stdout) console.log(stdout);
     if (stderr) console.error(ansis.yellow(stderr));
     console.log(ansis.green(`\u2714 ${i18n.ccr.ccrStarted}`));
@@ -514,7 +514,7 @@ async function runCcrStop(scriptLang) {
   console.log(ansis.cyan(`
 \u23F9\uFE0F  ${i18n.ccr.stoppingCcr}`));
   try {
-    const { stdout, stderr } = await execAsync("ccr stop");
+    const { stdout, stderr } = await execAsync$1("ccr stop");
     if (stdout) console.log(stdout);
     if (stderr) console.error(ansis.yellow(stderr));
     console.log(ansis.green(`\u2714 ${i18n.ccr.ccrStopped}`));
@@ -642,6 +642,84 @@ async function showCcrMenu(scriptLang) {
   }
 }
 
+const execAsync = promisify$1(exec$1);
+async function runCometixInstallOrUpdate(scriptLang) {
+  const i18n = getTranslation(scriptLang);
+  try {
+    console.log(ansis.blue(`${i18n.cometix.installingOrUpdating}`));
+    await execAsync(COMETIX_COMMANDS.INSTALL);
+    console.log(ansis.green(`\u2714 ${i18n.cometix.installUpdateSuccess}`));
+  } catch (error) {
+    console.error(ansis.red(`\u2717 ${i18n.cometix.installUpdateFailed}: ${error}`));
+    throw error;
+  }
+}
+async function runCometixPrintConfig(scriptLang) {
+  const i18n = getTranslation(scriptLang);
+  try {
+    console.log(ansis.blue(`${i18n.cometix.printingConfig}`));
+    const { stdout } = await execAsync(COMETIX_COMMANDS.PRINT_CONFIG);
+    console.log(stdout);
+  } catch (error) {
+    if (error.message.includes(`command not found: ${COMETIX_COMMAND_NAME}`)) {
+      console.error(ansis.red(`\u2717 ${i18n.cometix.commandNotFound}`));
+    } else {
+      console.error(ansis.red(`\u2717 ${i18n.cometix.printConfigFailed}: ${error}`));
+    }
+    throw error;
+  }
+}
+
+async function showCometixMenu(scriptLang) {
+  try {
+    const i18n = getTranslation(scriptLang);
+    console.log("\n" + ansis.cyan("\u2550".repeat(50)));
+    console.log(ansis.bold.cyan(`  ${i18n.cometix.cometixMenuTitle}`));
+    console.log(ansis.cyan("\u2550".repeat(50)) + "\n");
+    console.log(`  ${ansis.cyan("1.")} ${i18n.cometix.cometixMenuOptions.installOrUpdate} ${ansis.gray("- " + i18n.cometix.cometixMenuDescriptions.installOrUpdate)}`);
+    console.log(`  ${ansis.cyan("2.")} ${i18n.cometix.cometixMenuOptions.printConfig} ${ansis.gray("- " + i18n.cometix.cometixMenuDescriptions.printConfig)}`);
+    console.log(`  ${ansis.yellow("0.")} ${i18n.cometix.cometixMenuOptions.back}`);
+    console.log("");
+    const { choice } = await inquirer.prompt({
+      type: "input",
+      name: "choice",
+      message: i18n.common.enterChoice,
+      validate: (value) => {
+        const valid = ["1", "2", "0"];
+        return valid.includes(value) || i18n.common.invalidChoice;
+      }
+    });
+    switch (choice) {
+      case "1":
+        await runCometixInstallOrUpdate(scriptLang);
+        break;
+      case "2":
+        await runCometixPrintConfig(scriptLang);
+        break;
+      case "0":
+        return false;
+    }
+    if (choice !== "0") {
+      console.log("\n" + ansis.dim("\u2500".repeat(50)) + "\n");
+      const { continueInCometix } = await inquirer.prompt({
+        type: "confirm",
+        name: "continueInCometix",
+        message: i18n.common.returnToMenu,
+        default: true
+      });
+      if (continueInCometix) {
+        return await showCometixMenu(scriptLang);
+      }
+    }
+    return false;
+  } catch (error) {
+    if (!handleExitPromptError(error)) {
+      handleGeneralError(error, scriptLang);
+    }
+    return false;
+  }
+}
+
 function getValidLanguage(lang) {
   return lang && lang in I18N ? lang : "en";
 }
@@ -712,6 +790,10 @@ async function runCcrMenuFeature(scriptLang) {
   const validLang = getValidLanguage(scriptLang);
   await showCcrMenu(validLang);
 }
+async function runCometixMenuFeature(scriptLang) {
+  const validLang = getValidLanguage(scriptLang);
+  await showCometixMenu(validLang);
+}
 
 async function update(options = {}) {
   try {
@@ -817,6 +899,9 @@ async function showMainMenu() {
       console.log(
         `  ${ansis.cyan("U.")} ${i18n.menu.menuOptions.ccusage} ${ansis.gray("- " + i18n.menu.menuDescriptions.ccusage)}`
       );
+      console.log(
+        `  ${ansis.cyan("L.")} ${i18n.menu.menuOptions.cometixLine} ${ansis.gray("- " + i18n.menu.menuDescriptions.cometixLine)}`
+      );
       console.log("");
       console.log("  ------------ ZCF ------------");
       console.log(
@@ -837,7 +922,7 @@ async function showMainMenu() {
         name: "choice",
         message: i18n.common.enterChoice,
         validate: (value) => {
-          const valid = ["1", "2", "3", "4", "5", "6", "7", "r", "R", "u", "U", "0", "-", "+", "q", "Q"];
+          const valid = ["1", "2", "3", "4", "5", "6", "7", "r", "R", "u", "U", "l", "L", "0", "-", "+", "q", "Q"];
           return valid.includes(value) || i18n.common.invalidChoice;
         }
       });
@@ -876,6 +961,10 @@ async function showMainMenu() {
         case "U":
           await runCcusageFeature(scriptLang);
           break;
+        case "l":
+        case "L":
+          await runCometixMenuFeature(scriptLang);
+          break;
         case "0":
           const newLang = await changeScriptLanguageFeature(scriptLang);
           if (newLang !== scriptLang) {
@@ -894,7 +983,7 @@ async function showMainMenu() {
           break;
       }
       if (!exitMenu && choice.toLowerCase() !== "q") {
-        if (choice === "0" || choice === "-" || choice === "+" || choice.toLowerCase() === "u" || choice.toLowerCase() === "r") {
+        if (choice === "0" || choice === "-" || choice === "+" || choice.toLowerCase() === "u" || choice.toLowerCase() === "r" || choice.toLowerCase() === "l") {
           console.log("\n" + ansis.dim("\u2500".repeat(50)) + "\n");
           continue;
         }

package/dist/index.d.mts

@@ -13,6 +13,7 @@ interface TranslationStructure {
     errors: any;
     tools: any;
     ccr: any;
+    cometix: any;
     updater: any;
 }
 

package/dist/index.d.ts

@@ -13,6 +13,7 @@ interface TranslationStructure {
     errors: any;
     tools: any;
     ccr: any;
+    cometix: any;
     updater: any;
 }
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zcf",
   "type": "module",
-  "version": "2.9.7",
+  "version": "2.9.9",
   "description": "Zero-Config Claude-Code Flow - One-click configuration tool for Claude Code",
   "license": "MIT",
   "homepage": "https://github.com/UfoMiao/zcf",

package/templates/en/workflow/git/commands/git-worktree.md

@@ -0,0 +1,301 @@
+---
+description: Manage Git worktrees, support add/list/remove/migrate operations, create in .zcf/ directory by default, auto-configure git ignore rules, support IDE quick open and content migration
+allowed-tools: Read(**), Exec(git worktree add, git worktree list, git worktree remove, git worktree prune, git branch, git checkout, git rev-parse, git stash, git cp, code, cursor, webstorm), Write(.git/info/exclude)
+argument-hint: <add|list|remove|prune|migrate> [path] [-b <branch>] [-o|--open] [--track] [--guess-remote] [--detach] [--checkout] [--lock] [--migrate-from <source-path>] [--migrate-stash]
+# examples:
+#   - /git-worktree add feature-ui                     # create worktree, ask whether to open in IDE by default
+#   - /git-worktree add feature-ui -o                  # create worktree and open directly in IDE
+#   - /git-worktree add hotfix -b fix/login -o         # create new branch, worktree and open in IDE directly
+#   - /git-worktree migrate feature-ui --from main     # migrate uncommitted content from main branch to feature-ui worktree
+#   - /git-worktree migrate feature-ui --stash         # migrate current stash content to feature-ui worktree
+---
+
+# Claude Command: Git Worktree
+
+**Purpose**: Provide Git worktree quick operations, manage multiple working trees in `.zcf/` directory by default, auto-handle git ignore configuration, support IDE quick open and cross-worktree content migration.
+
+---
+
+## Usage
+
+```bash
+# Add worktree (default in .zcf/)
+/git-worktree add <path>                           # checkout same-name branch to .zcf/<path>, ask whether to open IDE
+/git-worktree add <path> -b <branch>               # create new branch and add worktree
+/git-worktree add <path> -o                        # create and open directly in IDE
+/git-worktree add <path> -b <branch> --open        # create new branch, worktree and open directly
+
+# Content migration
+/git-worktree migrate <target-path> --from <source-path>  # migrate uncommitted content
+/git-worktree migrate <target-path> --stash               # migrate stash content
+
+# Other operations
+/git-worktree list                                 # show all worktree status
+/git-worktree remove <path>                        # remove specified worktree
+/git-worktree prune                                # clean invalid worktree records
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `add <path>` | Add new worktree in `.zcf/<path>` |
+| `migrate <target>` | Migrate content to specified worktree |
+| `list` | List all worktrees and their status |
+| `remove <path>` | Remove worktree at specified path |
+| `prune` | Clean invalid worktree references |
+| `-b <branch>` | Create new branch and checkout to worktree |
+| `-o, --open` | Open directly in IDE after creation (skip prompt) |
+| `--from <source>` | Specify migration source path (migrate only) |
+| `--stash` | Migrate current stash content (migrate only) |
+| `--track` | Set new branch to track corresponding remote branch |
+| `--guess-remote` | Auto guess remote branch for tracking |
+| `--detach` | Create detached HEAD worktree |
+| `--checkout` | Checkout immediately after creation (default behavior) |
+| `--lock` | Lock worktree after creation |
+
+---
+
+## What This Command Does
+
+### 1. **Environment Check**
+   - Confirm in Git repository via `git rev-parse --is-inside-work-tree`
+
+### 2. **Ignore Rules Configuration**
+   - Check if `.git/info/exclude` contains `/.zcf/` rule
+   - Auto-add `/.zcf/` to `.git/info/exclude` if not exists
+
+### 3. **Worktree Operations**
+   - **add**: Create new worktree in `.zcf/<path>`
+   - **list**: Show all worktree paths, branches and status
+   - **remove**: Safely remove specified worktree
+   - **prune**: Clean orphaned worktree records
+
+### 4. **🆕 IDE Quick Open Feature**
+   - **Default behavior**: Ask whether to open new worktree in IDE after `add` operation
+   - **Direct open**: Use `-o/--open` parameter to skip prompt and open directly
+   - **IDE detection**: Auto-detect common IDEs (VS Code, Cursor, WebStorm, etc.)
+   - **Smart selection**: Recommend best choice based on project type and installed IDEs
+
+### 5. **🆕 Content Migration Feature**
+   - **Uncommitted content migration**: Migrate uncommitted changes from one worktree to another
+   - **Stash migration**: Apply current stash content to target worktree
+   - **Safety check**: Check target worktree status before migration to avoid conflicts
+
+### 6. **Path Handling**
+   - Auto-add `.zcf/` prefix to all relative paths
+   - Keep absolute paths as-is
+   - Auto-create `.zcf/` directory if not exists
+
+### 7. **Branch Management**
+   - Support checking out existing branches or creating new branches
+   - Auto-handle remote branch tracking
+   - Provide branch status and HEAD position info
+
+---
+
+## Enhanced Features
+
+### 🖥️ **IDE Integration**
+
+**Supported IDEs**
+- **VS Code**: `code <path>`
+- **Cursor**: `cursor <path>`  
+- **WebStorm**: `webstorm <path>`
+- **Others**: Configurable custom IDE commands
+
+**Open Modes**
+```bash
+# Default: ask whether to open after creation
+/git-worktree add feature-ui
+# Output: 🖥️  Open .zcf/feature-ui in IDE? [y/n]:
+
+# Direct open: skip prompt
+/git-worktree add feature-ui -o
+# Output: 🚀 Opening .zcf/feature-ui in VS Code...
+```
+
+**Smart Detection Flow**
+1. Check installed IDEs in system
+2. Recommend based on project type (e.g., recommend VS Code for Node.js projects)
+3. Provide selection menu for user choice (default mode)
+4. Remember user preference for next time
+
+### 📦 **Content Migration System**
+
+**Migration Types**
+```bash
+# Migrate uncommitted content from main branch
+/git-worktree migrate feature-ui --from main
+
+# Migrate from other worktree
+/git-worktree migrate hotfix --from .zcf/feature-ui
+
+# Migrate current stash
+/git-worktree migrate feature-ui --stash
+
+# Migrate specific stash
+/git-worktree migrate feature-ui --stash stash@{2}
+```
+
+**Migration Flow**
+1. **Source check**: Verify source path exists and has uncommitted content
+2. **Target check**: Ensure target worktree working directory is clean
+3. **Content analysis**: Show files and changes to be migrated
+4. **Safe migration**: Use git native commands to ensure data safety
+5. **Result confirmation**: Show migration results and follow-up suggestions
+
+---
+
+## Safety Features
+
+- **Path check**: Prevent creating worktree in existing directory
+- **Branch conflict check**: Avoid same branch being checked out by multiple worktrees
+- **Auto cleanup**: Remove operation cleans both directory and git references
+- **Status display**: Clearly show each worktree's branch, commit and status
+
+### **Migration Safety Protection**
+- **Conflict detection**: Check for potential file conflicts before migration
+- **Backup mechanism**: Auto-create stash backup before migration
+- **Rollback support**: Provide rollback solution when migration fails
+- **Status validation**: Ensure source and target worktrees are in correct state
+
+### **IDE Integration Safety**
+- **Path validation**: Ensure IDE commands use correct paths
+- **Permission check**: Verify IDE executable permissions
+- **Error handling**: Friendly error messages when IDE startup fails
+
+---
+
+## Examples
+
+### **Basic Usage + IDE Open**
+```bash
+# Create worktree and ask for IDE open (default behavior)
+/git-worktree add feature-ui
+# Output:
+# ✅ Worktree created at .zcf/feature-ui
+# 🖥️  Detected IDEs:
+#    1. VS Code (recommended)
+#    2. Cursor
+# Open this worktree in IDE? [1/2/n]: 1
+# 🚀 Opening .zcf/feature-ui in VS Code...
+
+# Create worktree and open IDE directly
+/git-worktree add feature-ui -o
+# Output:
+# ✅ Worktree created at .zcf/feature-ui
+# 🚀 Opening .zcf/feature-ui in VS Code...
+
+# Create new branch and open directly
+/git-worktree add hotfix -b fix/login --open
+# Output:
+# ✅ Created branch 'fix/login' and worktree at .zcf/hotfix
+# 🚀 Opening .zcf/hotfix in VS Code...
+```
+
+### **Content Migration Scenarios**
+```bash
+# Scenario: developed some features on main branch, want to move to new branch
+# 1. Create new feature worktree
+/git-worktree add feature-ui -b feature/new-ui
+
+# 2. Migrate uncommitted content from main
+/git-worktree migrate feature-ui --from main
+# Output:
+# 📦 Found uncommitted content:
+#    M  src/components/Button.tsx
+#    A  src/components/Modal.tsx
+#    ??  src/styles/new-theme.css
+# 🔄 Migrating to .zcf/feature-ui...
+# ✅ Migration completed! Suggest committing these changes in new worktree.
+
+# 3. Ask whether to open IDE (since -o wasn't used during creation)
+# 🖥️  Open .zcf/feature-ui in IDE? [y/n]: y
+```
+
+### **Stash Migration**
+```bash
+# Have some stashes, want to apply to specific worktree
+/git-worktree migrate hotfix --stash
+# Output:
+# 📋 Found stashes:
+#    stash@{0}: WIP on main: fix user login
+#    stash@{1}: WIP on main: update docs
+# Select stash to migrate [0/1]: 0
+# 🔄 Applying stash@{0} to .zcf/hotfix...
+# ✅ Stash content applied successfully!
+```
+
+### **List and Manage Worktrees**
+```bash
+# View all worktrees
+/git-worktree list
+# Output:
+# /path/to/project                    [main]     ← main working tree
+# /path/to/project/.zcf/feature-ui    [feature/new-ui]
+# /path/to/project/.zcf/hotfix        [fix/login]
+
+# Remove unneeded worktree
+/git-worktree remove feature-ui
+# Output:
+# ✅ Worktree .zcf/feature-ui removed successfully
+
+# Clean invalid references
+/git-worktree prune
+# Output:
+# 🧹 Pruned 0 worktree entries
+```
+
+---
+
+## Directory Structure
+
+After using this command, project structure will be:
+```
+your-project/
+├── .git/
+├── .zcf/                    # worktree directory (ignored by git)
+│   ├── feature-ui/          # feature-ui branch working tree
+│   ├── hotfix/              # hotfix branch working tree
+│   ├── debug/               # debug working tree
+│   └── .worktree-config     # worktree config file
+├── src/                     # main working tree source
+└── package.json             # main working tree files
+```
+
+---
+
+## Configuration
+
+### **IDE Preferences**
+Command saves user preferences in `.zcf/.worktree-config`:
+```json
+{
+  "preferredIDE": "code",
+  "autoOpenIDE": false,
+  "migrateBackup": true,
+  "defaultWorktreeDir": ".zcf"
+}
+```
+
+### **Custom IDE Commands**
+```bash
+# Set custom IDE
+git config worktree.ide.custom "subl %s"  # Sublime Text
+git config worktree.ide.preferred "custom"
+```
+
+---
+
+## Notes
+
+- **Performance optimization**: Worktrees share `.git` directory, saving disk space
+- **IDE support**: Most modern IDEs support multi-worktree projects
+- **Cleanup suggestion**: Regularly run `prune` to clean invalid references
+- **Branch protection**: Avoid operations on protected branches (like main/master)
+- **Migration limitation**: Can only migrate uncommitted changes, use `git cherry-pick` for committed content
+- **IDE requirement**: IDE command-line tools must be installed and in PATH
+- **Cross-platform support**: IDE detection and startup support Windows, macOS, Linux
+
+---