From Codebase to Catacombs: Developer Builds Roguelike Dungeon Generator Using GitHub Copilot CLI
Developer Creates Terminal Game That Turns Any GitHub Repository into a Playable Dungeon
A developer has built a tool called GitHub Dungeons that transforms any code repository into a procedurally generated roguelike adventure. The game runs entirely in the terminal, mapping files and commits to rooms, corridors, and enemies.
Players navigate using arrow keys, fight bugs, and search for the exit. Every repository produces a unique dungeon layout, and every new commit reshapes the world. Death means starting over—permadeath is baked in.
“I got nerd-sniped into the GitHub Copilot CLI Challenge and made a questionable decision: I turned my codebase into a roguelike dungeon,” said the developer in a statement. The project was built using Go, a language the developer normally doesn’t use, with heavy assistance from GitHub Copilot CLI.
How the Dungeon Is Generated
The dungeon uses Binary Space Partitioning (BSP) to carve rooms and corridors. The random seed is derived from the repository’s latest commit SHA, ensuring the same codebase always produces the same layout while changes evolve the dungeon naturally.
“Every repository produces a different map. Every commit reshapes the layout,” the developer explained. In practice, different repos feel structurally distinct, and the dungeon becomes a living reflection of the code.
Procedural Generation at Work
Procedural generation creates content algorithmically rather than by hand. In roguelikes, this means levels, enemies, and items are generated at runtime using rules and randomness. This gives each run replayability—layouts change, challenges shift, and death resets everything.
GitHub Dungeons ties this system directly to the codebase. The same commit always yields the same map, but as code evolves, the dungeon evolves with it.
Background: Roguelikes in the Terminal
Roguelikes trace back to the 1980s with games like Rogue—terminal-based adventures where each run generated a new dungeon and death was permanent. That combination of procedural generation, permadeath, and text-based interfaces (later formalized in the Berlin Interpretation) makes the genre feel surprisingly modern and a perfect fit for the command line.
“It’s procedural generation—but tied directly to your codebase. That’s the idea,” the developer noted. GitHub Dungeons leans into that tradition, written in Go with Copilot handling syntax so the developer could focus on behavior.
What This Means for Developers and Gaming
GitHub Dungeons represents a novel intersection of coding productivity tools and game design. By turning the act of coding into an explorable dungeon, it could inspire new ways of gamifying development workflows or debugging sessions.
“The tool is a fun side project, but it shows how AI-assisted coding can open creative doors,” said a game design expert who reviewed the project. “Instead of just writing code, you’re now generating worlds from that code.”
The project also highlights the versatility of GitHub Copilot CLI, which can be used for more than just boosting productivity—it can help developers explore entirely new domains, like procedural game generation.
For now, GitHub Dungeons remains a terminal-based experiment. But it hints at a future where your codebase becomes a playable artifact, and every commit is a new level to conquer.
More Information
The source code and instructions are available on GitHub. The developer encourages others to fork the project and build their own variations. “If your HP hits zero, you start over. That’s the roguelike way,” they added.