From d49c95a5ec657503f85e5748be6a0b4b0af27edd Mon Sep 17 00:00:00 2001 From: Prabith Balagopalan Date: Thu, 26 Mar 2026 17:49:04 +0530 Subject: [PATCH 1/4] fix(installer): show help text on error and document --profile full in README Running install.ps1/install.sh with no arguments gave a cryptic error with no guidance. Now the usage help is printed after the error so users know what arguments to pass. Also added --profile full as the recommended install option in the README quick-start section, which was previously undocumented. Co-Authored-By: Claude Sonnet 4.6 --- README.md | 10 ++++++++++ scripts/install-apply.js | 4 ++-- 2 files changed, 12 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 8d3b5bd3..a7eae8d8 100644 --- a/README.md +++ b/README.md @@ -180,6 +180,11 @@ cd everything-claude-code npm install # or: pnpm install | yarn install | bun install # macOS/Linux + +# Recommended: install everything (full profile) +./install.sh --profile full + +# Or install for specific languages only ./install.sh typescript # or python or golang or swift or php # ./install.sh typescript python golang swift php # ./install.sh --target cursor typescript @@ -188,6 +193,11 @@ npm install # or: pnpm install | yarn install | bun install ```powershell # Windows PowerShell + +# Recommended: install everything (full profile) +.\install.ps1 --profile full + +# Or install for specific languages only .\install.ps1 typescript # or python or golang or swift or php # .\install.ps1 typescript python golang swift php # .\install.ps1 --target cursor typescript diff --git a/scripts/install-apply.js b/scripts/install-apply.js index 6eda0845..e83ac79c 100644 --- a/scripts/install-apply.js +++ b/scripts/install-apply.js @@ -139,8 +139,8 @@ function main() { printHumanPlan(result, false); } } catch (error) { - console.error(`Error: ${error.message}`); - process.exit(1); + console.error(`Error: ${error.message}\n`); + showHelp(1); } } From 24674a7bd620231a17c8d908bf01e2d020fa169f Mon Sep 17 00:00:00 2001 From: Prabith Balagopalan Date: Thu, 26 Mar 2026 18:18:45 +0530 Subject: [PATCH 2/4] fix(installer): write error and help text to stderr for consistent stream output Extracted help text into getHelpText() and write both the error message and usage help to stderr via process.stderr.write(). This ensures that when output is redirected (e.g. 2>errors.txt), both the error and the guidance appear in the same stream. Co-Authored-By: Claude Sonnet 4.6 --- scripts/install-apply.js | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/scripts/install-apply.js b/scripts/install-apply.js index e83ac79c..cd499b6d 100644 --- a/scripts/install-apply.js +++ b/scripts/install-apply.js @@ -17,10 +17,10 @@ const { parseInstallArgs, } = require('./lib/install/request'); -function showHelp(exitCode = 0) { +function getHelpText() { const languages = listLegacyCompatibilityLanguages(); - console.log(` + return ` Usage: install.sh [--target <${LEGACY_INSTALL_TARGETS.join('|')}>] [--dry-run] [--json] [ ...] install.sh [--target <${SUPPORTED_INSTALL_TARGETS.join('|')}>] [--dry-run] [--json] --profile [--with ]... [--without ]... install.sh [--target <${SUPPORTED_INSTALL_TARGETS.join('|')}>] [--dry-run] [--json] --modules [--with ]... [--without ]... @@ -44,8 +44,11 @@ Options: Available languages: ${languages.map(language => ` - ${language}`).join('\n')} -`); +`; +} +function showHelp(exitCode = 0) { + console.log(getHelpText()); process.exit(exitCode); } @@ -139,8 +142,8 @@ function main() { printHumanPlan(result, false); } } catch (error) { - console.error(`Error: ${error.message}\n`); - showHelp(1); + process.stderr.write(`Error: ${error.message}\n\n${getHelpText()}`); + process.exit(1); } } From 70b65a9d0684fccb54c175aa3911a15d58cfb847 Mon Sep 17 00:00:00 2001 From: Affaan Mustafa Date: Fri, 27 Mar 2026 06:36:16 -0400 Subject: [PATCH 3/4] fix: tighten installer error spacing --- scripts/install-apply.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/install-apply.js b/scripts/install-apply.js index cd499b6d..2c93bc4b 100644 --- a/scripts/install-apply.js +++ b/scripts/install-apply.js @@ -142,7 +142,7 @@ function main() { printHumanPlan(result, false); } } catch (error) { - process.stderr.write(`Error: ${error.message}\n\n${getHelpText()}`); + process.stderr.write(`Error: ${error.message}\n${getHelpText()}`); process.exit(1); } } From 652f87c5b637a139745085c273b71c25ee73e5a1 Mon Sep 17 00:00:00 2001 From: Affaan Mustafa Date: Fri, 27 Mar 2026 07:49:30 -0400 Subject: [PATCH 4/4] fix(installer): tighten error help spacing --- scripts/install-apply.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/install-apply.js b/scripts/install-apply.js index 2c93bc4b..e082c3bb 100644 --- a/scripts/install-apply.js +++ b/scripts/install-apply.js @@ -142,7 +142,7 @@ function main() { printHumanPlan(result, false); } } catch (error) { - process.stderr.write(`Error: ${error.message}\n${getHelpText()}`); + process.stderr.write(`Error: ${error.message}${getHelpText()}`); process.exit(1); } }