Skip to content
Start a byebug session on test failures.
Branch: master
Clone or download
Pull request Compare This branch is 1 commit ahead of kaspth:master.
Latest commit f7e601c Nov 24, 2016


Heavily inspired by hotell i zurich


Add this line to your application's Gemfile:

gem 'minitest-byebug'

And then execute:

$ bundle

Or install it yourself as:

$ gem install minitest-byebug


Add this to the top of your test file or helper:

require 'minitest/byebug' if ENV['DEBUG']

Then run your tests as normal but define DEBUG=1.

% DEBUG=1 rake test


  • Stop in the failed test. e.g. at an assert call.
    • Workaround: when the session starts, up 3 will take you to the test failure.
  • Stop on errors.


Distributed with an MIT License.

Contributions more than welcome.

Made by Kasper Timm Hansen.

You can’t perform that action at this time.