118 lines
2.9 KiB
Markdown
118 lines
2.9 KiB
Markdown
|
# Cursor IDE - WSL Terminal Setup
|
||
|
|
|
||
|
|
## Default Terminal Configuration
|
||
|
|
|
||
|
|
The project is configured to use WSL/Ubuntu as the default terminal in Cursor IDE.
|
||
|
|
|
||
|
|
## Configuration File
|
||
|
|
|
||
|
|
The settings are stored in `.vscode/settings.json`:
|
||
|
|
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"terminal.integrated.defaultProfile.windows": "Ubuntu",
|
||
|
|
"terminal.integrated.profiles.windows": {
|
||
|
|
"Ubuntu": {
|
||
|
|
"path": "wsl.exe",
|
||
|
|
"args": ["-d", "Ubuntu"],
|
||
|
|
"icon": "terminal-linux"
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## How to Verify
|
||
|
|
|
||
|
|
1. **Open a new terminal in Cursor**:
|
||
|
|
- Press `` Ctrl+` `` (backtick) or
|
||
|
|
- Go to `Terminal` → `New Terminal`
|
||
|
|
|
||
|
|
2. **Check terminal type**:
|
||
|
|
- The terminal should show `Ubuntu` or `WSL` in the dropdown
|
||
|
|
- The prompt should show Linux-style paths (e.g., `/mnt/c/...`)
|
||
|
|
|
||
|
|
## Manual Setup (if needed)
|
||
|
|
|
||
|
|
If the automatic configuration doesn't work:
|
||
|
|
|
||
|
|
1. **Open Cursor Settings**:
|
||
|
|
- Press `Ctrl+,` (or `Cmd+,` on Mac)
|
||
|
|
- Search for "terminal default profile"
|
||
|
|
|
||
|
|
2. **Set Default Profile**:
|
||
|
|
- Find `Terminal > Integrated > Default Profile: Windows`
|
||
|
|
- Select `Ubuntu` from the dropdown
|
||
|
|
|
||
|
|
3. **Or edit settings.json directly**:
|
||
|
|
- Press `Ctrl+Shift+P`
|
||
|
|
- Type "Preferences: Open User Settings (JSON)"
|
||
|
|
- Add the configuration from `.vscode/settings.json`
|
||
|
|
|
||
|
|
## Switching Terminal Types
|
||
|
|
|
||
|
|
You can still use other terminals when needed:
|
||
|
|
|
||
|
|
1. **Open terminal dropdown**:
|
||
|
|
- Click the `+` button next to terminal tabs
|
||
|
|
- Or use `Ctrl+Shift+` `` (backtick)
|
||
|
|
|
||
|
|
2. **Select terminal type**:
|
||
|
|
- Choose `Ubuntu` (WSL)
|
||
|
|
- Choose `PowerShell` (Windows)
|
||
|
|
- Choose `Command Prompt` (Windows)
|
||
|
|
|
||
|
|
## Project-Specific Settings
|
||
|
|
|
||
|
|
The `.vscode/settings.json` file in this project ensures that:
|
||
|
|
- ✅ WSL/Ubuntu is the default terminal
|
||
|
|
- ✅ All team members use the same terminal environment
|
||
|
|
- ✅ Scripts work correctly (bash scripts require WSL)
|
||
|
|
|
||
|
|
## Troubleshooting
|
||
|
|
|
||
|
|
### Terminal doesn't open in WSL
|
||
|
|
|
||
|
|
1. **Check WSL is installed**:
|
||
|
|
```powershell
|
||
|
|
wsl --list --verbose
|
||
|
|
```
|
||
|
|
|
||
|
|
2. **Verify Ubuntu is available**:
|
||
|
|
- Should show `Ubuntu` in the list
|
||
|
|
- Should be running or available
|
||
|
|
|
||
|
|
3. **Restart Cursor**:
|
||
|
|
- Close and reopen Cursor IDE
|
||
|
|
- Open a new terminal
|
||
|
|
|
||
|
|
### Terminal shows PowerShell instead
|
||
|
|
|
||
|
|
1. **Check settings**:
|
||
|
|
- Verify `.vscode/settings.json` exists
|
||
|
|
- Check `terminal.integrated.defaultProfile.windows` is set to `Ubuntu`
|
||
|
|
|
||
|
|
2. **Reload window**:
|
||
|
|
- Press `Ctrl+Shift+P`
|
||
|
|
- Type "Developer: Reload Window"
|
||
|
|
|
||
|
|
### WSL path issues
|
||
|
|
|
||
|
|
If paths don't resolve correctly:
|
||
|
|
- Use full WSL paths: `/mnt/c/Users/...`
|
||
|
|
- Or use relative paths from project root
|
||
|
|
- The project root should be accessible at `/mnt/c/Users/intlc/defi_oracle_projects/CurrenciCombo`
|
||
|
|
|
||
|
|
## Benefits
|
||
|
|
|
||
|
|
Using WSL as default terminal:
|
||
|
|
- ✅ Consistent with project scripts (all bash)
|
||
|
|
- ✅ Better compatibility with Linux-based tools
|
||
|
|
- ✅ Native Docker support
|
||
|
|
- ✅ Better Node.js performance
|
||
|
|
- ✅ Easier CI/CD pipeline alignment
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
**Last Updated**: 2025-01-15
|
||
|
|
|