Chess at CLI-Games

Puzzles, vision training, blindfold mode, and AI opponents - all from the command line

guidesView Game Page →Last updated 2026-02-24

Bottom Line Up Front

If you are looking for bullet games, you won't find them here. Chess via CLI is all about taking it slow. Real games with real opponents are supported via snailmail, but the real training value is in strict SAN input parsing, blindfold puzzles, and vision training. Further explanations of each are below.

What's Different Here

Chess on CLI-Games is no-frills. You don't move pieces with a mouse, you type in the SAN instead. This friction point provides a wealth of training value that your opponents will not have. Making a move in chess is in reality an extremely complex biochemical and neurological process. Slowing down and thinking about each step in that process ensures the links between them are battle tested and rock solid. When you first start out, it will feel like a slog. Good - that is by design. When you start to speed up, when it stops hurting, you will know that your process has been optimized and you will see the efficiency gains over the board.

Puzzles from Lichess - Thousands of real positions, rated by difficulty. Filter by ELO range, piece count, or both. Multi-move puzzles play through to completion.

Blindfold Mode - You ever plonk your Queen right into the crosshairs of your opponent's Knight? Of course you have. That's because you failed to maintain a mental model of the board state in your working memory. Blindfold mode addresses this. Start with a small number of pieces - configurable at game start - and gradually work your way up.

Vision Training - It's just naming letters and numbers, how hard can it be? Thirty seconds on the clock. A square lights up, name it fast. Your final score is correct over attempted. Believe it or not, this is a critical step in achieving whole-board awareness. Optional increased difficulty tiers.

Daily Puzzle

Every day, a new puzzle. Same for everyone. Solve it. Compare times. Brag or suffer in silence.

Access it with daily from the main terminal.

Getting Started

chess           Open the mode selection menu
chess -p        Jump straight to puzzles
chess -pb       Blindfold puzzles
chess -v        Vision trainer
chess -1        Play the AI

Puzzle Filters

Dial in exactly what you want to practice:

chess -p --elo 800           Easy puzzles
chess -p --elo 1500-2000     Intermediate range
chess -p --pieces 6          Endgames (few pieces)
chess -p --pieces 20-32      Middlegame chaos
chess -pb --elo 1200         Blindfold at 1200 level

Combine freely. If filters are too restrictive and nothing matches, widen them or try again - puzzle batches vary.

Vision Trainer Modes

Basic mode (30 seconds, no flags) is ranked on leaderboards. Everything else is practice.

chess -v                     Basic - identify squares
chess -v --flip              Board flips randomly
chess -v --moves             Mixed piece move questions
chess -v --time 60           Longer rounds
chess -v --flip --moves      Challenge mode

Volume Tracking

Volume is the product of puzzle difficulty and board complexity. Particularly useful for tracking bindfold progression. Try to reach 1 million. Must be signed in to track progress.

Volume = puzzle_rating * pieces_on_board / 100

Check your stats with stats puzzles.

See Also

  • man chess - Full command reference
  • daily - Today's puzzle
  • stats puzzles - Your training history
  • leaderboard chess - Vision trainer rankings