# ruby/debug

Debugging functionality for Ruby

Repository: https://github.com/ruby/debug
Canonical: https://ross.abutalabs.com/products/ruby-debug
Language: Ruby
License: BSD-2-Clause
License Family: permissive
Topics: ruby, debugger, debugging-tool, debug
Last push: 2026-06-12T01:07:12+00:00

## Health v2 (maintenance only)
Score: 70/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 87, release rhythm 30, longevity 100
- inputs: {"age_days": 2539, "days_push": 83, "days_rel": 258, "gap_med": 182.0, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1271, forks 145 (observed 2026-08-28T04:04:11.979699+00:00)

## What it is
The official Ruby debugger gem (debug.rb), a fast replacement for the traditional lib/debug.rb standard library for MRI 2.7+. It supports breakpoints, a debug console, remote debugging over UNIX domain sockets and TCP/IP, and integration with frontends like VS Code and Chrome DevTools.

## Use cases
- debug a ruby program with breakpoints and a console
- remotely debug a ruby app over tcp or unix socket
- debug ruby code from vscode
- step through ruby code and inspect local variables
- record and replay ruby program execution
- debug multithreaded ruby applications

## When to choose
- you need a modern, maintained debugger for Ruby MRI 2.7+
- you want remote debugging or IDE integration (VS Code, Chrome DevTools)
- you need debugging with no performance penalty when not stepping

## When to avoid
- you are on Ruby versions older than 2.7
- you rely on the old pre-1.0 debug gem's API
- you need debugging for non-MRI Ruby implementations like JRuby or TruffleRuby

## Facets
- artifact type: library
- maturity: active
- function: developer-tools
- domain: developer-tools, programming-languages
- platform: ruby, cli, cross-platform
- tags: debugger, remote-debugging, dap, breakpoints, ruby-gem

## Member repositories
- ruby/debug (main) score 70

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:11.979699+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T05:03:24.048083+00:00, confidence not recorded.
  - readme: https://github.com/ruby/debug (fetched 2026-08-28T04:04:11.979699+00:00, sha 999450c1f8ad)
- Data as of 2026-08-30T08:39:29.467469+00:00.