CurrenciCombo/docs/CURSOR_WSL_SETUP.md

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:

{
  "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:

   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