Skip to content
rippled-windows-debug

Getting Started

The fastest way to protect your rippled builds from OOM crashes.

One-time setup

Section titled “One-time setup”

Clone the toolkit and run the governor setup script:

Terminal window
git clone https://github.com/mcp-tool-shop-org/rippled-windows-debug.git
cd rippled-windows-debug


.\scripts\setup-governor.ps1

No admin rights required. This installs compiler wrappers that auto-start the build governor when you build.

Build with protection

Section titled “Build with protection”

Restart your terminal, then build rippled normally:

Terminal window
cmake --build build --parallel 16

The governor monitors commit charge and throttles cl.exe processes automatically. If memory pressure rises, it slows down the build instead of letting it crash.

What you get

Section titled “What you get”

After setup, every build using cmake, msbuild, or ninja is automatically protected. The governor:

  • Auto-starts on first compilation
  • Monitors commit charge (not free RAM — see Build Governor for why)
  • Throttles parallel processes when pressure rises
  • Provides actionable diagnostics
  • Auto-shuts down after 30 minutes of idle

Next steps

Section titled “Next steps”