A retro terminal game arcade — 12 games, zero dependencies, pure curses.
Shelly's Arcade is a collection of terminal-based games built entirely in Python with curses. No pip installs, no frameworks — just launch and play.
 Space Invaders |
 Cyberpunk Megacity |
 Tetris |
 Chess |
 Checkers |
 Battleship |
 Blackjack |
 Minesweeper |
 Snake |
 Wordle |
 Hangman |
 2048 |
| Game | Command | Description |
|---|---|---|
| Snake | python3 console_games/snake.py |
Classic snake gameplay in the terminal |
| Space Invaders | python3 console_games/space_invaders.py |
Arcade-style alien shooter clone |
| Tetris | python3 console_games/tetris.py |
Fully playable Tetris with color pieces |
| Game | Command | Description |
|---|---|---|
| 2048 | python3 console_games/game2048.py |
Slide and merge tiles to reach 2048 |
| Minesweeper | python3 console_games/minesweeper.py |
Flag mines, clear the board |
| Chess | python3 console_games/chess.py |
Chess with Unicode pieces and ANSI board |
| Checkers | python3 console_games/checkers.py |
Checkers (Draughts) with AI opponent |
| Battleship | python3 console_games/battleship.py |
Player vs AI naval warfare |
| Game | Command | Description |
|---|---|---|
| Wordle | python3 console_games/wordle.py |
Five-letter word guessing with color feedback |
| Hangman | python3 console_games/hangman.py |
Classic hangman with ASCII art |
| Blackjack | python3 console_games/blackjack.py |
21 with card art and a mustachioed dealer |
| Game | Command | Description |
|---|---|---|
| Cyberpunk Megacity | python3 console_games/cyberpunk/cyberpunk.py |
Neon-drenched terminal roguelite |
Launch the arcade menu to browse and play all games:
python3 console_games/arcade.pyOr run any game directly using the commands in the table above.
- Python 3.12+ with curses support (included on most Linux/macOS systems)
- Terminal emulator with color support (256-color recommended)
- Nerd Font (optional) — several games use Nerd Font glyphs for enhanced visuals
python3 -m pytest console_games/ -vshellys-arcade/
console_games/
arcade.py # Game launcher TUI
snake.py # Each game is a single self-contained file
test_snake.py # Matching test file for each game
cyberpunk/ # Cyberpunk roguelite (multi-file)
...
screenshots/ # Game screenshots for README
This repo is maintained with help from Shelly, an autonomous AI task dispatcher. When issues are labeled on the project board, Shelly picks them up, implements fixes, runs tests, and pushes commits — all automatically. See CLAUDE.md for details on the automation pipeline.
