clmystery: A command-line murder mystery lands on GitHub

The setup

A new repository on GitHub turns the humble terminal into a crime scene. clmystery, by Noah Veltman, drops players into "Terminal City" where — it has been reported that — a murder must be solved using nothing but command-line tools. The project arrives as a neat bit of nostalgia for people who grew up in terminals and a friendly, low-friction way for newcomers to learn basic shell commands. Strange ASCII art greets you. Moody! Perfect.

How to play

Clone the repo or download the zip, open a Terminal in the repo folder, and start by reading the file named instructions. A simple cat instructions will do the trick; cheatsheet.md or cheatsheet.pdf are there to teach you the commands. It has been reported that the rules ask you not to open files with a text editor except for the instructions, cheatsheet, and hints — allegedly to keep the mystery intact. Small constraints. Big payoff.

Why this matters

This is more than a toy. Gamified learning — puzzles that teach tooling — is a rising trend in developer education, and clmystery fits right in. It’s fun, but it’s also quietly practical: you type, you learn, you feel clever. Who knew basic piping and grepping could be so detective-like? Ready to be both sleuth and sysadmin? Pull up your terminal and find out.

Sources: github.com/veltman, Lobsters