https://github.com/deivid-rodriguez/pry-byebug

Step-by-step debugging and stack navigation in Pry
https://github.com/deivid-rodriguez/pry-byebug

Keywords

debugger pry pry-byebug repl ruby

Keywords from Contributors

activerecord activejob mvc rubygems byebug rspec crash-reporting introspection irb reflection

Last synced: about 10 hours ago
JSON representation

Repository metadata

Step-by-step debugging and stack navigation in Pry

Host: GitHub
URL: https://github.com/deivid-rodriguez/pry-byebug
Owner: deivid-rodriguez
License: mit
Created: 2013-05-02T23:30:11.000Z (almost 13 years ago)
Default Branch: master
Last Pushed: 2026-02-09T22:21:57.000Z (22 days ago)
Last Synced: 2026-02-22T12:23:45.676Z (9 days ago)
Topics: debugger, pry, pry-byebug, repl, ruby
Language: Ruby
Homepage:
Size: 554 KB
Stars: 2,027
Watchers: 20
Forks: 145
Open Issues: 46
Releases: 31
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: code_of_conduct.md

pry-byebug

Adds step-by-step debugging and stack navigation capabilities to pry using
byebug.

To use, invoke pry normally. No need to start your script or app differently.
Execution will stop in the first statement after your binding.pry.

def some_method
  puts 'Hello World' # Run 'step' in the console to move here
end

binding.pry
some_method          # Execution will stop here.
puts 'Goodbye World' # Run 'next' in the console to move here.

Requirements

MRI 3.2.0 or higher.

Installation

Add

gem 'pry-byebug'

to your Gemfile and run

bundle install

Make sure you include the gem globally or inside the :test group if you plan
to use it to debug your tests!

Commands

Step-by-step debugging

break: Manage breakpoints.

step: Step execution into the next line or method. Takes an optional numeric
argument to step multiple times.

next: Step over to the next line within the same frame. Also takes an
optional numeric argument to step multiple lines.

finish: Execute until current stack frame returns.

continue: Continue program execution and end the Pry session.

Callstack navigation

backtrace: Shows the current stack. You can use the numbers on the left
side with the frame command to navigate the stack.

up: Moves the stack frame up. Takes an optional numeric argument to move
multiple frames.

down: Moves the stack frame down. Takes an optional numeric argument to move
multiple frames.

frame: Moves to a specific frame. Called without arguments will show the
current frame.

Matching Byebug Behaviour

If you're coming from Byebug or from Pry-Byebug versions previous to 3.0, you
may be lacking the 'n', 's', 'c' and 'f' aliases for the stepping commands.
These aliases were removed by default because they usually conflict with
scratch variable names. But it's very easy to reenable them if you still want
them, just add the following shortcuts to your ~/.pryrc file:

if defined?(PryByebug)
  Pry.commands.alias_command 'c', 'continue'
  Pry.commands.alias_command 's', 'step'
  Pry.commands.alias_command 'n', 'next'
  Pry.commands.alias_command 'f', 'finish'
end

Also, you might find useful as well the repeat the last command by just hitting
the Enter key (e.g., with step or next). To achieve that, add this to
your ~/.pryrc file:

# Hit Enter to repeat last command
Pry::Commands.command /^$/, "repeat last command" do
  pry_instance.run_command Pry.history.to_a.last
end

Breakpoints

You can set and adjust breakpoints directly from a Pry session using the
break command:

break: Set a new breakpoint from a line number in the current file, a file
and line number, or a method. Pass an optional expression to create a
conditional breakpoint. Edit existing breakpoints via various flags.

Examples:

break SomeClass#run            # Break at the start of `SomeClass#run`.
break Foo#bar if baz?          # Break at `Foo#bar` only if `baz?`.
break app/models/user.rb:15    # Break at line 15 in user.rb.
break 14                       # Break at line 14 in the current file.

break --condition 4 x > 2      # Change condition on breakpoint #4 to 'x > 2'.
break --condition 3            # Remove the condition on breakpoint #3.

