Analyse Chess Games in Your Terminal

Have you ever wanted to analyse your chess games directly from the terminal? No? Well, in any case, I have made a tool for that!

Here’s a quick start, assuming Debian/Ubuntu (lines starting with :# are comments):

:# (install Stockfish to use for analysis)
sudo apt install stockfish

:# (clone and compile the analysis TUI)
:# (note: this assumes you already have tools like Git, Make, GCC, etc. installed)
git clone --branch=v1 https://git.sr.ht/~zamfofex/moonfish
cd moonfish
make analyse

:# (start analysing from the starting positon!)
:# (note: use the mouse to move the pieces)
./analyse stockfish

:# (analyse a game from a PGN file)
./analyse -G my-game.pgn stockfish

There are also a few recipes that you might want to use to analyse a game directly from Lichess (using Bash syntax):

:# (analyse a specific game from lichess)
./analyse -G <(wget -q -O- 'https://lichess.org/game/export/sFWNnNGm') stockfish

:# (analyse your last game on Lichess)
:# (note: replace "ChancellorPalestine" with your username)
./analyse -G <(wget -q -O- 'https://lichess.org/api/games/user/ChancellorPalestine?max=1') stockfish

The TUI is very simple, but reasonably effective. If there is anything you feel like you miss, suggestions are always welcome!

Make sure to also check out the usage/help message by running just ./analyse by itself.