Sim VM Debugger

A VS Code extension for debugging Sim VM applications with breakpoints, step debugging, and variable inspection.

Features

• Launch or Attach - Start new Sim processes or connect to running instances
• Breakpoint Support - Set and manage breakpoints across multiple files
• Step Debugging - Next, step in, step out with full control
• Variable Inspection - View local and global variables with expandable objects
• Exception Handling - Automatic pause on unhandled exceptions with stack traces
• Live VM Output - Dedicated output panel with clickable file references
• Fast Performance - Optimized for quick startup and responsive debugging

Getting Started

1. Start Debugging

1. Set breakpoints by clicking in the editor gutter
2. Press F5 to start debugging
3. Use debug controls to step through your code

Requirements

• VS Code 1.50.0+
• Sim VM with debugger support
• TypeScript project

Commands

• F5 - Start debugging
• Shift+F5 - Stop debugging
• F9 - Toggle breakpoint
• F10 - Step over
• F11 - Step into
• Shift+F11 - Step out

2. Debug Configuration

Add to your .vscode/launch.json:

{
    "type": "sim",
    "request": "launch",
    "name": "Debug Sim VM",
    "program": "${workspaceFolder}/cmd/server.ts"
}

Configuration Options

Usage Examples

Launch Mode (Start New Process)

{
    "type": "sim",
    "request": "launch",
    "name": "Launch Sim",
    "program": "${workspaceFolder}/cmd/server.ts"
}

Attach Mode (Connect to Running VM)

{
    "type": "sim",
    "request": "attach", 
    "name": "Attach to Sim",
    "vmPort": 4444
}

Remote Debugging

{
    "type": "sim",
    "request": "attach",
    "name": "Remote Sim",
    "vmHost": "192.168.1.100",
    "vmPort": 4444
}