AI-powered solvers for word games, powered by Claude.
| Game | Status | Description |
|---|---|---|
| 🧠 Contexto | ✅ Working | Solves contexto.me — guess the secret word by semantic distance |
| 🟩 Wordle | ✅ Working | Solves NYT Wordle — 5-letter word in 6 guesses with color feedback |
The Contexto solver uses Claude to guess the secret word on contexto.me. The game ranks every guess by semantic distance — 0 means you found the word, higher numbers mean further away.
- 🌱 Seed phase — Casts a wide net with ~33 words across many domains (food, animals, tools, emotions, etc.) to triangulate the general area
- 🤖 Claude loop — Sends the best guesses so far to Claude in batches of 5, with context-aware hints at each distance tier:
d ≤ 3→ ALMOST THERE — try exact synonymsd ≤ 10→ ENDGAME — very close, small variationsd ≤ 100→ VERY CLOSE — right neighborhoodd ≤ 400→ GOOD SIGNAL — stay in this domain
- 🔄 Stuck detection — If 6 guesses pass without improvement and best distance is still > 50, the solver pivots to an unexplored domain from a bank of ~350 words across 31 categories and resets Claude's conversation for a fresh perspective
- 🎯 Victory — Distance
0found!
Rich live dashboard with:
- Real-time guess feed with color-coded distances
- Top 10 leaderboard of closest guesses
- Status panel showing current phase, best distance, and guess count
- Graceful Ctrl+C handling with progress summary
Contexto releases a new game daily. Game numbers increment by 1 each day:
- Game #1254 = February 23, 2026 (anchor point)
- Today's game = anchor + days since anchor
The solver auto-calculates today's game number. Use --game to solve a past or specific game.
The Wordle solver uses Claude to play NYT Wordle. It fetches the daily puzzle, then has Claude guess the 5-letter word with real green/yellow/gray feedback — just like a human would play.
- 📡 Fetch puzzle — Pulls today's answer from the NYT Wordle API (hidden from Claude)
- 🤖 Claude plays — Each turn, Claude picks a 5-letter word based on all previous feedback
- 🎯 Evaluate — The guess is scored against the answer:
- 🟩 Green — correct letter, correct position
- 🟨 Yellow — correct letter, wrong position
- ⬛ Gray — letter not in the word
- 🔁 Repeat — Feedback and constraints are sent back to Claude (up to 6 guesses)
- 📊 Share grid — Win or lose, prints the emoji share grid
Rich live board with:
- Color-coded letter tiles (green/yellow/gray) just like the real game
- Mini keyboard showing known letter states
- Empty rows for remaining guesses
- Supports hard mode (
--hard)
Wordle uses calendar dates instead of game numbers:
- Puzzle #1 = June 19, 2021
- Today's puzzle = auto-detected by date
- Use
--date YYYY-MM-DDto solve any past puzzle
-
Clone and create a virtual environment:
git clone https://github.com/CloudGod93/GameScripts.git cd GameScripts python -m venv .venv source .venv/bin/activate
-
Install in editable mode (picks up all dependencies automatically):
pip install -e . -
Configure your API key — copy the example and add your key:
cp .env.example .env
Then edit
.env:API_KEY=sk-ant-...
contexto-solver # solve today's game
contexto-solver --game 1200 # solve a specific game
contexto-solver --model opus # use Claude Opus instead of Sonnet
contexto-solver --game 1200 --max-guesses 100
contexto-solver --lang pt # Portuguesewordle-solver # solve today's puzzle
wordle-solver --date 2026-01-15 # solve a specific date
wordle-solver --model opus # use Claude Opus instead of Sonnet
wordle-solver --hard # hard mode
wordle-solver --date 2026-01-15 --hard # specific date + hard modeBoth solvers default to Claude Sonnet 4.6. Use
--model opusfor Claude Opus 4.6.
Want to add a solver for another word game? Contributions are welcome!
- Fork the repo
- Create a new branch (
git checkout -b add-wordle-solver) - Add your game solver in its own folder (e.g.
wordle/) - Add a
[project.scripts]entry inpyproject.tomlfor the CLI command - Open a PR
Each game gets its own package directory. Shared config (.env, pyproject.toml) lives at the root.
MIT — do whatever you want with it.