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.