A simple and naïve vsCode/Cursor plugin that lets you list and start iOS and Android emulators directly from Cursor's sidebar.

• 📱 List iOS Simulators: View all available iOS simulators from Xcode
• 🤖 List Android Emulators: View all available Android Virtual Devices (AVDs)
• ▶️ Start Emulators: Start any emulator with a single click
• 🔄 Real-time Status: See which emulators are currently running
• 🔃 Refresh: Manually refresh the emulator list on demand

• macOS only - iOS simulators are only available on macOS
• Xcode installed
• Xcode Command Line Tools (xcrun must be available in PATH)

• Cross-platform - Works on macOS, Windows, and Linux
• Android Studio installed
• Android SDK with emulator tools
• The extension automatically detects:
  • Environment variables: ANDROID_HOME or ANDROID_SDK_ROOT
  • Default installation paths:
    • macOS: ~/Library/Android/sdk
    • Windows: %LOCALAPPDATA%\Android\Sdk or %USERPROFILE%\AppData\Local\Android\Sdk
    • Linux: ~/Android/Sdk or ~/android-sdk
  • PATH environment variable (if tools are in PATH)
• adb command available (for status detection)

Install directly from OpenVSX:

• Install from OpenVSX

1. Clone or download this repository
2. Open the project in Cursor
3. Run npm install to install dependencies
4. Run npm run compile to build the extension
5. Press F5 to open a new Cursor window with the extension loaded
6. Or package the extension: npm install -g vsce && vsce package

Install from the VS Code Marketplace:

• Install from Marketplace

1. Open Cursor
2. Look for the "Emulators" view in the Explorer sidebar
3. The view will automatically load available iOS and Android emulators
4. Click on any emulator to start it
5. Use the refresh button (🔄) to reload the emulator list

• 🟢 Filled circle: Emulator is currently running
• ⚪ Outline circle: Emulator is stopped/available
• ⚠️ Warning icon: Tool (Xcode/Android Studio) not available
• ❌ Error icon: Error loading emulators

• emulatorManager.refresh: Refresh the emulator list
• emulatorManager.startIOS: Start selected iOS simulator
• emulatorManager.startAndroid: Start selected Android emulator

• Ensure Xcode is installed: xcode-select --print-path
• Verify xcrun is available: xcrun --version
• Make sure you have at least one iOS simulator installed in Xcode

• Verify Android Studio is installed
• Check that emulator command is in PATH:
  • macOS/Linux: which emulator
  • Windows: where emulator.exe
• Or set ANDROID_HOME environment variable:
  • macOS/Linux:

    export ANDROID_HOME=$HOME/Library/Android/sdk
    export PATH=$PATH:$ANDROID_HOME/emulator
    export PATH=$PATH:$ANDROID_HOME/platform-tools

  • Windows (PowerShell):

    $env:ANDROID_HOME = "$env:LOCALAPPDATA\Android\Sdk"
    $env:PATH += ";$env:ANDROID_HOME\emulator;$env:ANDROID_HOME\platform-tools"

• The extension will also automatically check default installation paths
• Ensure you have created at least one AVD in Android Studio

• For iOS: Check that the simulator UDID is valid
• For Android: Verify the AVD name is correct and the emulator isn't already running
• Check Cursor's output panel for detailed error messages

src/
  ├── extension.ts          # Main extension entry point
  ├── emulatorProvider.ts   # TreeView provider for UI
  ├── iosEmulator.ts        # iOS simulator management
  ├── androidEmulator.ts    # Android emulator management
  ├── cli.ts                # Secure CLI command execution
  ├── platform.ts           # Platform detection utilities
  └── types.ts              # TypeScript type definitions

npm install
npm run compile

1. Open the project in Cursor
2. Press F5 to launch a new Cursor window with the extension loaded
3. Use the Debug Console to see output
4. Check the Output panel for extension logs

This extension uses secure command execution practices:

• Uses execFile instead of exec to prevent shell injection
• Validates all inputs before executing commands
• Validates UDID and AVD name formats
• Implements timeout protection for long-running commands

MIT License - see LICENSE file for details.

Contributions are welcome!