Skip to content

paperlantern-ai/lantern-games

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

About

Terminal games for the idle moments between coding agent runs

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages