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
- Set breakpoints by clicking in the editor gutter
- Press
F5
to start debugging
- 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
Property |
Description |
Default |
request |
"launch" or "attach" |
"launch" |
program |
Entry point file (launch mode) |
Auto-detected |
vmPort |
VM debugger port |
4444 |
vmHost |
VM host address |
"localhost" |
cwd |
Working directory |
Workspace root |
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
}