# 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