Ruby debug
github.com
- Free plan
- Linux
- Self-hosted
What Ruby debug is
Ruby debug is a free, BSD-2-Clause open-source debugger for Ruby MRI 2.7 and later. Its console evaluates Ruby expressions, inspects program state, controls execution, sets conditional or exception breakpoints, and enables tracing. The rdbg command launches Ruby scripts and commands such as Rails, Rake, and RSpec under the debugger. Remote sessions can use UNIX domain sockets or TCP/IP, and a console can attach to a running program. Execution recording supports replay by stepping backward through the log. An IRB console adds autocompletion, multiline input, and commands including show_source and show_doc. Frontends are described for VS Code and Chrome DevTools; VS Code requires the vscode-rdbg extension. Installation uses gem install debug or a Gemfile entry. The project reports no performance penalty when not stepping or using breakpoints, but warns that remote messages are unencrypted.
Who it suits
It suits Ruby developers working with MRI 2.7 or later who want console, remote, editor-integrated, or time-travel debugging.
Good to know, and what to watch
- Free BSD-2-Clause open-source gem
- Supports conditional and exception breakpoints
- Records execution for backward replay
- Offers VS Code and Chrome DevTools frontends
- No penalty when idle without breakpoints
- Project describes the debugger as not mature
- Remote debugger messages are unencrypted
- VS Code requires the vscode-rdbg extension
- open_nonstop can expose debugging access
Plans
Every plan and pricedebug (open-source gem)
Open source
The verdict
Ruby debug provides a broad debugger workflow, from IRB-style inspection to remote attachment and replay. Its security warnings and stated maturity caveat matter when enabling remote features.
What the maker publishes
- Debugger controls
- Its console can evaluate Ruby expressions, inspect program state, control execution, set breakpoints, and activate tracing. source
- Editor integrations
- The README describes debugger frontends for VS Code and Chrome DevTools; VS Code use requires the vscode-rdbg extension. source
- Install
- The README says to install it with `gem install debug` or add `gem "debug", ">= 1.0.0"` to a Gemfile. source
- IRB console
- It can use IRB as the debug console, adding autocompletion, multiline input, and IRB commands such as `show_source` and `show_doc`. source
- License and support
- The repository displays a BSD-2-Clause license and invites bug reports and pull requests, while describing the debugger as not mature. source
- Performance
- The project says it has no performance penalty when not stepping and no breakpoints are set. source
- Purpose
- The library provides debugging functionality for Ruby (MRI) 2.7 and later. source
- Recording and replay
- The debugger can record execution and replay it by stepping backward through the execution log. source
- Remote access risk
- The README warns that `debug/open_nonstop` can create a vulnerability because it opens debugging access without stopping the program. source
- Remote debugging
- It supports remote debugging over UNIX domain sockets or TCP/IP, with a console that can attach to a running debuggee. source
- Ruby program use
- The `rdbg` command can launch Ruby scripts or commands such as Rails, Rake, and RSpec under the debugger. source
- Security limitation
- The README warns that debugger-to-debuggee messages are not encrypted and advises care when using remote debugging. source
Checked against the maker's pages on 9 Oct 2026.