lantern-games 0.1.0

Terminal games for the idle moments between coding agent runs

Lantern Games

Terminal games you can play without leaving your CLI.

Why

If you use coding agents, you know the feeling: you kick off a task, and then you wait. A few minutes, sometimes longer. Not long enough to do real work. Long enough to get bored.

Opening YouTube or social media fills the gap, but context-switching to a browser pulls you out of flow — and the doomscrolling isn't great for your head.

These are small, clickable terminal games designed for exactly that gap. Low-attention, fun, no window-switching. Play a round while your agent works, then get back to it.

Install

pip install lantern-games

Or from source:

git clone https://github.com/kalpitdixit/lantern-games.git
cd lantern-games
pip install .

Play

lantern treasure-hunt

Or without installing:

git clone https://github.com/kalpitdixit/lantern-games.git
cd lantern-games
python -m lantern_games treasure-hunt

Games

Game	Command	Description
Treasure Hunt	lantern treasure-hunt	Dig for treasure on an 8x8 grid. Find gold, avoid traps, use distance clues to guide your digs. Click or type coordinates.

Requirements

• Python 3.8+
• A terminal with mouse support (Terminal.app, iTerm2, most Linux terminals)
• No external dependencies

Logs

Game logs are saved to ~/.lantern-games/logs/.

License

MIT