# Alley Cat: an annotated DOS executable disassembly

> Alley Cat Disassembly is an in-progress effort to turn the DOS game's Ghidra disassembly into annotated NASM x86 assembly. Its source is divided into gameplay, graphics, input, sound and data modules, and progress notes document the MZ header, segment mapping and address translation. The build compares the assembled output with the original cat.exe.

- Type: Case study
- Targets: Game
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/gmegidish/alleycat-disassembly>
- Primary source: <https://github.com/gmegidish/alleycat-disassembly/blob/d2754ef0fd190c5f99cedb55eda6f2fcb4fc145d/README.md>
- Catalog page: <https://awesomerea.org/resources/alley-cat-disassembly-case/>
- Record JSON: <https://awesomerea.org/resources/alley-cat-disassembly-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/alley-cat-disassembly-case/index.md)

## Requirements & limits

- **Prerequisites:** The original cat.exe and NASM are needed for the build comparison.
- **License:** No licence file in the repository.

## Primary sources

1. <https://github.com/gmegidish/alleycat-disassembly/blob/d2754ef0fd190c5f99cedb55eda6f2fcb4fc145d/README.md>
2. <https://github.com/gmegidish/alleycat-disassembly/blob/d2754ef0fd190c5f99cedb55eda6f2fcb4fc145d/PROGRESS.md>

## More in Games

- [Alleyway: a checksum-matched Game Boy disassembly](https://awesomerea.org/resources/alleyway-gb-case/index.md) · Case study
- [Another Life: reconstructing The Witcher 3 save state](https://awesomerea.org/resources/another-life-w3-case/index.md) · Case study
- [Arkanum: reconstructing Arcanum archives and map sectors](https://awesomerea.org/resources/arkanum-arcanum-formats-case/index.md) · Case study
- [ArkWeb: a two-game movement and collision experiment](https://awesomerea.org/resources/arkweb-two-game-case/index.md) · Case study
- [AscNet: reconstructing a Punishing: Gray Raven server](https://awesomerea.org/resources/ascnet-punishing-gray-raven-case/index.md) · Case study
- [AvalonEmu: reconstructing an Albion Online local server](https://awesomerea.org/resources/avalonemu-case/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.