port of debugger that works on MRI 2.0.0
Ruby Emacs Lisp C
Pull request Compare This branch is 23 commits ahead, 132 commits behind cldwalker:master.
Latest commit c5bbb3c Jun 11, 2015 @amatsuda amatsuda Change CHANGELOG
refs #7
Failed to load latest commit information.
doc rdebug has a man pag 😄, use convential man/ Apr 6, 2012
emacs removed .svn dirs Oct 3, 2009
ext/ruby_debug add *.c *.h files. Mar 14, 2013
lib version 1.0.0.beta2 Mar 19, 2013
man update rubyforge links in man page Jun 8, 2012
old_scripts move unused old scripts to old_scripts Apr 6, 2012
.gitignore Ignore pkg directory Mar 19, 2013
.travis.yml Debugger 2 is for Ruby 2 Mar 19, 2013
AUTHORS whoops, sorry Anders Aug 24, 2009
CONTRIBUTING.md make contributing policies more known Feb 7, 2013
Gemfile "The source :rubygems is deprecated because HTTP requests are insecure." Mar 19, 2013
LICENSE SVN RubyForge pull Jul 22, 2009
OLDER_CHANGELOG rename old changelogs, add new one Apr 3, 2012
OLD_CHANGELOG rename old changelogs, add new one Apr 3, 2012
OLD_README update gemspec + replace readme Mar 30, 2012
Rakefile rename gemspec filename in Rakefile Mar 14, 2013
debugger2.gemspec Update debugger2.gemspec Mar 14, 2013



debugger2 is a fork of [debugger] (https://github.com/cldwalker/debugger) for Ruby 2.0.

It uses only external C-APIs. Not of Ruby core sources.

(and debugger is a fork of ruby-debug(19) that works on 1.9.2 and 1.9.3 and installs easily for rvm/rbenv rubies :)

I want to merge original debugger if it has no problem. So debugger2 may be obsolete. Feel free to give us your comments.


First clone this repository:

git clone git@github.com:ko1/debugger2.git

Next, compile the extension:

rake compile

Build the gem package and install it:

gem build debugger2.gemspec
gem install debugger2*.gem

Supported Rubies

Ruby 2.0.0 or later.


Wherever you need a debugger, simply:

require 'debugger'; debugger

To use with bundler, drop in your Gemfile:

gem 'debugger2', :git => "git://github.com/ko1/debugger2.git"


At initialization time, debugger loads config files, executing their lines as if they were actual commands a user has typed. config files are loaded from two locations:

  • /.rdebugrc (/rdebug.ini for windows)
  • $PWD/.rdebugrc ($PWD/rdebug.ini for windows)

Here's a common configuration (yeah, I should make this the default):

set autolist
set autoeval
set autoreload

To see debugger's current settings, use the set command.

Using Commands

For a list of commands:

(rdb: 1) help

Most commands are described in rdebug's man page

$ gem install gem-man
$ man rdebug

More documentation

I forked this project from https://github.com/cldwalker/debugger. Maybe it can work same as debugger'. However, now don't supportpost-motem' mode and `threading'.

Please give us your feedback.

Reason for Fork

Ruby 2.0.0 has debugger support API. No need to install internal headers.


Please report them on github.


All ruby's debugger programmers.

Quote from [original README.md] (https://github.com/cldwalker/debugger/blob/master/README.md).

  • Thanks to the original authors: Kent Sibilev and Mark Moseley
  • Thanks to astashov for bringing in a new and improved test suite and various bug fixes.
  • Thanks to windwiny for porting to 2.0.0
  • Contributors: ericpromislow, jnimety, adammck, hipe, FooBarWidget, aghull
  • Fork started on awesome @relevance fridays!

And I want to say thank you to Asakusa.rb members. They tell me a lot of things, such as how to use github, and so on :).


  • Collect feedback.