No description
  • TypeScript 61%
  • Rust 23.4%
  • CSS 11.7%
  • JavaScript 2.1%
  • PLpgSQL 0.9%
  • Other 0.9%
Find a file
Harald Hoyer 3a92709494 Let a long coach answer scroll in the review panel and follow it
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>
2026-11-19 12:52:54 +01:00
.github/ISSUE_TEMPLATE Issue forms for bugs, ideas and verdicts 2026-10-27 06:34:51 +00:00
blog Puzzle panels, coach bubbles, last-move strength 2026-11-18 07:40:47 +00:00
docs Merge upstream Rookahead (175 commits, up to 2ad164d0) into the trainer 2026-11-18 22:47:22 +01:00
functions/engine Settings page and Full Stockfish 2026-10-20 06:26:28 +00:00
pages Add friends: requests, a friends list, and games sent between friends 2026-11-09 15:38:58 +00:00
public Never load forever on a bad bundle 2026-11-18 08:51:19 +00:00
scripts Merge upstream Rookahead (175 commits, up to 2ad164d0) into the trainer 2026-11-18 22:47:22 +01:00
server Let the model server pick the coach's temperature and cap its thinking 2026-11-19 12:44:22 +01:00
shared Pin the loss bands in the shared vectors 2026-10-26 16:34:52 +01:00
src Let a long coach answer scroll in the review panel and follow it 2026-11-19 12:52:54 +01:00
supabase Add friends: requests, a friends list, and games sent between friends 2026-11-09 15:38:58 +00:00
.env Accounts: sign up with Google or email, and sync 2026-10-18 15:41:28 +00:00
.env.server Run the app against the private server in server mode 2026-10-26 10:59:09 +01:00
.env.web Settings page and Full Stockfish 2026-10-20 06:26:28 +00:00
.envrc Start the private server crate 2026-10-26 10:31:33 +01:00
.gitignore Merge upstream Rookahead (175 commits, up to 2ad164d0) into the trainer 2026-11-18 22:47:22 +01:00
.nvmrc Rookahead: chess game review with Stockfish 19 in the browser 2026-10-18 03:45:12 +00:00
.oxlintrc.json Rookahead: chess game review with Stockfish 19 in the browser 2026-10-18 03:45:12 +00:00
AGENTS.md Link AGENTS.md to CLAUDE.md for other coding agents 2026-10-28 21:38:28 +01:00
CLAUDE.md Note that the review version numbers follow upstream's 2026-11-18 23:09:21 +01:00
embed.html Share games as links, images, GIFs and embeds 2026-10-18 05:22:05 +00:00
flake.lock Start the private server crate 2026-10-26 10:31:33 +01:00
flake.nix Update the npm dependency hash for the merged lockfile 2026-11-18 23:06:15 +01:00
index.html Never load forever on a bad bundle 2026-11-18 08:51:19 +00:00
LICENSE Rookahead: chess game review with Stockfish 19 in the browser 2026-10-18 03:45:12 +00:00
package-lock.json Add a Donate page and tab to the blog 2026-10-27 04:09:31 +00:00
package.json Merge upstream Rookahead (175 commits, up to 2ad164d0) into the trainer 2026-11-18 22:47:22 +01:00
README.md Credit what'sthisposition for Explain's board ideas 2026-11-05 02:43:59 +00:00
tsconfig.app.json Rookahead: chess game review with Stockfish 19 in the browser 2026-10-18 03:45:12 +00:00
tsconfig.json Rookahead: chess game review with Stockfish 19 in the browser 2026-10-18 03:45:12 +00:00
tsconfig.node.json Rookahead: chess game review with Stockfish 19 in the browser 2026-10-18 03:45:12 +00:00
vite.config.ts Run the app against the private server in server mode 2026-10-26 10:59:09 +01:00

Rookahead

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

Rookahead reviewing Morphy's Opera Game: 16.Qb8+ is Legendary

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.

Rookahead's home page

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:

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.