# Pokémon HeartGold and SoulSilver: a fork reporting a complete LLM-agent decompilation

> Continues pret’s HeartGold/SoulSilver disassembly in a separate fork that reports the US Nintendo DS releases fully decompiled to C and C++ with LLM agents, while both ROMs still rebuild byte-for-byte against their retail SHA-1s. A checked-in progress report counts about 99% of mapped code bytes as C or C++, and a batch-by-batch work log records each replaced assembly range and the hash checks that followed. README says pret does not accept AI-generated code and does not want to be associated with the fork.

- Type: Case study
- Targets: Game
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-10-19
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/ctrl-cheeb-del/pokeheartgold>
- Primary source: <https://github.com/ctrl-cheeb-del/pokeheartgold/blob/2fc93ea893b6976c0006c9a77a34c99b7995471b/README.md>
- Catalog page: <https://awesomerea.org/resources/pokeheartgold-llm-agent-decomp-case/>
- Record JSON: <https://awesomerea.org/resources/pokeheartgold-llm-agent-decomp-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/pokeheartgold-llm-agent-decomp-case/index.md)

## Requirements & limits

- The fork reports HeartGold and SoulSilver builds matching the US retail ROM SHA-1 hashes. Its HeartGold progress snapshot counts 97.9% of mapped code bytes as C, 1.4% as C++ and 0.6% as original assembly; INSTALL.md defines this as a source-language measure.
- Builds require a legally obtained Metrowerks mwccarm 2.0/sp2p2 compiler and license file, plus tools/bin and linker templates from a Nitro SDK archive. Both proprietary inputs are supplied by the user. The repository includes DS filesystem assets under files/ and decompiled libraries under lib/.
- Linux requires binutils-arm-none-eabi, Wine, Python 3, libpng, pkg-config and pugixml. Windows uses devkitARM under Cygwin or MSYS2; macOS requires 10.15 or later and Rosetta 2 on Apple silicon. The build checks ARM binaries, filesystem and ROM hashes; the fork’s GitHub build workflow is disabled.
- The repository has no license file. Its README reports LLM-agent assistance and asks contributors to keep this fork’s code out of pret/pokeheartgold; pret prohibits LLM-generated contributions.

## Primary sources

1. <https://github.com/ctrl-cheeb-del/pokeheartgold/blob/2fc93ea893b6976c0006c9a77a34c99b7995471b/README.md>
2. <https://github.com/ctrl-cheeb-del/pokeheartgold/blob/2fc93ea893b6976c0006c9a77a34c99b7995471b/INSTALL.md>
3. <https://github.com/ctrl-cheeb-del/pokeheartgold/blob/2fc93ea893b6976c0006c9a77a34c99b7995471b/docs/DECOMP-NOTES.md>
4. <https://github.com/ctrl-cheeb-del/pokeheartgold/blob/2fc93ea893b6976c0006c9a77a34c99b7995471b/docs/progress/progress.json>
5. <https://github.com/ctrl-cheeb-del/pokeheartgold/blob/2fc93ea893b6976c0006c9a77a34c99b7995471b/heartgold.us/rom.sha1>
6. <https://github.com/ctrl-cheeb-del/pokeheartgold/blob/2fc93ea893b6976c0006c9a77a34c99b7995471b/CONTRIBUTING.md>
7. <https://github.com/ctrl-cheeb-del/pokeheartgold/tree/2fc93ea893b6976c0006c9a77a34c99b7995471b/files>
8. <https://github.com/ctrl-cheeb-del/pokeheartgold/tree/2fc93ea893b6976c0006c9a77a34c99b7995471b/lib>
9. <https://github.com/pret/pokeheartgold/blob/5bb4b3b4961cbf0f8a42360c58a3c045d8535069/CONTRIBUTING.md>

## More in Games

- [Pokémon HeartGold and SoulSilver: a work-in-progress, checksum-matched DS disassembly](https://awesomerea.org/resources/pokemon-heartgold-soulsilver-disassembly-case/index.md) · Case study
- [Pokémon Platinum: a checksum-matched Nintendo DS decompilation](https://awesomerea.org/resources/pokemon-platinum-decomp-case/index.md) · Case study
- [Pokémon Puzzle League: matching Nintendo 64 decompilation](https://awesomerea.org/resources/puzzleleague64/index.md) · Case study
- [Pokémon Rumble: an early Wii decompilation](https://awesomerea.org/resources/pokemon-rumble-decomp-case/index.md) · Case study
- [Pokémon Stadium 2: matching Nintendo 64 decompilation](https://awesomerea.org/resources/pokestadiumgs-case/index.md) · Case study
- [Pokémon Stadium: matching Nintendo 64 decompilation](https://awesomerea.org/resources/pokestadium/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.