You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+21-9Lines changed: 21 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,7 +22,8 @@ You're already investing in Claude Code – whether it's Pro, Max ×5, or Max ×
22
22
-**Model selection**: Choose between Haiku (fast), Sonnet (balanced), or Opus (most capable)
23
23
-**Multilingual support**: Works in English, Ukrainian, and Chinese
24
24
-**Flexible backend**: Automatically uses Claude CLI, with API fallback option
25
-
-**Auto-discovery & caching**: Finds and remembers your Claude CLI path automatically
25
+
-**Smart runtime detection**: Finds Claude CLI from your PATH at runtime without modifying settings (perfect for WSL)
26
+
-**In-memory caching**: Remembers the detected CLI path during your session for performance
26
27
-**Progress indicators**: See exactly what's happening during generation
27
28
-**Seamless VS Code integration**: Works directly with the built-in Git interface
28
29
@@ -33,6 +34,14 @@ You're already investing in Claude Code – whether it's Pro, Max ×5, or Max ×
33
34
- Git repository initialized in your workspace
34
35
- Internet connection for AI generation
35
36
37
+
### WSL Compatibility
38
+
39
+
This extension works seamlessly in Windows Subsystem for Linux (WSL) environments. The extension automatically detects the Claude CLI from the system's PATH at runtime without modifying your settings, ensuring compatibility across both Windows and WSL environments:
40
+
41
+
-**On Windows**: The extension finds `claude.exe` from the Windows PATH
42
+
-**In WSL**: The extension finds `claude` from the Linux PATH
43
+
-**No conflicts**: Leaving `claudeCommit.cliPath` empty allows automatic detection in both environments
44
+
36
45
## Installation
37
46
38
47
1. Install the extension from the VS Code Marketplace
@@ -172,7 +181,7 @@ Restricts temporary prompt file permissions to owner-only (0600) on Linux/macOS.
172
181
173
182
### Claude CLI not found
174
183
175
-
The extension uses intelligent auto-detection to find Claude CLI. If it's not found automatically:
184
+
The extension uses intelligent auto-detection to find Claude CLI**at runtime** without modifying your settings. If it's not found automatically:
176
185
177
186
1.**On first use**: The extension will prompt you to configure the path:
178
187
-**Browse for CLI**: Opens a file picker to locate the executable
@@ -185,15 +194,17 @@ The extension uses intelligent auto-detection to find Claude CLI. If it's not fo
185
194
```
186
195
This shows the path (e.g., `/Users/you/.nvm/versions/node/v22.13.0/bin/claude`)
187
196
188
-
3.**Configure the path in settings**:
197
+
3.**Configure the path in settings** (only if needed):
189
198
- Open VS Code Settings (Cmd+, or Ctrl+,)
190
199
- Search for "claudeCommit.cliPath"
191
200
- Paste the path from step 2
201
+
-**Note**: Leave this empty for automatic runtime detection (recommended for WSL users)
192
202
193
-
4.**Auto-detection locations** (checked in order):
194
-
- User-configured path in settings
195
-
- System PATH (via `which claude`)
196
-
- Shell profile paths (~/.zshrc, ~/.bashrc)
203
+
4.**Auto-detection locations** (checked in order at runtime):
204
+
- User-configured path in settings (if set)
205
+
- In-memory cache (from previous detection in current session)
206
+
- System PATH (via `which claude` or `where claude`)
207
+
- Shell profile paths (~/.zshrc, ~/.bashrc on Unix-like systems)
197
208
- Common installation paths:
198
209
-`/usr/local/bin/claude`
199
210
-`/opt/homebrew/bin/claude`
@@ -207,8 +218,9 @@ The extension uses intelligent auto-detection to find Claude CLI. If it's not fo
207
218
```
208
219
209
220
6.**Common issues**:
210
-
-**NVM users**: Auto-detection now supports NVM paths, but you may need to configure manually once
211
-
-**macOS**: The extension now loads shell profiles to find paths
221
+
-**WSL users**: Keep `claudeCommit.cliPath` empty to allow runtime detection in both Windows and WSL
222
+
-**NVM users**: Auto-detection supports NVM paths via shell profile sourcing
223
+
-**macOS**: The extension loads shell profiles to find paths
212
224
-**Windows**: Checks common npm installation directories
0 commit comments