break --delete 5               # Delete breakpoint #5.
break --disable-all            # Disable all breakpoints.

break                          # List all breakpoints.
break --show 2                 # Show details about breakpoint #2.

Type break --help from a Pry session to see all available options.

Alternatives

Note that all of the alternatives here are incompatible with pry-byebug. If
your platform is supported by pry-byebug, you should remove any of the gems
mentioned here if they are present in your Gemfile.

pry-debugger: Provides step-by-step debugging for MRI 1.9.3 or older
rubies. If you're still using those and need a step-by-step debugger to help
with the upgrade, pry-debugger can be handy.
pry-stack_explorer: Provides stack navigation capabilities for MRI 1.9.3 or
older rubies. If you're still using those and need to navigate your stack to
help with the upgrade, pry-stack_explorer can be handy.
pry-nav: Provides step-by-step debugging for JRuby.

Contribute

See Getting Started with Development.

Funding

Subscribe to Tidelift to ensure pry-byebug stays actively maintained, and at
the same time get licensing assurances and timely security notifications for
your open source dependencies.

You can also help pry-byebug by leaving a small (or big) tip through Liberapay.

Security contact information

Please use the Tidelift security contact to report a security vulnerability.
Tidelift will coordinate the fix and disclosure.

Credits

Gopal Patel (@nixme), creator of pry-debugger, and everybody who contributed
to it. pry-byebug is a fork of pry-debugger so it wouldn't exist as it is
without those contributions.
John Mair (@banister), creator of pry.

Patches and bug reports are welcome.

Owner metadata

Name: David Rodríguez
Login: deivid-rodriguez
Email:
Kind: user
Description: Open source paramedic
Website:
Location: Madrid, Spain
Twitter:
Company: @tidelift
Icon url: https://avatars.githubusercontent.com/u/2887858?v=4
Repositories: 239
Last ynced at: 2025-12-13T01:35:49.472Z
Profile URL: https://github.com/deivid-rodriguez

GitHub Events

Total

Release event: 1
Delete event: 31
Pull request event: 77
Fork event: 11
Issues event: 4
Watch event: 43
Issue comment event: 32
Push event: 33
Pull request review comment event: 3
Pull request review event: 8
Create event: 33

Last Year

Release event: 1
Delete event: 31
Pull request event: 74
Fork event: 5
Issues event: 3
Watch event: 18
Issue comment event: 24
Push event: 33
Pull request review comment event: 3
Pull request review event: 6
Create event: 33

Committers metadata

Last synced: 6 days ago

Total Commits: 631
Total Committers: 39
Avg Commits per committer: 16.179
Development Distribution Score (DDS): 0.575

Commits in past year: 50
Committers in past year: 6
Avg Commits per committer in past year: 8.333
Development Distribution Score (DDS) in past year: 0.46

Name	Email	Commits
David Rodríguez	d**z@g**m	268
David Rodríguez	d**z@r**t	142
dependabot[bot]	d****]	75
dependabot-preview[bot]	2****]	63
Gopal Patel	n**e@s**m	22
Matijs van Zuijlen	m**s@m**t	13
palkan	d**v@w**u	4
Christian Schulze	c**e@g**m	4
Max Melentiev	m**m@g**m	3
Takashi Kokubun	t**n@g**m	3
Tee Parham	t**e@n**m	3
dependabot[bot]	s**t@d**m	3
Andrey Chernih	a**h@g**m	2
Kurtis Rainbolt-Greene	me@k****e	1
Igor Kapkov	i**k@m**m	1
Benjamin R. Haskell	r**y@b**m	1
Ali Sepehri	a**h@g**m	1
Andrew Nesbitt	a**z@g**m	1
André Luis Leal Cardoso Jr	a**r@g**m	1
☈king	p**g@s**g	1
jshou	j**u@g**m	1
Tsukuru Tanimichi	i**b@t**m	1
René Föhring	rf@b****e	1
Pedro Paiva	p**a@g**m	1
Olivier Lacan	hi@o****m	1
Nikita Simakov	e**l@g**m	1
Nicolas Viennot	n**s@v**z	1
Marvin	3****2	1
Luke Bergen	L**n@g**m	1
John Mair	j**r@g**m	1
and 9 more...

