# 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

```bash
pip install lantern-games
```

Or from source:

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

## Play

```bash
lantern treasure-hunt
```

Or without installing:

```bash
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
