diff --git a/gdb.yaml b/gdb.yaml
new file mode 100644
index 0000000..97b21ff
--- /dev/null
+++ b/gdb.yaml
@@ -0,0 +1,96 @@
+project_summary:
+  category: "tools"
+  home_text: "_There are multiple homes for this project, see the [Get Involved](#get-involved) section._"
+  short_description: "CHERI-enabled fork of GDB"
+  description: |- 
+    "[GNU Debuger](https://www.sourceware.org/gdb/) is a portable debug utility that can run/attach to other processes and inspect how these processes (and their children) are accessing the system memory and how the code ends up in and interacts with hardware registers.
+
+    It can also have control over the program counter and therefore the code execution and stop the debugged process execution at any point given some set of initial conditions. GDB also allows to override variables and registers on the fly to see what WOULD happen if say a different branches of the child process were to be executed, which can be useful.
+
+    So the tool can understand assembly and higher level languages and in general is very good for tracing application execution in real time." 
+
+  status: |-
+    "There are three repositories for GDB, each historically adding support for different architectures, the first development work was done for the University of Cambridge RISC-V architecture (currently at ISAv9) at  [https://github.com/CTSRD-CHERI/gdb](https://github.com/CTSRD-CHERI/gdb) and is currently at version 14.1 of GDB.    
+    However, this repository also has Morello branches, with latest versioned at 14.1, these replaced the initial and canonical GBD Morello from ARM which is now very old (version 11.0.5).
+
+    The GDB for Morello at [https://git.morello-project.org/morello/binutils-gdb](https://git.morello-project.org/morello/binutils-gdb) did their own thing and actually lives in a vendor branch [upstream](https://sourceware.org/git/?p=binutils-gdb.git;a=shortlog;h=refs/heads/users/ARM/morello-binutils-gdb-master) and as already mentioned is at version 11.0.5.
+
+    The GDB hosted at the Cherry Aliance repository [https://github.com/CHERI-Alliance/gdb](https://github.com/CHERI-Alliance/gdb) is really a fork off the UoC repository from [Novermber 2024](https://github.com/CHERI-Alliance/gdb/commit/7c05fb82db7ddd8e009548b8e853657c3512029f) and Codasip has added support for the RISC-V RVY architecture on top of the previous work at UoC, it is also at version 14.1"
+
+
+  vulnerability_contact: "support@thecapablehub.org"
+  download_notes: "There are no pre-built binaries or versioned releases, users must build from source."
+  last_update: "30th January 2026" 
+
+project_contribution:
+  src_tree: |-
+    - [CHERI-Alliance/gdb](https://github.com/CHERI-Alliance/gdb) - 14.1 
+    - [CTSRD-CHERI/gdb](https://github.com/CTSRD-CHERI/gdb) - 14.1
+    - [Morello](https://git.morello-project.org/morello/binutils-gdb) - 11.0.5
+  chat: |-
+    There are is a dedicated Slack channel at the [CHERI CPU Slack](https://www.cl.cam.ac.uk/research/security/ctsrd/cheri/cheri-slack.html) in the `#debuggers` channel.
+  mailing_lists: |-
+    There are no mailing lists associated with this project.
+  meetings: |-
+    There are no regular meetings associated with this project.
+
+buildingFromSource: "Please keep an eye out for our [blog](/blog/) as we will soon share instructions for building from source."
+
+software:
+
+  - arch: "riscv64c"
+    releases:
+     - version: "df929d4 (codasip-cheri-riscv)"
+       version_date: 2025-18-02
+       version_url: "https://github.com/CHERI-Alliance/gdb/tree/codasip-cheri-riscv"
+       latest: true
+       cheri_spec: CHERI RISC-V RVY
+       upstream_version: "v14.1"
+       upstream_date: 2023-12-03
+       upstream_url: "https://sourceware.org/git/?p=binutils-gdb.git;a=commit;h=6bda1c19bcd16eff8488facb8a67d52a436f70e7"
+       images: 
+         - label: "Source"
+           link: "https://sourceware.org/git/?p=binutils-gdb.git;a=commit;h=6bda1c19bcd16eff8488facb8a67d52a436f70e7"
+
+  - arch: "riscv64c"
+    releases:
+     - version: "a686ecf (cheri-14)"
+       version_date: 2025-11-05
+       version_url: "https://github.com/CTSRD-CHERI/gdb"
+       latest: true
+       cheri_spec: CHERI RISC-V ISAv9
+       upstream_version: "v14.1"
+       upstream_date: 2023-12-03
+       upstream_url: "https://sourceware.org/git/?p=binutils-gdb.git;a=commit;h=6bda1c19bcd16eff8488facb8a67d52a436f70e7"
+       images: 
+         - label: "Source"
+           link: "https://sourceware.org/git/?p=binutils-gdb.git;a=commit;h=6bda1c19bcd16eff8488facb8a67d52a436f70e7"
+
+  - arch: "aarch64c"
+    releases:
+     - version: "f1d9c89 (morello-binutils-gdb-14)"
+       version_date: 2024-17-01
+       version_url: "https://github.com/CTSRD-CHERI/gdb"
+       latest: true
+       cheri_spec: Morello
+       upstream_version: "v14.1"
+       upstream_date: 2023-12-03
+       upstream_url: "https://sourceware.org/git/?p=binutils-gdb.git;a=commit;h=6bda1c19bcd16eff8488facb8a67d52a436f70e7"
+       images: 
+         - label: "Source"
+           link: "https://sourceware.org/git/?p=binutils-gdb.git;a=commit;h=6bda1c19bcd16eff8488facb8a67d52a436f70e7"
+
+
+  - arch: "aarch64c"
+    releases:
+     - version: "70d0d9f0 (morello-binutils-gdb-master)"
+       version_date: 2023-12-06
+       version_url: "https://git.morello-project.org/morello/binutils-gdb"
+       latest: true
+       cheri_spec: Morello
+       upstream_version: "v11.0.5"
+       upstream_date: 2020-10-20
+       upstream_url: "https://sourceware.org/git/?p=binutils-gdb.git;a=commit;h=ae86f581c2ac33fc289eb4ac62c0539a7e9c6793"
+       images: 
+         - label: "Source"
+           link: "https://github.com/CHERI-Alliance/qemu"
\ No newline at end of file