About GitGuessr
GeoGuessr but for code
What is GitGuessr?
GitGuessr is a game that tests your code reading skills. You're dropped into a random location in a real GitHub repository where some lines of code are masked. Your goal is to understand the codebase and fill in the missing code as quickly as possible.
It's fun! But there's also a serious background. GitGuessr trains a key programming skill in the AI era: orienting yourself quickly in unfamiliar code that your favorite LLM just spat out.
How to Play
1. Choose a Code Map — curated collections of code locations with varying difficulty levels. You'll play 5 rounds with randomly chosen locations from the map.
2. In each round, you'll be shown a file with one or more lines of code hidden. Browse the file and the whole repository to understand the codebase. Look at related files, imports and documentation.
3. Type in your guess for the missing code. The orange background on each line shows you how many characters are expected. But you don't have to match the code character by character, you can omit optional characters such as whitespace.
4. Submit your guess. If you're right you'll advance to the next round. Each bad guess deducts 200 points from your score. If you can't get the right answer you can skip the round, but you'll score zero for that round.
5. The game ends after 5 rounds. Your final score is the sum of your round scores. The faster you complete each round, the more you score.
Scoring
The maximum for each round is 2000 points, so the maximum for a full game is 10000. For each second you spend in a round 10 points are deducted. For each bad guess you lose 200 points. Skipped rounds score zero.
Sharing a Game
At the start of each new game, 5 rounds from the map are randomly selected. To compete directly with friends send them the share link shown on the start and end screens of the game.
Anybody who uses the share link to start a game will play the exact same sequence of rounds as you, rather than random rounds.
Code Maps
We stole the idea of a "map" from GeoGuessr. Maps are curated collections of code locations from various GitHub repositories. Each map has a difficulty rating (Easy, Medium, or Hard) and will tell you which languages its locations are sourced from.
Players can create their own maps, see documentation. You should try it!