https://github.com/wcampbell0x2a/heretek
GDB TUI Dashboard for the understanding of vast knowledge
https://github.com/wcampbell0x2a/heretek
ctf embedded gdb linux reverse-engineering rust tui
Last synced: about 2 months ago
JSON representation
GDB TUI Dashboard for the understanding of vast knowledge
- Host: GitHub
- URL: https://github.com/wcampbell0x2a/heretek
- Owner: wcampbell0x2a
- License: apache-2.0
- Created: 2024-12-02T02:47:25.000Z (7 months ago)
- Default Branch: master
- Last Pushed: 2025-05-11T01:43:26.000Z (about 2 months ago)
- Last Synced: 2025-05-11T02:42:43.589Z (about 2 months ago)
- Topics: ctf, embedded, gdb, linux, reverse-engineering, rust, tui
- Language: Rust
- Homepage:
- Size: 11.5 MB
- Stars: 287
- Watchers: 5
- Forks: 6
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE-APACHE
Awesome Lists containing this project
README
# heretek
[
](https://github.com/wcampbell0x2a/heretek)
[
](https://crates.io/crates/heretek)
[
](https://github.com/wcampbell0x2a/heretek/actions?query=branch%3Amaster)
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](./docs/features.md) for `heretek` demos.
* See [commands](./docs/commands.md) for internal `heretek` commands.
## Installation
Either build from published source in crates.io.
```
$ cargo install heretek --locked
```
Or download from [github releases](https://github.com/wcampbell0x2a/heretek/releases).
Arch Linux users can also install from the [official repositories](https://archlinux.org/packages/extra/x86_64/heretek/) via running `pacman -S heretek`
## Usage
```console
GDB TUI Dashboard for the understanding of vast knowledge
Usage: heretek [OPTIONS]
Options:
--gdb-path
Override gdb executable path
-r, --remote
Connect to nc session
`mkfifo gdb_pipe; cat gdb_pipe | gdb --interpreter=mi | nc -l -p 12345 > gdb_pipe`
--32
Switch into 32-bit mode
-c, --cmds
Execute GDB commands
lines starting with # are ignored
--log-path
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
```
> "To every problem, a solution lies in the application of tech-lore" - Ferrarch Asklepian, Warhammer 40,000: Mechanicus