b118b2be9c
- Added quick start instructions in README.md for first-time setup, including commands for complete setup, verification, and service start. - Revised FINAL_STATUS.md to reflect the project's infrastructure completion and readiness for execution, detailing scripts created and documentation status.
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
|
|
|