chess-term

A modern terminal dashboard for Chess.com rapid games.

Built in Go with:

• Chess.com public API
• beautiful terminal UI
• Elo charts
• activity heatmaps
• recent games timeline
• configurable themes

Designed for modern terminals:

• Kitty
• Ghostty
• Alacritty
• iTerm2
• Nerd Fonts recommended

---

Features

Recent games timeline

Visual overview of your latest rapid games:

🟩🟩🟥🟨🟩🟩🟥🟥🟩🟨

Includes:

• streak detection
• winrate
• W/D/L stats

Elo charts

Track your rapid Elo over:

• last N months
• last N days

Rendered directly in terminal using ntcharts.

Activity heatmap

Daily activity visualization:

▁▂▃▅▇█▆▄▃▁▂▄▆█

Similar to GitHub contributions graphs.

Themes

Multiple built-in color themes:

• blue
• green
• orange
• purple
• cyan
• mono

Screenshot

╭──────────────────────────────────────────────────────╮
│                                                      │
│  ♟ Username · ELO 971                               │
│                                                      │
│  ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■   │
│                                                      │
│  taux de victoire 44 %   💀 -1                       │
│                                                      │
│  7 derniers jours : 948 → 987  ▼ 0                   │
│                                                      │
│  990│  ⡔⢄              ⡠⠢⡀   ⢀  ⡀                  │
│     │⠔⠊  ⠑⠢⠒⠑⢄ ⢀⢄ ⡠⠒⠉⠉⠉  ⠈⠒⠤⠔⠁⠑⠜⠈⠢⡀       ⢀⢄ ⢀⠔│
│  968│         ⠑⠁⠈⠊                ⠈⠢⢄  ⡠⠔⠒⠁ ⠑⠁    │
│     │                                ⠣⠊              │
│  945└────────────────────────────────────────────    │
│                                                      │
│                                                      │
│  3 derniers mois : 823 → 1035  ▼ -45                 │
│                                                      │
│  1056│⠴⢦⣠⣠⡀⢀⣰⣄⣠⣀⣀⣀⡀⡀                              │
│      │ ⠈⠃ ⠙⠋⠁⠈⠉⠙⠉⠈⠙⠛⣤⡀               ⡀  ⢀⢠⣀⣀⣠⠞⠚ │
│   929│               ⠙⠳⣆⡀⡀⡀⢀⣄⡴⠳⢦⣤⠴⢦⣀⠾⠛⠖⠶⠎⠉⠋⠋⠁   │
│      │                 ⠈⠻⠛⠙⠋⠈⠁     ⠁               │
│   802└───────────────────────────────────────────    │
│                                                      │
│                                                      │
│  Activité ces 30 derniers jours                      │
│                                                      │
│         ▃▃▅▂▃▁▅▆▁▃▅▁▂▁▃▃▂▁▁▃▆█▃▁▅▃▅▅▅▁               │
│                                                      │
│         112 parties · 3.7/jour                       │
│                                                      │
╰──────────────────────────────────────────────────────╯

Installation

Clone

git clone https://github.com/goeil/chess-term.git
cd chess-term

Build

go build

Optimized production build:

go build -ldflags="-s -w" -trimpath

Optimized UPX compression:

upx chess-term

Configuration

Create a config.json

{
  "username": "your_chesscom_username",
  "recent_games": 10,
  "activity_days": 14,
  "elo_months": 3,
  "elo_days": 10,
  "theme": "blue"
}

CLI Overrides

CLI arguments override config.json

Example:

./chess-term -u hikaru -n 20 -t green

Available flags

Flag	Description
-u	Chess.com username
-n	Number of recent games
-t	Theme
-d	Short graph duration in days
-m	Long graph duration in months
-a	Activity chart bar in days

Supported Game Mode

Currently filtered to:

• Rapid
• 10 min games (600 time control)

Tech Stack

• Go
• Lipgloss
• ntcharts
• Chess.com public API

Why?

I wanted:

• a lightweight terminal dashboard
• fast startup
• no browser
• no Electron
• beautiful charts directly in CLI

Roadmap

Possible future improvements:

• blitz/bullet/other kind of games support
• opening statistics
• opponent rating distribution
• cached offline mode
• live refresh
• TUI layout mode
• export/share mode

License

MIT