A terminal-based crossword puzzle game built with Go and Bubble Tea.
- Interactive TUI crossword interface
- Support for standard xwordinfo.com JSON puzzle format
- Auto-save progress on exit
- Mlem Puzzle generation using Claude CLI
- Check mode to validate answers
go build -o xword
./xword sample_puzzle.json
Generate a themed crossword puzzle using Claude CLI:
./xword generate "top memes of the 2010s"
./xword generate "jazz music"
./xword generate "gen-z slang words"
This requires the Claude CLI to be installed and authenticated.
- Arrow keys - Navigate the grid
- Letters - Fill in cells (auto-advances in current direction)
- Tab/Enter - Toggle direction (Across/Down)
- Space - Toggle check mode
- Backspace - Delete and move back
- Ctrl+C - Save and quit
Expects JSON files in xwordinfo.com format:
{
"title": "Puzzle Title",
"author": "Author Name",
"size": {"rows": 15, "cols": 15},
"grid": ["C", "A", "T", ".", ...],
"gridnums": [1, 2, 3, 0, ...],
"clues": {
"across": ["1. Clue text", ...],
"down": ["1. Clue text", ...]
}
}
Your progress is automatically saved to {puzzle_file}.progress
when you quit. The game will resume from where you left off when you restart.
- Bubble Tea - TUI framework
- Lipgloss - Terminal styling
- Claude CLI - For AI-powered puzzle generation
The included test puzzle file is from doshea/nyt_crosswords. Puzzle content © The New York Times.