play - Terminal Mini Games

10 classic games in your terminal. Zero dependencies. Just play.

 ╔═╗╦  ╔═╗╦ ╦╔╦╗╔═╗  ╔═╗╔═╗╔╦╗╔═╗╔═╗
 ║  ║  ╠═╣║ ║ ║║║╣   ║ ╦╠═╣║║║║╣ ╚═╗
 ╚═╝╩═╝╩ ╩╚═╝═╩╝╚═╝  ╚═╝╩ ╩╩ ╩╚═╝╚═╝
            Play while you wait

Install

pip install claude-games

Or from source:

git clone https://github.com/kirti34n/claude-games.git
cd claude-games
pip install .

Games

Quick Start

play              # Open game menu
play snake        # Jump straight into Snake
play tetris       # Jump straight into Tetris
play list         # See all games + high scores

Controls

 WASD / Arrow Keys   Move / Navigate
 Space               Jump (Dino) / Hard Drop (Tetris) / Launch (Breakout) / Fire (Shooter) / Serve (Pong)
 W                   Rotate (Tetris)
 P                   Pause
 ESC / Q             Quit (auto-saves progress)
 ?/H                 Show controls help
 F                   Flag (Minesweeper)
 T                   Cycle color theme (menu)
 R                   Retry after game over

Features

• Auto-save — Quit mid-game with ESC, resume next time you play
• High scores — Tracked per game, shown in menu
• Zero dependencies — Pure Python, just curses (built-in)
• Single file — Entire codebase is one play.py
• Difficulty selection — Choose Easy/Medium/Hard for Shooter and Pong
• In-game help — Press ? during any game to see controls
• Color themes — Cycle themes with T in the menu (default, retro, ocean)
• Sound effects — Terminal beep on new high scores
• Adaptive difficulty — Snake speeds up as you score, Tetris levels up
• Ghost piece — Tetris shows where your piece will land
• Works everywhere — Linux, macOS, WSL2

Claude Code Integration

Works as a slash command inside Claude Code — play games while Claude works in the background.

/play snake         # Launch a game
! play              # Open game menu directly

Turn-based CLI mode for in-conversation play (no terminal needed):

play cli start snake       # Start a CLI game
play cli start 2048        # Start 2048
play cli start minesweeper # Start Minesweeper
play cli start connect4    # Start Connect4
play w                     # Move up (WASD shortcuts)
play show                  # Show current board
play quit                  # End game

How It Works

play.py (single file)
├── Interactive Games (curses)     # Full-screen, real-time
│   ├── Snake
│   ├── Tetris
│   ├── 2048
│   ├── Dino Runner
│   ├── Breakout
│   ├── Space Shooter
│   ├── Pong
│   ├── Flappy Bird
│   ├── Minesweeper
│   └── Pac-Man
├── CLI Games (turn-based)         # Text output, no curses needed
│   ├── Snake
│   ├── 2048
│   ├── Minesweeper
│   └── Connect4
├── Game Menu                      # Arrow keys to select
├── Save/Resume System             # JSON state files
└── Smart Terminal Detection       # Opens new window if no TTY

Config

High scores and saves stored in ~/.config/claude-games/:

~/.config/claude-games/
├── scores.json         # High scores
├── current_game.json   # CLI game state
├── save_snake.json     # Auto-save (created on ESC)
└── save_tetris.json    # ...etc

License

MIT