SharpDbg

An open source, cross platform .NET debugger implementing the VS Code Debug Adapter Protocol (DAP), completely written in C#!

SharpDbg uses the ClrDebug managed wrapper around the ICorDebug APIs.

Usage

SharpDbg is available on NuGet as a .NET Tool: https://www.nuget.org/packages/SharpDbg.Cli

dotnet tool install --global SharpDbg.Cli 

Once installed, run it using:

sharpdbg --interpreter=vscode

The in memory library is also published to NuGet: https://www.nuget.org/packages/SharpDbg

Comparison

Architecture

SharpDbg is organized into three main components:

┌─────────────────────────────────────────────────────────┐
│                    VS Code / DAP Client                 │
└────────────────────────────┬────────────────────────────┘
                             │ DAP (stdin/stdout)
┌────────────────────────────▼────────────────────────────┐
│                    SharpDbg.Cli                         │
│  • Entry point and command-line argument handling       │
│  • DAP protocol client initialization                   │
└────────────────────────────┬────────────────────────────┘
                             │
┌────────────────────────────▼────────────────────────────┐
│                SharpDbg.Application                     │
│  • DAP protocol implementation                          │
│  • VS Code protocol message handlers                    │
│  • Event communication (stopped, continued, etc.)       │
└────────────────────────────┬────────────────────────────┘
                             │
┌────────────────────────────▼────────────────────────────┐
│              SharpDbg.Infrastructure                    │
│  • Core debugger engine (ManagedDebugger)               │
│  • ICorDebug API wrapper (ClrDebug)                     │
│  • Breakpoint and variable management                   │
│  • Expression evaluator (compiler + interpreter)        │
└─────────────────────────────────────────────────────────┘

Building From Source

1. Ensure .NET 10 SDK is installed
2. git clone
3. dotnet build
4. Done!

This will produce the debug adapter executable at artifacts/bin/SharpDbg.Cli/Debug/net10.0/SharpDbg.Cli.exe, equivalent to netcoredbg.exe

Screenshots

DebuggerDisplay attribute

	[DebuggerDisplay("Count = {Count}")]
	public class List<T> : IList<T>, IList, IReadOnlyList<T>

DebuggerTypeProxy & DebuggerBrowsable(.RootHidden) attributes

	[DebuggerTypeProxy(typeof(ICollectionDebugView<>))]
	public class List<T> : IList<T>, IList, IReadOnlyList<T>

References

• ClrDebug - Managed wrappers around the ICorDebug API
• netcoredbg - .NET debugger, written in C++
• debug-adapter-protocol - Microsoft's VS Code Debug Adapter Protocol