hugsy · hugsy · Feb 4, 2026 · Feb 1, 2026 · Feb 1, 2026 · Feb 1, 2026
diff --git a/.gitattributes b/.gitattributes
@@ -1,2 +1,8 @@
 # https://help.github.com/articles/dealing-with-line-endings/
 * text eol=lf
+*.png diff=none binary
+*.jpg diff=none binary
+*.jpeg diff=none binary
+*.gif diff=none binary
+*.svg diff=none binary
+*.webp diff=none binary
diff --git a/.github/workflows/coverage.yml b/.github/workflows/coverage.yml
@@ -17,7 +17,7 @@ jobs:
     runs-on: ubuntu-24.04
     steps:
     - name: Checkout
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6.0.1
     - name: Setup
       run: |
         export NEEDRESTART_MODE=n
@@ -44,7 +44,7 @@ jobs:
         echo "score_diff=${score_diff}" >> $GITHUB_OUTPUT
 
     - name: Post results
-      uses: actions/github-script@v7
+      uses: actions/github-script@v8.0.0
       with:
         script: |
           const old_score   = ${{ steps.get_coverage.outputs.current_score }};

diff --git a/.github/workflows/extended-tests.yml b/.github/workflows/extended-tests.yml
@@ -18,6 +18,6 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6.0.1
     - run: |
         docker run -v ${PWD}:/gef ${{ matrix.variants.os }}:${{ matrix.variants.version }} "bash /gef/tests/extended/${{ matrix.variants.os }}.sh"
diff --git a/.github/workflows/generate-docs.yml b/.github/workflows/generate-docs.yml
@@ -13,7 +13,7 @@ jobs:
     runs-on: ubuntu-latest
     if: github.event.repository.fork == false
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v6.0.1
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
       - name: Install pre-requisite

diff --git a/.github/workflows/notify.yml b/.github/workflows/notify.yml
@@ -23,7 +23,7 @@ jobs:
   discord:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v6.0.1
         with:
           fetch-depth: 0
 

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
@@ -32,7 +32,7 @@ jobs:
         shell: bash
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6.0.1
 
     - name: Install python and toolchain
       run: |

diff --git a/.github/workflows/validate.yml b/.github/workflows/validate.yml
@@ -10,10 +10,10 @@ jobs:
     name: Check formatting
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v3
-    - uses: actions/setup-python@v5.1.0
+    - uses: actions/checkout@v6.0.1
+    - uses: actions/setup-python@v6.2.0
       with:
-        python-version: "3.8"
+        python-version: "3.10"
     - uses: pre-commit/action@v3.0.1
 
   docs_link_check:
@@ -23,11 +23,25 @@ jobs:
       contents: read
     steps:
       - name: checkout
-        uses: actions/checkout@v4.1.6
+        uses: actions/checkout@v6.0.1
+      - name: Restore lychee cache
+        id: restore-cache
+        uses: actions/cache/restore@v4
+        with:
+          path: .lycheecache
+          key: cache-lychee-${{ github.sha }}
+          restore-keys: cache-lychee-
       - name: Check links
-        uses: lycheeverse/lychee-action@v2.0.2
+        uses: lycheeverse/lychee-action@v2.7.0
         env:
           GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}
         with:
-          args: --exclude-mail --accept=401 --no-progress --exclude 'https://cs.github.com/hugsy/gef\?q=.*' 'docs/**/*.md'
+          args: --exclude-mail --accept=401 --no-progress --exclude 'https://cs.github.com/hugsy/gef\?q=.*' '**/*.md'
           fail: false
+          workingDirectory: docs/
+      - name: Save lychee cache
+        uses: actions/cache/save@v4
+        if: always()
+        with:
+          path: .lycheecache
+          key: ${{ steps.restore-cache.outputs.cache-primary-key }}
diff --git a/README.md b/README.md
@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="https://i.imgur.com/o0L8lPN.png" alt="logo"/>
+  <img src="assets/images/logo.png" alt="logo"/>
 </p>
 
 <p align="center">
