From d49c95a5ec657503f85e5748be6a0b4b0af27edd Mon Sep 17 00:00:00 2001
From: Prabith Balagopalan <prabith.balagopalan@cognizant.com>
Date: Thu, 26 Mar 2026 17:49:04 +0530
Subject: [PATCH] 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 <noreply@anthropic.com>
---
 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);
   }
 }