- TypeScript 61%
- Rust 23.4%
- CSS 11.7%
- JavaScript 2.1%
- PLpgSQL 0.9%
- Other 0.9%
On wide screens the review panel stops scrolling while the move list shows (the list scrolls itself), so a long coach answer ran past the panel's edge and could not be reached. There the coach now shrinks to the room left and scrolls on its own, and it keeps the newest text in view while an answer streams in, unless the reader has scrolled up. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> |
||
|---|---|---|
| .github/ISSUE_TEMPLATE | ||
| blog | ||
| docs | ||
| functions/engine | ||
| pages | ||
| public | ||
| scripts | ||
| server | ||
| shared | ||
| src | ||
| supabase | ||
| .env | ||
| .env.server | ||
| .env.web | ||
| .envrc | ||
| .gitignore | ||
| .nvmrc | ||
| .oxlintrc.json | ||
| AGENTS.md | ||
| CLAUDE.md | ||
| embed.html | ||
| flake.lock | ||
| flake.nix | ||
| index.html | ||
| LICENSE | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| tsconfig.app.json | ||
| tsconfig.json | ||
| tsconfig.node.json | ||
| vite.config.ts | ||
Free, unlimited chess game review in your browser.
Stockfish 19 grades every move, from Legendary to Blunder. No sign-up, no limit, no paywall.
rookahead.com · Blog · What's new · Discord · YouTube · Donate
What it does
- Game review. Bring in your games by Chess.com or Lichess username, or paste a PGN. Every move gets one of eleven verdicts, from Legendary and Clutch down to Mistake, Oversight and Blunder, plus each side's accuracy and the key moments on an eval graph.
- Explain. Ask why a move was good or bad: the threat, what the move does, how it loses, and the better line, played out on the board.
- On your own device. Stockfish 19 runs in your browser, multi-threaded, with the full NNUE network. Your games are never uploaded, which is why it can be free and unlimited.
- Puzzles. Rated puzzles, Puzzle Sprint, a daily puzzle, and puzzles made from the mistakes in your own games.
- Play the computer at eight levels, from 400 to 2600, with any time control.
- Analysis board for any position, PGN or FEN, with up to five engine lines.
- Share a game or a single move as a link, an image, a GIF or an embedded board.
- Accounts are optional. Sign up only if you want your games and progress on every device.
How moves are graded
The rules behind every verdict are written down in docs/rulebook.md, and src/lib/classify.ts follows them. The blog explains them with examples: How Rookahead grades a move and What counts as a sacrifice.
Support Rookahead
Rookahead is free for everyone, and every feature stays free. If it helps your chess, you can help keep it going:
- rookahead.com/donate (UPI in India)
- GitHub Sponsors
- Buy Me a Coffee
Starring the repo, sharing Rookahead with a friend and reporting bugs help too. Come and talk chess on Discord.
Development
Running it
npm install # also copies the Stockfish builds into public/engine/
npm run dev # http://localhost:5173
Requires Node 20+. It starts on the Lite engine, a 2 MB network that loads instantly (still far stronger than any human). Pick Full in Settings for the strongest analysis: that downloads the ~100 MB network once, and the browser caches it after that.
Multi-threading
Multi-threaded WASM needs SharedArrayBuffer, which browsers only allow on cross-origin isolated pages.
The dev and preview servers send the required headers (see vite.config.ts):
Cross-Origin-Opener-Policy: same-origin
Cross-Origin-Embedder-Policy: require-corp
If you host the built dist/ elsewhere, send those two headers too, or the app falls back to a single thread.
How moves are classified
Rookahead's own rules for every verdict live in docs/rulebook.md; src/lib/classify.ts follows them.
The opening book is Lichess's CC0 opening list (src/data/openings.json).
- Accuracy — Lichess's open formula (volatility-weighted and harmonic means of per-move accuracy)
To rebuild the opening book: node scripts/build-openings.mjs <dir with a.tsv … e.tsv> from
https://github.com/lichess-org/chess-openings.
Keyboard
| Key | Action |
|---|---|
| ← / → | Previous / next move |
| ↑ / Home | Start of the game |
| ↓ / End | End of the current line |
| F | Flip the board |
| L | Toggle the engine |
| Space | Play through the moves |
Scripts
| Command | |
|---|---|
npm run dev |
Dev server |
npm run build |
Type-check and build to dist/ |
npm run preview |
Serve the build (with isolation headers) |
npm test |
Unit tests (Vitest) |
npm run lint |
Lint (oxlint) |
Set localStorage.setItem('rookahead.debug', '1') in the browser console to log all UCI traffic.
Layout
src/
engine/Engine.ts Stockfish worker wrapper: UCI, one-search-at-a-time queue, cancellation
hooks/useAnalysis.ts Live analysis (with per-position cache) and full-game review
hooks/useEngine.ts Engine lifecycle
lib/tree.ts Game tree (main line + variations), PGN import/export
lib/uci.ts UCI "info" line parser
lib/evaluation.ts Score conversion, win %, formatting
lib/chesscom.ts Chess.com public API client
components/ Board (Chessground), eval bar & graph, move list, engine lines, dialogs
Licences
Rookahead is free software under the GNU General Public License v3.0 or later (see LICENSE).
It builds on Stockfish.js (GPL-3.0) and Chessground (GPL-3.0-or-later), so anyone serving the app must also offer its source under the GPL.
Explain's board ideas (src/lib/ideas.ts) follow the rules of what'sthisposition (GPL-3.0). The opening book comes from Lichess's chess-openings (CC0), and the Syne, DM Sans and DM Mono fonts are under the SIL Open Font License.