@@ -39,7 +39,7 @@ $ gdb -q
 
 You can immediately see that GEF is correctly installed by launching GDB:
 
-![gef-context](https://i.imgur.com/E3EuQPs.png)
+![gef-context](assets/images/gef-context.png)
 
 A few of `GEF` features include:
 
@@ -73,8 +73,8 @@ try to reach out for help on the Discord channel or submit an issue.
 
 ## Current status
 
-| Documentation |License | Compatibility | CI Tests (`main`) |
-|:---:|:---:|:---|--|
+|                                                                          Documentation                                                                           |                                                                  License                                                                   | Compatibility                                                                                 | CI Tests (`main`)                                                                                                                                  |
+| :--------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
 | [![Documentation](https://github.com/hugsy/gef/actions/workflows/generate-docs.yml/badge.svg)](https://github.com/hugsy/gef/actions/workflows/generate-docs.yml) | [![MIT](https://img.shields.io/packagist/l/doctrine/orm.svg?maxAge=2592000?style=plastic)](https://github.com/hugsy/gef/blob/main/LICENSE) | [![Python 3](https://img.shields.io/badge/Python-3-green.svg)](https://github.com/hugsy/gef/) | [![CI Test for GEF](https://github.com/hugsy/gef/actions/workflows/tests.yml/badge.svg)](https://github.com/hugsy/gef/actions/workflows/tests.yml) |
 
 ## Contribute

diff --git a/docs/assets/images/aarch64-fmtstr.png b/docs/assets/images/aarch64-fmtstr.png
diff --git a/docs/assets/images/double-free.png b/docs/assets/images/double-free.png
diff --git a/docs/assets/images/elf-checksec.png b/docs/assets/images/elf-checksec.png
diff --git a/docs/assets/images/elf-info.png b/docs/assets/images/elf-info.png
diff --git a/docs/assets/images/emu.png b/docs/assets/images/emu.png
diff --git a/docs/assets/images/entry-break-example.png b/docs/assets/images/entry-break-example.png
diff --git a/docs/assets/images/flags.png b/docs/assets/images/flags.png
diff --git a/docs/assets/images/fmtstr-helper-example.png b/docs/assets/images/fmtstr-helper-example.png
diff --git a/docs/assets/images/fork-execution.png b/docs/assets/images/fork-execution.png
diff --git a/docs/assets/images/gef-canary.png b/docs/assets/images/gef-canary.png
diff --git a/docs/assets/images/gef-config.png b/docs/assets/images/gef-config.png
diff --git a/docs/assets/images/gef-context-memory.png b/docs/assets/images/gef-context-memory.png
diff --git a/docs/assets/images/gef-context-redirect-section.png b/docs/assets/images/gef-context-redirect-section.png
diff --git a/docs/assets/images/gef-context.png b/docs/assets/images/gef-context.png
diff --git a/docs/assets/images/gef-debug.png b/docs/assets/images/gef-debug.png
diff --git a/docs/assets/images/gef-exception.png b/docs/assets/images/gef-exception.png
diff --git a/docs/assets/images/gef-got-multi-filter.png b/docs/assets/images/gef-got-multi-filter.png
diff --git a/docs/assets/images/gef-got-one-filter.png b/docs/assets/images/gef-got-one-filter.png
diff --git a/docs/assets/images/gef-got.png b/docs/assets/images/gef-got.png
diff --git a/docs/assets/images/gef-pcustom-with-address.png b/docs/assets/images/gef-pcustom-with-address.png
diff --git a/docs/assets/images/gef-remote-1.png b/docs/assets/images/gef-remote-1.png
diff --git a/docs/assets/images/gef-remote-command.png b/docs/assets/images/gef-remote-command.png
diff --git a/docs/assets/images/gef-remote.png b/docs/assets/images/gef-remote.png
diff --git a/docs/assets/images/gef-tmux-setup.png b/docs/assets/images/gef-tmux-setup.png
diff --git a/docs/assets/images/grep-address.png b/docs/assets/images/grep-address.png
diff --git a/docs/assets/images/grep.png b/docs/assets/images/grep.png
diff --git a/docs/assets/images/heap-analysis-helper-show.png b/docs/assets/images/heap-analysis-helper-show.png
diff --git a/docs/assets/images/heap-arenas.png b/docs/assets/images/heap-arenas.png
diff --git a/docs/assets/images/heap-chunk.png b/docs/assets/images/heap-chunk.png
diff --git a/docs/assets/images/heap-chunks-all.png b/docs/assets/images/heap-chunks-all.png
diff --git a/docs/assets/images/heap-chunks-arena.png b/docs/assets/images/heap-chunks-arena.png
diff --git a/docs/assets/images/heap-chunks-size-filter.png b/docs/assets/images/heap-chunks-size-filter.png
diff --git a/docs/assets/images/heap-chunks-summary-resolve.png b/docs/assets/images/heap-chunks-summary-resolve.png
diff --git a/docs/assets/images/heap-chunks-summary.png b/docs/assets/images/heap-chunks-summary.png
diff --git a/docs/assets/images/heap-chunks.png b/docs/assets/images/heap-chunks.png
diff --git a/docs/assets/images/heap-track.png b/docs/assets/images/heap-track.png
diff --git a/docs/assets/images/hexdump.png b/docs/assets/images/hexdump.png
diff --git a/docs/assets/images/highlight-command.png b/docs/assets/images/highlight-command.png
diff --git a/docs/assets/images/ida-structure-examples.png b/docs/assets/images/ida-structure-examples.png
diff --git a/docs/assets/images/logo.png b/docs/assets/images/logo.png
diff --git a/docs/assets/images/memory-watch.png b/docs/assets/images/memory-watch.png
diff --git a/docs/assets/images/mipsel-deref-regs.png b/docs/assets/images/mipsel-deref-regs.png
diff --git a/docs/assets/images/scan-address.png b/docs/assets/images/scan-address.png
diff --git a/docs/assets/images/sparc-arb-struct.png b/docs/assets/images/sparc-arb-struct.png
diff --git a/docs/assets/images/stubbed-fork.png b/docs/assets/images/stubbed-fork.png
diff --git a/docs/assets/images/trace-run-1.png b/docs/assets/images/trace-run-1.png
diff --git a/docs/assets/images/trace-run-2.png b/docs/assets/images/trace-run-2.png
diff --git a/docs/assets/images/uaf.png b/docs/assets/images/uaf.png
diff --git a/docs/assets/images/vmmap.png b/docs/assets/images/vmmap.png
diff --git a/docs/assets/images/voltron.png b/docs/assets/images/voltron.png
diff --git a/docs/assets/images/x86-heap-chunks.png b/docs/assets/images/x86-heap-chunks.png
diff --git a/docs/assets/images/x86-heap-helper-uaf.png b/docs/assets/images/x86-heap-helper-uaf.png
diff --git a/docs/assets/images/xfiles-example.png b/docs/assets/images/xfiles-example.png
diff --git a/docs/assets/images/xinfo-example.png b/docs/assets/images/xinfo-example.png
diff --git a/docs/commands/canary.md b/docs/commands/canary.md
@@ -10,4 +10,4 @@ The command `canary` does not take any arguments.
 gef➤ canary
 ```
 
-![gef-canary](https://i.imgur.com/kPmsod2.png)
+![gef-canary](assets/images/gef-canary.png)
diff --git a/docs/commands/config.md b/docs/commands/config.md
@@ -10,7 +10,7 @@ To view all settings for all commands loaded:
 gef➤  gef config
 ```
 
-![gef-config](https://i.imgur.com/bd2ZqsU.png)
+![gef-config](assets/images/gef-config.png)
 
 Or to get one setting value:
 

diff --git a/docs/commands/context.md b/docs/commands/context.md
@@ -1,6 +1,6 @@
 ## Command `context`
 
-![gef-context](https://i.imgur.com/aZiG8Yb.png)
+![gef-context](assets/images/gef-context.png)
 
 `gef` (not unlike `PEDA` or `fG! famous gdbinit`) provides comprehensive context menu when hitting a
 breakpoint.
@@ -123,7 +123,7 @@ gef➤ gef config context.redirect /dev/pts/0
 ```
 
 Enjoy:
-![gef-context-redirect-section](https://i.imgur.com/sWlX37q.png)
+![gef-context-redirect-section](assets/images/gef-context-redirect-section.png)
 
 To go back to normal, remove the value:
 

diff --git a/docs/commands/edit-flags.md b/docs/commands/edit-flags.md
@@ -20,4 +20,4 @@ instruction), but we want to have the Carry flag set, simply go with:
 gef➤ flags -ZERO +CARRY
 ```
 
-![flags](https://i.imgur.com/ro7iC5m.png)
+![flags](assets/images/flags.png)
diff --git a/docs/commands/entry-break.md b/docs/commands/entry-break.md
@@ -12,4 +12,4 @@ It will perform the following actions:
    header, set a breakpoint and run. This case should never fail if the ELF binary has a valid
    structure.
 
-![entry-break-example](https://i.imgur.com/zXSERMh.png)
+![entry-break-example](assets/images/entry-break-example.png)
diff --git a/docs/commands/format-string-helper.md b/docs/commands/format-string-helper.md
@@ -28,4 +28,4 @@ gef➤ r
 If a potentially insecure entry is found, the breakpoint will trigger, stop the process execution,
 display the reason for trigger and the associated context.
 
-![fmtstr-helper-example](https://i.imgur.com/INU3KGn.png)
+![fmtstr-helper-example](assets/images/fmtstr-helper-example.png)
diff --git a/docs/commands/gef-remote.md b/docs/commands/gef-remote.md
@@ -38,7 +38,7 @@ Process /tmp/default.out created; pid = 258932
 Listening on port 1234
 ```
 
-![gef-remote-1](https://i.imgur.com/Zc4vnBd.png)
+![gef-remote-1](assets/images/gef-remote-1.png)
 
 On the client, when the original `gdb` would use `target remote`, GEF's syntax is roughly similar
 (shown running in debug mode for more verbose output, but you don't have to):
@@ -75,12 +75,12 @@ Reading /lib64/ld-linux-x86-64.so.2 from remote target...
 
 And finally breaking into the program, showing the current context:
 
-![gef-remote](https://i.imgur.com/IfsRDvK.png)
+![gef-remote](assets/images/gef-remote.png)
 
 You will also notice the prompt has changed to indicate the debugging mode is now "remote". Besides
 that, all of GEF features are available:
 
-![gef-remote-command](https://i.imgur.com/05epyX6.png)
+![gef-remote-command](assets/images/gef-remote-command.png)
 
 #### `remote-extended`
 

diff --git a/docs/commands/got.md b/docs/commands/got.md
@@ -11,7 +11,7 @@ gef➤ got [--all] [filters]
 
 `--all` Print the GOT for all shared objects in addition to the executable file
 
-![gef-got](https://i.imgur.com/554ebM3.png)
+![gef-got](assets/images/gef-got.png)
 
 The applied filter partially matches the name of the functions, so you can do something like this.
 
@@ -21,15 +21,15 @@ gef➤ got print
 gef➤ got read
 ```
 
-![gef-got-one-filter](https://i.imgur.com/IU715CG.png)
+![gef-got-one-filter](assets/images/gef-got-one-filter.png)
 
 Example of multiple partial filters:
 
 ```text
 gef➤ got str get
 ```
 
-![gef-got-multi-filter](https://i.imgur.com/7L2uLt8.png)
+![gef-got-multi-filter](assets/images/gef-got-multi-filter.png)
 
 ```text
 gef➤ got --all str get

diff --git a/docs/commands/heap-analysis-helper.md b/docs/commands/heap-analysis-helper.md
@@ -33,12 +33,12 @@ The following settings are accepted:
 -  `check_null_free`: to break execution when a free(NULL) is encountered (disabled by default);
 -  `check_double_free`: to break execution when a double free is encountered;
 
-![double-free](https://i.imgur.com/S7b4FJa.png)
+![double-free](assets/images/double-free.png)
 
 -  `check_weird_free`: to execution when `free()` is called against a non-tracked pointer;
 -  `check_uaf`: to break execution when a possible Use-after-Free condition is found.
 
-![uaf](https://i.imgur.com/NfV5Cu9.png)
+![uaf](assets/images/uaf.png)
 
 Just like the format string vulnerability helper, the `heap-analysis-helper` can fail to detect
 complex heap scenarios and/or provide some false positive alerts. Each finding must of course be
@@ -57,12 +57,12 @@ gef➤  gef config heap-analysis-helper.check_uaf False
 Then `gef` will not notify you of any inconsistency detected, but simply display a clear message
 when a chunk is allocated/freed.
 
-![heap-track](https://i.imgur.com/68NGTvw.png)
+![heap-track](assets/images/heap-track.png)
 
 To get information regarding the currently tracked chunks, use the `show` subcommand:
 
 ```text
 gef➤  heap-analysis-helper show
 ```
 
-![heap-analysis-helper-show](https://i.imgur.com/0I4jBWJ.png)
+![heap-analysis-helper-show](assets/images/heap-analysis-helper-show.png)
diff --git a/docs/commands/heap.md b/docs/commands/heap.md
@@ -46,7 +46,7 @@ Displays all the chunks from the `heap` section of the current arena.
 gef➤ heap chunks
 ```
 
-![heap-chunks](https://i.imgur.com/y90SfKH.png)
+![heap-chunks](assets/images/heap-chunks.png)
 
 To select from which arena to display chunks either use the `heap set-arena` command or provide the
 base address of the other arena like this:
@@ -55,15 +55,15 @@ base address of the other arena like this:
 gef➤ heap chunks [arena_address]
 ```
 
-![heap-chunks-arena](https://i.imgur.com/y1fybRx.png)
+![heap-chunks-arena](assets/images/heap-chunks-arena.png)
 
 In order to display the chunks of all the available arenas at once use
 
 ```text
 gef➤ heap chunks -a
 ```
 
-![heap-chunks-all](https://i.imgur.com/pTjRJFo.png)
+![heap-chunks-all](assets/images/heap-chunks-all.png)
 
 Because usually the heap chunks are aligned to a certain number of bytes in memory GEF automatically
 re-aligns the chunks data start addresses to match Glibc's behavior. To be able to view unaligned
@@ -76,7 +76,7 @@ To get a higher level overview of the chunks you can use the `--summary` flag to
 gef➤ heap chunks --summary
 ```
 
-![heap-chunks-summary](https://i.imgur.com/3HTgtwX.png)
+![heap-chunks-summary](assets/images/heap-chunks-summary.png)
 
 Sometimes, multiple types of objects could have the same size, hence it might not be enough only
 knowing the chunk size when debugging issues like memory leaks. GEF supports using the vtable to
@@ -87,7 +87,7 @@ with the `--summary` flag.
 gef➤ heap chunks --summary --resolve
 ```
 
-![heap-chunks-summary-resolve](https://i.imgur.com/2Mm0JF6.png)
+![heap-chunks-summary-resolve](assets/images/heap-chunks-summary-resolve.png)
 
 Heap chunk command also supports filtering chunks by their size. To do so, simply provide the
 `--min-size` or `--max-size` argument:
@@ -96,7 +96,7 @@ Heap chunk command also supports filtering chunks by their size. To do so, simpl
 gef➤ heap chunks --min-size 16 --max-size 32
 ```
 
-![heap-chunks-size-filter](https://i.imgur.com/AWuCvFK.png)
+![heap-chunks-size-filter](assets/images/heap-chunks-size-filter.png)
 
 The range is inclusive, so the above command will display all chunks with size >=16 and <=32.
 
@@ -107,7 +107,7 @@ of the chunks in the output:
 gef➤ heap chunks --count 1
 ```
 
-![heap-chunks-size-filter](https://i.imgur.com/EinuDAt.png)
+![heap-chunks-size-filter](assets/images/heap-chunks-size-filter.png)
 
 ### `heap chunk` command
 
@@ -118,7 +118,7 @@ the user memory pointer of the chunk to show the information related to a specif
 gef➤ heap chunk [address]
 ```
 
-![heap-chunk](https://i.imgur.com/WXpHR58.png)
+![heap-chunk](assets/images/heap-chunk.png)
 
 Because usually the heap chunks are aligned to a certain number of bytes in memory GEF automatically
 re-aligns the chunks data start addresses to match Glibc's behavior. To be able to view unaligned
@@ -145,7 +145,7 @@ Multi-threaded programs have different arenas, and the knowledge of the `main_ar
 `gef` therefore provides the `arena` sub-commands to help you list all the arenas allocated in your
 program **at the moment you call the command**.
 
-![heap-arenas](https://i.imgur.com/RUTiADa.png)
+![heap-arenas](assets/images/heap-arenas.png)
 
 ### `heap set-arena` command
 

diff --git a/docs/commands/memory.md b/docs/commands/memory.md
@@ -3,7 +3,7 @@
 As long as the 'memory' section is enabled in your context layout (which it is by default), you can
 register addresses, lengths, and grouping size.
 
-![memory watch](https://i.imgur.com/NXYwSwW.png)
+![memory watch](assets/images/memory watch.png)
 
 _Note_: this command **should NOT** be mistaken with the [GDB `watch`
 command](https://sourceware.org/gdb/current/onlinedocs/gdb/Set-Watchpoints.html) meant to set
@@ -38,7 +38,7 @@ gef ➤ memory watch $_got()+0x18 5
 
 Which, when the `context` is displayed, will show something like:
 
-![gef-context-memory](https://i.imgur.com/3YabwYv.png)
+![gef-context-memory](assets/images/gef-context-memory.png)
 
 ### Removing a watch
 

diff --git a/docs/commands/pcustom.md b/docs/commands/pcustom.md
@@ -110,7 +110,7 @@ gef➤  dt person_t
 By providing an address or a GDB symbol, `gef` will apply this user-defined structure to the
 specified address:
 
-![gef-pcustom-with-address](https://i.imgur.com/vWGnu5g.png)
+![gef-pcustom-with-address](assets/images/gef-pcustom-with-address.png)
 
 This means that we can now create very easily new user-defined structures
 
@@ -120,8 +120,8 @@ For a full demo, watch the following tutorial:
 
 Additionally, if you have successfully configured your IDA settings, you can also directly import
 the structure(s) that was(were) reverse-engineered in IDA directly in your GDB session:
-![ida-structure-examples](https://i.imgur.com/Tnsf6nt.png) - (see `gef-extras/ida-rpyc`, which is
-the new improved version of `ida-interact`)
+![ida-structure-examples](assets/images/ida-structure-examples.png) - (see `gef-extras/ida-rpyc`,
+which is the new improved version of `ida-interact`)
 
 #### Dynamic `ctypes.Structure`-like classes
 

diff --git a/docs/commands/scan.md b/docs/commands/scan.md
@@ -29,4 +29,4 @@ gef➤  scan stack libc
 To check mappings without a path associated, an address range (start-end) can be used. Note that
 ranges don't include whitespaces.
 
-![scan-address](https://i.imgur.com/ExJC2p7.png)
+![scan-address](assets/images/scan-address.png)