Committer domains:

Issue and Pull Request metadata

Last synced: 2 days ago

Total issues: 27
Total pull requests: 135
Average time to close issues: 11 months
Average time to close pull requests: 3 months
Total issue authors: 26
Total pull request authors: 18
Average comments per issue: 5.19
Average comments per pull request: 0.9
Merged pull request: 60
Bot issues: 0
Bot pull requests: 84

Past year issues: 2
Past year pull requests: 44
Past year average time to close issues: N/A
Past year average time to close pull requests: 6 days
Past year issue authors: 2
Past year pull request authors: 3
Past year average comments per issue: 1.5
Past year average comments per pull request: 0.2
Past year merged pull request: 23
Past year bot issues: 0
Past year bot pull requests: 25

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/deivid-rodriguez/pry-byebug

Top Issue Authors

quintrino (2)
thomaswuensche (1)
justin808 (1)
esambo (1)
broksonic21 (1)
iqqmuT (1)
michaeleisel (1)
matheussilvasantos (1)
richardplatel (1)
thibpoullain (1)
brauliomartinezlm (1)
kikonen (1)
sjahu (1)
yetrun (1)
zenspider (1)

Top Pull Request Authors

dependabot[bot] (51)
dependabot-preview[bot] (33)
deivid-rodriguez (32)
skull-squadron (2)
boimw (2)
andrehjr (2)
andrew (2)
afn (1)
AliSepehri (1)
ghanem-mhd (1)
meinac (1)
Jack12816 (1)
brorbw (1)
digitalmoksha (1)
wonda-tea-coffee (1)

Top Issue Labels

needs-feedback (1)
bug (1)
enhancement (1)

Top Pull Request Labels

dependencies (84)
ruby (23)
security (3)
github_actions (2)

Package metadata

Total packages: 14
Total downloads:
- rubygems: 536,757,176 total
Total docker downloads: 1,537,269,620
Total dependent packages: 3,269 (may contain duplicates)
Total dependent repositories: 63,234 (may contain duplicates)
Total versions: 108
Total maintainers: 5

gem.coop: pry-byebug

Combine 'pry' with 'byebug'. Adds 'step', 'next', 'finish', 'continue' and 'break' commands to control execution.

Homepage: https://github.com/deivid-rodriguez/pry-byebug
Documentation: http://www.rubydoc.info/gems/pry-byebug/
Licenses: MIT
Latest release: 3.12.0 (published about 2 months ago)
Last Synced: 2026-03-01T01:03:25.255Z (3 days ago)
Versions: 31
Dependent Packages: 0
Dependent Repositories: 0
Downloads: 266,594,644 Total
Docker Downloads: 768,585,809
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 0.054%
- Downloads: 0.093%
- Docker downloads count: 0.121%
Maintainers (1)
- deivid
Funding:
- https://liberapay.com/pry-byebug

rubygems.org: pry-byebug

Combine 'pry' with 'byebug'. Adds 'step', 'next', 'finish', 'continue' and 'break' commands to control execution.

Homepage: https://github.com/deivid-rodriguez/pry-byebug
Documentation: http://www.rubydoc.info/gems/pry-byebug/
Licenses: MIT
Latest release: 3.12.0 (published about 2 months ago)
Last Synced: 2026-03-01T10:32:58.573Z (3 days ago)
Versions: 31
Dependent Packages: 3,269
Dependent Repositories: 63,211
Downloads: 266,605,984 Total
Docker Downloads: 768,585,809
Rankings:
- Dependent packages count: 0.017%
- Downloads: 0.093%
- Dependent repos count: 0.142%
- Docker downloads count: 0.239%
- Average: 0.644%
- Stargazers count: 1.154%
- Forks count: 2.221%
Maintainers (1)
- deivid
Funding:
- https://liberapay.com/pry-byebug

