Description

Chess-tui is a simple chess game you can play from your terminal. It supports local 2 players mode, online multiplayer, playing against any UCI compatible chess engine, Lichess integration, custom skins and more!

Quick Install

Homebrew:

brew install thomas-mauran/tap/chess-tui
chess-tui

Debian/Ubuntu:

DEB_URL=$(curl -s "https://api.github.com/repos/thomas-mauran/chess-tui/releases/latest" | jq -r '.assets[] | select(.name | endswith(".deb")) | .browser_download_url') && curl -LO "$DEB_URL" && sudo dpkg -i "$(basename "$DEB_URL")" && sudo apt-get install -f
chess-tui

Cargo:

cargo install chess-tui
chess-tui

Available on:

For installation via package managers or other methods, see the Installation Guide.

Features

Local 2 player mode

Play against any UCI chess engine

Lichess Integration

Play online on Lichess directly from your terminal!

See Lichess Features for details.

Online multiplayer

Helper menu

Quick Start

Connect a chess engine:

# Simple engine path
chess-tui -e /path/to/engine

# Engine with command-line arguments (e.g., GNU Chess with UCI mode)
chess-tui -e "/opt/homebrew/bin/gnuchess --uci"

# Stockfish example
chess-tui -e /opt/homebrew/bin/stockfish

See Bot Configuration for details.

Configure Lichess:

chess-tui -l YOUR_LICHESS_TOKEN_HERE

See Lichess Setup for details.

Documentation

📚 Full Documentation

• Installation Guide
• Configuration
• Lichess Features
• Multiplayer Guide

Links

• 📦 Crates.io
• 🗺️ Roadmap
• 🐛 Report Issues