GDB frontend made with Dear ImGui

Tugboat captain is the GDB archer fish mascot https://sourceware.org/gdb/mascot/
Jamie Guinan's original archer fish logo and the vector versions by Andreas Arnez are licensed under CC BY-SA 3.0 US. https://creativecommons.org/licenses/by-sa/3.0/us/

1. Install GLFW3, gcc, and gdb
   Debian: sudo apt-get install libglfw3 libglfw3-dev gcc gdb
   Arch: sudo pacman -S glfw gcc gdb
   Fedora: sudo dnf install glfw glfw-devel gcc gdb
   

2. If unable to find GLFW, compile from git repo
   https://github.com/glfw/glfw
   https://www.glfw.org/docs/latest/compile.html
   NOTE: linker flag -lglfw is the shared library, -lglfw3 is the static library
   

3. Run command "make DEBUG=0", output in generated build_release directory

NOTE: Tug defaults to the gdb filename returned by the command "which gdb"

1. run program from command line
   tug --exe [program to debug filename] --gdb [gdb filename]
   

OR

1. run tug
   
2. click "Debug Program" menu button
   
3. fill in gdb filename and debug filename, args are optional
   
4. click "Start" button
   

• CTRL-F: open text search mode, N = next match, SHIFT-N = previous match, ESC to exit
• CTRL-G: open goto line window, ENTER to jump to input line, ESC to exit
• hover over any word to query its value, right click it to create a new watch within the control window
• add/remove breakpoint by clicking the empty column to the left of the line number

program execution buttons

• "---" = jump to next executed line inside source window
• "|>" = start/continue program
• "||" = pause program
• "-->" = step into
• "/\>" = step over
• "</\" = step out

• repeat last command on hitting enter on an empty line (GDB emulation)
• cycle command history by pressing up/down arrow while clicked on the box
• hit tab while typing to see all the autocompletions, hit tab/shift tab to cycle through them

GDB Machine Interpreter:
https://sourceware.org/gdb/download/onlinedocs/gdb/GDB_002fMI.html#GDB_002fMI

GLFW:
https://www.glfw.org/download.html
https://www.glfw.org/docs/latest/compile.html