Ruby debug
Ruby debug is an open-source debugger for Ruby MRI 2.7 and later.
What Ruby debug is
Ruby debug is an 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. Developers can launch scripts or Rails, Rake, and RSpec commands with rdbg, or attach to running programs remotely through UNIX domain sockets or TCP/IP. 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, with the vscode-rdbg extension required for VS Code. Installation uses gem install debug or a Gemfile entry. The project says there is no performance penalty when not stepping and no breakpoints are set. The free gem uses the BSD-2-Clause license, but its README calls the debugger not mature and warns that remote messages are unencrypted.
Good
- Supports conditional and exception breakpoints
- Records execution for backward replay
- Offers VS Code and Chrome DevTools frontends
- IRB console adds autocompletion
- Free BSD-2-Clause open-source gem
Watch out
- Supports Ruby MRI 2.7 and later only
- Remote messages are not encrypted
- Project describes debugger as not mature
- open_nonstop can expose debugging access
Who it suits
Ruby developers working with MRI 2.7 or later can use Ruby debug for local, remote, and time-travel debugging. It suits users comfortable installing a Ruby gem and configuring editor frontends.
Verdict
Ruby debug provides extensive controls for inspecting and replaying Ruby programs, including remote attachment and editor frontends. Its free license is useful for Ruby teams, but remote debugging requires care because communications are unencrypted and the project notes a maturity limitation.
Plans and prices
From Ruby debug's own pricing page, checked 9 Oct 2001.
| Plan | Price | What it gives you |
|---|---|---|
| debug (open-source gem) | Free | Ruby MRI 2.7 and later · BSD-2-Clause license |
The facts
Each one read from Ruby debug's own pages, with the date it was checked.
What it does
- Debugger controls
- Its console can evaluate Ruby expressions, inspect program state, control execution, set breakpoints, and activate tracing.checked 9 Oct 2001
- Editor integrations
- The README describes debugger frontends for VS Code and Chrome DevTools; VS Code use requires the vscode-rdbg extension.checked 9 Oct 2001
- Install
- The README says to install it with `gem install debug` or add `gem "debug", ">= 1.0.0"` to a Gemfile.checked 9 Oct 2001
- IRB console
- It can use IRB as the debug console, adding autocompletion, multiline input, and IRB commands such as `show_source` and `show_doc`.checked 9 Oct 2001
- 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.checked 9 Oct 2001
- Performance
- The project says it has no performance penalty when not stepping and no breakpoints are set.checked 9 Oct 2001
- Purpose
- The library provides debugging functionality for Ruby (MRI) 2.7 and later.checked 9 Oct 2001
- Recording and replay
- The debugger can record execution and replay it by stepping backward through the execution log.checked 9 Oct 2001
- Remote access risk
- The README warns that `debug/open_nonstop` can create a vulnerability because it opens debugging access without stopping the program.checked 9 Oct 2001
- Remote debugging
- It supports remote debugging over UNIX domain sockets or TCP/IP, with a console that can attach to a running debuggee.checked 9 Oct 2001
- Ruby program use
- The `rdbg` command can launch Ruby scripts or commands such as Rails, Rake, and RSpec under the debugger.checked 9 Oct 2001
- Security limitation
- The README warns that debugger-to-debuggee messages are not encrypted and advises care when using remote debugging.checked 9 Oct 2001
Alternatives to Ruby debug
- 1
LLDB
Free planAndroidiOSLinuxmacOS7.2Free plan - 2

IDA Pro
Free planLinuxmacOSWindows7.0From $91.58 a month - 3
PonyDebugger
Free planiOSWebmacOSSelf-hosted6.8Free plan - 4
pyOCD
Free planAPILinuxmacOSSelf-hosted6.8Free plan - 5
Perl Debugger
Free planLinuxmacOSWindows6.5Free plan - 6

Black Magic Debug
Free planLinuxmacOSWindows6.4Free plan