gem.coop: gitlab-pry-byebug

Combine 'pry' with 'byebug'. Adds 'step', 'next', 'finish', 'continue' and 'break' commands to control execution.

Homepage: https://github.com/deivid-rodriguez/pry-byebug
Documentation: http://www.rubydoc.info/gems/gitlab-pry-byebug/
Licenses: MIT
Latest release: 3.9.0 (published about 5 years ago)
Last Synced: 2026-03-01T02:03:08.523Z (3 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Downloads: 1,778,274 Total
Docker Downloads: 49,001
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 1.034%
- Docker downloads count: 1.725%
- Downloads: 2.412%
Maintainers (4)
- gitlab_rubygems
- rymai
- stanhu
- minac

rubygems.org: gitlab-pry-byebug

Combine 'pry' with 'byebug'. Adds 'step', 'next', 'finish', 'continue' and 'break' commands to control execution.

Homepage: https://github.com/deivid-rodriguez/pry-byebug
Documentation: http://www.rubydoc.info/gems/gitlab-pry-byebug/
Licenses: MIT
Latest release: 3.9.0 (published about 5 years ago)
Last Synced: 2026-02-28T11:02:44.671Z (3 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 23
Downloads: 1,778,274 Total
Docker Downloads: 49,001
Rankings:
- Stargazers count: 1.144%
- Downloads: 2.107%
- Forks count: 2.221%
- Docker downloads count: 2.472%
- Average: 4.794%
- Dependent repos count: 5.04%
- Dependent packages count: 15.78%
Maintainers (4)
- stanhu
- gitlab_rubygems
- rymai
- minac

proxy.golang.org: github.com/deivid-rodriguez/pry-byebug

Homepage:
Documentation: https://pkg.go.dev/github.com/deivid-rodriguez/pry-byebug#section-documentation
Licenses: mit
Latest release: v3.12.0+incompatible (published about 2 months ago)
Last Synced: 2026-02-28T11:02:46.095Z (3 days ago)
Versions: 35
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent packages count: 6.497%
- Average: 6.716%
- Dependent repos count: 6.936%

ubuntu-22.04: ruby-pry-byebug

Homepage: https://github.com/deivid-rodriguez/pry-byebug
Licenses:
Latest release: 3.9.0-1 (published 18 days ago)
Last Synced: 2026-02-13T13:23:17.454Z (18 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%

ubuntu-23.10: ruby-pry-byebug

Homepage: https://github.com/deivid-rodriguez/pry-byebug
Licenses:
Latest release: 3.9.0-1 (published 18 days ago)
Last Synced: 2026-02-13T18:29:59.963Z (18 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%

ubuntu-24.04: ruby-pry-byebug

Homepage: https://github.com/deivid-rodriguez/pry-byebug
Licenses:
Latest release: 3.10.1-1 (published 25 days ago)
Last Synced: 2026-02-06T15:47:01.254Z (25 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:

debian-10: ruby-pry-byebug

Homepage: https://github.com/deivid-rodriguez/pry-byebug
Documentation: https://packages.debian.org/buster/ruby-pry-byebug
Licenses:
Latest release: 3.6.0-1 (published 20 days ago)
Last Synced: 2026-02-13T04:24:31.710Z (19 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%

debian-11: ruby-pry-byebug

Homepage: https://github.com/deivid-rodriguez/pry-byebug
Documentation: https://packages.debian.org/bullseye/ruby-pry-byebug
Licenses:
Latest release: 3.9.0-1 (published 21 days ago)
Last Synced: 2026-02-13T08:23:31.628Z (19 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%

ubuntu-23.04: ruby-pry-byebug

Homepage: https://github.com/deivid-rodriguez/pry-byebug
Licenses:
Latest release: 3.9.0-1 (published 21 days ago)
Last Synced: 2026-02-11T06:47:07.535Z (21 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%

ubuntu-20.04: ruby-pry-byebug

Homepage: https://github.com/deivid-rodriguez/pry-byebug
Licenses:
Latest release: 3.7.0-2 (published 19 days ago)
Last Synced: 2026-02-13T07:20:16.750Z (19 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%

ubuntu-24.10: ruby-pry-byebug

Homepage: https://github.com/deivid-rodriguez/pry-byebug
Licenses:
Latest release: 3.10.1-1 (published 19 days ago)
Last Synced: 2026-02-13T09:54:15.192Z (19 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:

debian-12: ruby-pry-byebug

Homepage: https://github.com/deivid-rodriguez/pry-byebug
Documentation: https://packages.debian.org/bookworm/ruby-pry-byebug
Licenses:
Latest release: 3.9.0-1 (published 19 days ago)
Last Synced: 2026-02-12T23:37:58.000Z (19 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:

Dependencies

.github/workflows/ubuntu.yml actions

actions/cache v1 composite
actions/checkout v2 composite
eregon/use-ruby-action master composite

Gemfile rubygems

chandler = 0.9.0 development
mdl = 0.11.0 development
minitest ~> 5.14 development
minitest-bisect ~> 1.5 development
rake ~> 13.0 development
rubocop ~> 1.0 development

Gemfile.lock rubygems

addressable 2.8.0
ast 2.4.2
bundler 2.3.20
byebug 11.1.3
chandler 0.9.0
chef-utils 16.4.41
coderay 1.1.3
faraday 1.0.0
json 2.6.2
kramdown 2.3.1
kramdown-parser-gfm 1.1.0
mdl 0.11.0
method_source 1.0.0
minitest 5.16.3
minitest-bisect 1.6.0
minitest-server 1.0.6
mixlib-cli 2.1.8
mixlib-config 3.0.9
mixlib-shellout 3.1.4
multipart-post 2.1.1
netrc 0.11.0
octokit 4.15.0
parallel 1.22.1
parser 3.1.2.1
path_expander 1.1.1
pry 0.14.1
pry-byebug 3.10.1
public_suffix 4.0.7
rainbow 3.1.1
rake 13.0.6
regexp_parser 2.5.0
rexml 3.2.5
rubocop 1.35.1
rubocop-ast 1.21.0
ruby-progressbar 1.11.0
sawyer 0.8.2
tomlrb 1.3.0
unicode-display_width 2.2.0

pry-byebug.gemspec rubygems

byebug ~> 11.0
pry >= 0.13, < 0.15

Score: 32.75310473415375

https://github.com/deivid-rodriguez/pry-byebug

Keywords

Keywords from Contributors

Repository metadata

README.md

pry-byebug

Requirements

Installation

Commands

Step-by-step debugging

Callstack navigation

Matching Byebug Behaviour

Breakpoints

Alternatives

Contribute

Funding

Security contact information

Credits

Owner metadata

GitHub Events

Total

Last Year

Committers metadata

Committer domains:

Issue and Pull Request metadata

Top Issue Authors

Top Pull Request Authors

Top Issue Labels

Top Pull Request Labels

Package metadata

gem.coop: pry-byebug

rubygems.org: pry-byebug

gem.coop: gitlab-pry-byebug

rubygems.org: gitlab-pry-byebug

proxy.golang.org: github.com/deivid-rodriguez/pry-byebug

ubuntu-22.04: ruby-pry-byebug

ubuntu-23.10: ruby-pry-byebug

ubuntu-24.04: ruby-pry-byebug

debian-10: ruby-pry-byebug

debian-11: ruby-pry-byebug

ubuntu-23.04: ruby-pry-byebug

ubuntu-20.04: ruby-pry-byebug

ubuntu-24.10: ruby-pry-byebug

debian-12: ruby-pry-byebug

Dependencies