Repository files navigation

pwndbg (/paʊnˈdiˌbʌɡ/) is a GDB and LLDB plug-in that makes debugging suck less,with a focus on features needed by low-level software developers, hardware hackers,reverse-engineers and exploit developers.

It has a boatload of features, see ourFeatures pageandCHEATSHEET (feel free to print it!). If you have any questions you may read thedocumentation or asks us in ourDiscord server.

Vanilla GDB and LLDB are terrible to use for reverse engineering and exploit development.Typingx/30gx $rsp or navigating cumbersome LLDB commands is not fun and often providesminimal information. The year is 2025, and core debuggers still lack many user-friendlyfeatures such as a robust hexdump command. WinDbg users are completely lost when theyoccasionally need to bump into GDB or LLDB.

Pwndbg is a Python module which can be loaded into GDB or run as a REPL interface for LLDB.It provides a suite of utilities and enhancements that fill the gaps left by these debuggers,smoothing out rough edges and making them more user-friendly.

Seeinstallation instructions.

Many past (gdbinit,PEDA) and present projects (GEF,bata24/GEF) offer great features, but are hard to extend and are packagedas large single files (103KB,195KB,423KB,4.12MB). Pwndbg aims to replace them with a faster, cleaner, andmore robust implementation.

Pwndbg supports both GDB and LLDB, and each debugger has its own strengths.Here's a quick guide to help you decide which one to use:

Pwndbg ensures a consistent experience across both, so switching between them is seamless.

The LLDB implementation in pwndbg is still in early-stage and may contain bugs or limitations.
Known issues are tracked inGitHub Issues.

If you encounter any problems, feel free to report them or discuss on ourDiscord server.

Pull requests are welcome ❤️. Check out theContributing Guide.

Pwndbg was originally created byZach Riggle, who is no longer with us. We want to thank Zach for all of his contributions to pwndbg and the wider security community.