Install once. Read the panel.
Everything needed to load Ghost, pull the engine, read the panel and find the switch when something looks dead.
Before you start
The builds are unpacked Chrome extensions. They are not web apps and they are not installed from the Chrome Web Store.
- Desktop Chrome 116+ on Windows, macOS or Linux. Mobile browsers cannot load unpacked extensions.
- A real folder for the build. Do not load from inside a zip — extract first and keep the manifest at the root.
- Ghost: a chess.com session in the same Chrome profile.
- Your license key and order ID. Keep both; the desk uses the order ID for resets and replacements.
Ghost install
One extension, one offscreen engine, one panel on chess.com.
Extract the build
Put the delivered folder somewhere permanent, for example C:\Users\you\tools\0x21-ghost. The folder contains manifest.json, content.js, overlay.js, engine\ and the icons.
Load unpacked
Open chrome://extensions, enable Developer mode, press Load unpacked and select the folder. Pin the ghost icon to the toolbar.
Pull the engine
If engine\stockfish-19.js is missing, open a PowerShell window in the extension folder and run the downloader. It fetches the full NNUE build and the single-thread fallback.
cd C:\Users\you\tools\0x21-ghost
powershell -ExecutionPolicy Bypass -File .\get-engine.ps1 -Flavor fullReload and open a game
Press the reload arrow on the extension card, then open chess.com and start a game. The 0x21 panel appears; the engine boots in the background. Press F2 if the overlay is hidden.
Controls
The popup holds every switch; the panel draws the state. Settings are saved in chrome.storage.local.
| control | what it does |
|---|---|
| autoplay | after the engine's final line, plays the move. Verifies placement after every gesture, retries once. |
| humanizer | random 300–1200 ms pause before the move fires. |
| auto side | own follows board orientation · both answers every move. |
| lines | 1 / 2 / 3 best lines. Amber is the top line; green and grey follow. |
| speed | RUSH 140 ms · NORMAL clock-scaled 140–1500 ms · DEEP 1500 ms. |
| auto replay | after game over: rematch bots, new opponent after a human win, offer after a loss. |
| next game | smart · rematch always · new always queue fresh. |
| trusted input | last rung of the ladder; real mouse events through chrome.debugger. Chrome shows its infobar while attached. |
| F2 | show / hide the overlay. |
| Alt + F2 | cycle 1 / 2 / 3 lines. |
Orders and keys
Checkout creates a local order record with an ID. Card opens the provider's secure checkout; crypto shows the address and USD total when a wallet is configured. No card details touch this site.
- Add a license to the cart and press Checkout.
- Enter an email for the record, choose card or crypto and create the order.
- Press Pay online to finish on the hosted checkout, or Copy for desk for crypto support.
- Keep the provider receipt or transaction id. The key is issued against the order ID after payment confirms.
- Look the order up later under Orders on the same browser, or with the ID at the desk.
Troubleshooting
Most failures are install-state, not build-state. Check the extension card first.
| symptom | fix |
|---|---|
| Ghost panel missing | Press F2. Confirm the extension is enabled and the game is on chess.com. Reload the tab once after loading the extension. |
| Engine never boots | engine\ is empty or incomplete. Run the PowerShell downloader, then reload the extension. Check the offscreen console for the chosen build. |
| Autoplay stalls | A gesture was rejected. The ladder retries once; if the board stays blocked the panel marks the position and moves on. Turn on trusted input if synthetic gestures keep failing. |
| Chrome debug infobar appears | Expected. Trusted input attaches chrome.debugger for one move and detaches immediately. |
| Key rejected | Check the term and the machine limit. Open a desk ticket with the order ID and the activation message. |
Updates
Updates are folder replacements, not store installs. Download the new build, close the target page, replace the folder contents, then reload the extension card.
- Keep your settings: they live in extension storage and survive a folder swap. Removing the extension clears them.
- The manifest version is the truth. If the panel header and the card disagree, Chrome is running an old copy — press reload.
- After a site-side change, a rebuild ships before anything else. Do not patch the extension yourself unless the desk tells you to.
- Lifetime licenses cover all 2.x builds. Term licenses cover updates while the term is active.
Licensed. Loaded. Probed.
If the build is not moving, the problem is usually install state. Read the section again or open the desk.