Skip to content

physicalaff/Knight-Chess-Helper

Repository files navigation

Knight Chess Helper

♞ Knight Chess Helper

A modern, local-first chess analysis assistant for Chess.com — powered by Stockfish WebAssembly.

Fast · Local · Open Source · Privacy-First · Manifest V3


📑 Table of Contents

Click any section to jump straight to it.


✨ Why Knight?

Knight is a clean, modern chess assistant built for analysis, study, opening preparation and post-game review directly inside your browser.

Unlike many browser chess tools, Knight runs a local Stockfish WebAssembly engine — nothing is sent to a remote server, so analysis is fast, private and works offline. The interface is rebuilt from the ground up with a focus on speed, clarity and a genuinely premium feel.

🧠  Local engine      →  no external API, full privacy
⚡  Instant analysis  →  evaluation & best lines in real time
🎨  Modern UI         →  redesigned dark/light themes, zero clutter
🔒  Privacy-first     →  your games never leave your machine

🎯 Features

Feature Description
🧠 Stockfish Engine Local WebAssembly engine — fast, private, offline-capable
📊 Position Strength Live centipawn evaluation bar with a clean numeric readout
🎯 Best-Move Hints Visual arrows drawn directly on the board
📖 Opening Book Opening recognition and preparation suggestions
📈 Match Statistics Offline tracking of moves, phases and game history
🌍 Multi-Language English & Russian out of the box
🌗 Light & Dark Themes A polished theme switcher in a dedicated Settings tab
Manifest V3 Modern, service-worker based, future-proof architecture

📸 Interface Preview

Click to expand screenshots


🛠️ Installation

Knight is distributed via GitHub and loaded as an unpacked extension (it is not on the Chrome Web Store).

Chromium browsers (Chrome, Edge, Brave, Opera)

  1. Download the latest release .zip.
  2. Extract it into a dedicated folder.
  3. Open chrome://extensions in your browser.
  4. Enable Developer mode (top-right).
  5. Click Load unpacked and select the extracted folder.
  6. Open Chess.com and click the floating Knight icon.

📘 Need pictures? A full step-by-step walkthrough with screenshots lives in the User Guide.

Firefox (experimental)

Open about:debuggingThis FirefoxLoad Temporary Add-on and pick any file inside the extension folder.

⚠️ Firefox support is in beta — most features work, but some may behave differently.


📖 Documentation

Document What's inside
📘 User Guide Full feature tour, interface reference, settings, install walkthrough, troubleshooting
🤝 Contributing How to build, the code architecture, and how to open a good PR

The User Guide ships with a clickable table of contents — every heading is a jump-link, so you can navigate the docs like chapters.


🏗️ Architecture

Knight is split into focused, single-responsibility modules:

Layer Responsibility
Content scripts (ui.js, mouse.js, book.js, stats.js) Inject the dashboard, draw on the board, track stats
Background service worker (background.js) Coordinate messages and engine requests (Manifest V3)
Offscreen document (offscreen.js) Host the Stockfish WebAssembly worker
Engine layer (engine.js) Run analysis, manage retries and evaluation parsing

This keeps analysis responsive while staying fully compatible with Manifest V3.


🗺️ Roadmap

  • Stockfish WebAssembly integration
  • Opening book
  • Statistics tracking
  • Full UI redesign (light & dark themes)
  • Multi-language support
  • Puzzle / tactics trainer
  • Exportable analysis reports
  • Additional languages

🤝 Contributing

Contributions are very welcome! 💙

  • Star the repo to support the project
  • 🐛 Report bugs via Issues
  • 💡 Suggest features you'd like to see
  • 🔀 Open a PR — see CONTRIBUTING.md for setup and guidelines

⚖️ Responsible Use

Knight is built for learning, analysis, opening preparation and reviewing your own games.

Please use it responsibly and respect the Terms of Service of any platform where you play. Don't use Knight to gain an unfair advantage in live games against other people — that's not what it's for, and it ruins the game for everyone.


📝 License

Knight Chess Helper is released under the MIT License. Stockfish is licensed under the GPLv3.


If Knight helps your chess, consider leaving a ⭐ — it genuinely helps the project grow.

About

Chess.com helper extension with auto-play (not cheat), best move hints, 1000-1500 ELO human-like engine. Undetectable chess helper with natural mouse movement and thinking time.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors