Updated route auto-detection

Author: uaoa

README.md

@@ -31,11 +31,12 @@ You're already investing in Claude Code – whether it's Pro, Max ×5, or Max ×
 ## Installation
 
 1. Install the extension from the VS Code Marketplace
-2. Ensure Claude CLI is installed and available in your system PATH
+2. Ensure Claude CLI is installed (comes with your Claude Code subscription)
 3. Open a project with a Git repository
 4. Look for the sparkle ✨ button in your Source Control panel
+5. On first use, if CLI is not auto-detected, you'll be prompted to configure the path
 
-**That's it!** No configuration needed if you're using Claude CLI.
+**That's it!** The extension will automatically find Claude CLI or guide you through one-time setup.
 
 ## How to Use
 
@@ -51,64 +52,95 @@ You're already investing in Claude Code – whether it's Pro, Max ×5, or Max ×
 
 This extension keeps it simple with just a few optional settings:
 
-* `claude-commit.preferredMethod`: Choose AI backend (`auto`, `cli`, or `api`) – defaults to `auto`
-* `claude-commit.apiKey`: Your Anthropic API key (only needed if using API method)
-* `claude-commit.language`: Interface language (`en` for English, `ua` for Ukrainian)
+* `claudeCommit.cliPath`: Path to Claude CLI executable (leave empty for auto-detection)
+* `claudeCommit.preferredMethod`: Choose AI backend (`auto`, `cli`, or `api`) – defaults to `auto`
+* `claudeCommit.apiKey`: Your Anthropic API key (only needed if using API method)
+* `claudeCommit.language`: Interface language (`en` for English, `ua` for Ukrainian)
 
 ## Configuration Examples
 
-### Using only Claude CLI
+### Auto-detection (recommended)
 ```json
 {
-    "claude-commit.preferredMethod": "cli"
+    "claudeCommit.preferredMethod": "auto"
+}
+```
+The extension will automatically search for Claude CLI in common locations.
+
+### Manual CLI path (for NVM users or custom installations)
+```json
+{
+    "claudeCommit.cliPath": "/Users/you/.nvm/versions/node/v22.13.0/bin/claude",
+    "claudeCommit.preferredMethod": "cli"
 }
 ```
 
 ### Using Anthropic API as fallback
 ```json
 {
-    "claude-commit.preferredMethod": "auto",
-    "claude-commit.apiKey": "your-api-key-here"
+    "claudeCommit.preferredMethod": "auto",
+    "claudeCommit.apiKey": "your-api-key-here"
 }
 ```
 
 ### Ukrainian interface
 ```json
 {
-    "claude-commit.language": "ua"
+    "claudeCommit.language": "ua"
 }
 ```
 
 ## Troubleshooting
 
 ### Claude CLI not found
 
-If the extension can't find Claude CLI:
+The extension uses intelligent auto-detection to find Claude CLI. If it's not found automatically:
+
+1. **On first use**: The extension will prompt you to configure the path:
+   - **Browse for CLI**: Opens a file picker to locate the executable
+   - **Enter Path Manually**: Type the full path directly
+   - **Skip (Use API)**: Fall back to API method (requires API key)
 
-1. **Check Claude is installed**: Run in terminal:
+2. **Find your Claude CLI path manually**:
    ```bash
    which claude
    ```
-   This should show the path to Claude (e.g., `/Users/you/.nvm/versions/node/v22.13.0/bin/claude`)
-
-2. **Verify authentication**: Ensure Claude CLI is authenticated:
+   This shows the path (e.g., `/Users/you/.nvm/versions/node/v22.13.0/bin/claude`)
+
+3. **Configure the path in settings**:
+   - Open VS Code Settings (Cmd+, or Ctrl+,)
+   - Search for "claudeCommit.cliPath"
+   - Paste the path from step 2
+
+4. **Auto-detection locations** (checked in order):
+   - User-configured path in settings
+   - System PATH (via `which claude`)
+   - Shell profile paths (~/.zshrc, ~/.bashrc)
+   - Common installation paths:
+     - `/usr/local/bin/claude`
+     - `/opt/homebrew/bin/claude`
+     - `~/.local/bin/claude`
+     - `~/.nvm/versions/node/*/bin/claude` (NVM)
+     - `~/.npm-global/bin/claude`
+
+5. **Verify authentication**: Ensure Claude CLI is authenticated:
    ```bash
-   claude setup-token
+   claude --version
    ```
 
-3. **Common issues**:
-   - **NVM users**: VS Code might not see NVM paths – restart VS Code after installing Claude
-   - **macOS**: If using zsh, paths might differ between terminal and VS Code
-   - **Windows**: Ensure Claude is in your system PATH
+6. **Common issues**:
+   - **NVM users**: Auto-detection now supports NVM paths, but you may need to configure manually once
+   - **macOS**: The extension now loads shell profiles to find paths
+   - **Windows**: Checks common npm installation directories
 
 ### No commit message generated
 
 1. Ensure you have changes in your repository (staged or unstaged)
 2. Check that Claude CLI is properly authenticated
 3. Try using API method as fallback:
    - Get API key from https://console.anthropic.com/
-   - Add to settings: `claude-commit.apiKey`
-   - Set `claude-commit.preferredMethod` to `api`
+   - Add to settings: `claudeCommit.apiKey`
+   - Set `claudeCommit.preferredMethod` to `api`
 
 ### Extension not working
 
@@ -118,6 +150,7 @@ If the extension can't find Claude CLI:
 4. Try generating a commit message manually via Command Palette:
    - Press `Cmd+Shift+P` (or `Ctrl+Shift+P`)
    - Type "Claude Commit: Generate"
+5. If CLI path is incorrect, clear `claudeCommit.cliPath` in settings to trigger re-detection
 
 ## Privacy & Security
 

package.json

@@ -2,7 +2,7 @@
 	"name": "claude-git-commit",
 	"displayName": "Claude Git Commit",
 	"description": "AI-powered git commit message generator using Claude AI",
-	"version": "1.0.2",
+	"version": "1.0.3",
 	"publisher": "ZakhariiMelnyk",
 	"icon": "icon.png",
 	"engines": {
@@ -45,11 +45,17 @@
 		"configuration": {
 			"title": "Claude Commit",
 			"properties": {
+				"claudeCommit.cliPath": {
+					"type": "string",
+					"default": "",
+					"description": "Path to Claude Code CLI executable (leave empty for auto-detection)",
+					"order": 1
+				},
 				"claudeCommit.apiKey": {
 					"type": "string",
 					"default": "",
 					"description": "Anthropic API key for Claude AI (optional if using Claude Code CLI)",
-					"order": 1
+					"order": 2
 				},
 				"claudeCommit.preferredMethod": {
 					"type": "string",
@@ -60,7 +66,7 @@
 					],
 					"default": "auto",
 					"description": "Preferred method for generating commits: auto (try CLI first, then API), cli (Claude Code CLI only), or api (Anthropic API only)",
-					"order": 2
+					"order": 3
 				},
 				"claudeCommit.language": {
 					"type": "string",
@@ -74,7 +80,7 @@
 						"Ukrainian"
 					],
 					"description": "Language for commit messages",
-					"order": 3
+					"order": 4
 				}
 			}
 		}