HERETEK(1)

NAME

heretekGDB TUI Dashboard for the understanding of vast knowledge

SYNOPSIS

$cargo install heretek

INFO

377 stars
9 forks
0 views

DESCRIPTION

GDB TUI Dashboard for the understanding of vast knowledge

README

heretek

github crates.io build status Codecov

GDB TUI Dashboard inspired by gef, designed to seamlessly connect to remote targets even without a functioning gdbserver.

  • No python requirements: Many vendors ship gdb without python support, we ship a single statically-linked musl binary.

  • Architecture agnostic: heretek only uses information given by gdb, no extra code required!

  • No gdbserver requirements: Many vendors ship invalid gdbserver binaries, this works on remote targets with just gdb, nc, cat, and mkfifo. No more wrestling with invalid or missing gdbserver binaries.

  • See features for heretek demos.

  • See commands for internal heretek commands.

  • See env-vars for heretek env vars.

screenshot

Installation

Either build from published source in crates.io.

$ cargo install heretek --locked

Or download from github releases.

Arch Linux users can also install from the official repositories via running pacman -S heretek

Usage

GDB TUI Dashboard for the understanding of vast knowledge

Usage: heretek [OPTIONS]

Options: --gdb-path <GDB_PATH> Override gdb executable path

-r, --remote <REMOTE> Connect to nc session

      `mkfifo gdb_pipe; cat gdb_pipe | gdb --interpreter=mi | nc -l -p 12345 &gt; gdb_pipe`

  --ptr-size &lt;PTR_SIZE&gt;
      Switch into 32-bit mode

      Heretek will do it&#39;s best to figure this out on it&#39;s own, but this will force the pointers to be evaluated as 32 bit

      [default: auto]
      [possible values: 32, 64, auto]

-c, --cmds <CMDS> Execute GDB commands line-by-line from file

      lines starting with # are ignored

  --log-path &lt;LOG_PATH&gt;
      Path to write log

      Set env `RUST_LOG` to change log level

-h, --help Print help (see a summary with '-h')

-V, --version Print version

Development

All patches/merge requests are welcome! See the development guide for more details. DEVELOPMENT.md.

"To every problem, a solution lies in the application of tech-lore" - Ferrarch Asklepian, Warhammer 40,000: Mechanicus

SEE ALSO

clihub3/4/2026HERETEK(1)