/sudoku-cli

Terminal Sudoku - TUI

Primary LanguageGo

Sudoku CLI

A terminal-based Sudoku game built with Go and Bubble Tea.

Sudoku CLI Screenshot

Features

  • Interactive menu system
  • Terminal-based UI using Bubble Tea
  • Keyboard navigation (arrow keys or vim-style h/j/k/l)
  • Horizontal layout with number options panel showing remaining valid positions
  • Real-time highlighting of matching numbers across board and options panel

Controls

  • Arrow Keys or h/j/k/l: Navigate the sudoku grid
  • 1-9: Enter a number in the current cell
  • Delete/Backspace/0/x: Clear the current cell
  • n: Start a new game
  • d: Switch difficulty
  • ?: Toggle help
  • q or Ctrl+C: Quit application

Installation

Option 1: One-Line Install Script (Recommended)

No Go installation required! Run this command to automatically detect your system and install the appropriate binary:

curl -fsSL https://raw.githubusercontent.com/jensderond/sudoku-cli/master/install.sh | bash

Option 2: Manual Download

Download the appropriate binary for your system from the releases page:

Linux (64-bit)

wget https://github.com/jensderond/sudoku-cli/releases/latest/download/sudoku-linux-amd64.tar.gz
tar -xzf sudoku-linux-amd64.tar.gz
sudo mv sudoku /usr/local/bin/sudoku

Linux (ARM64)

wget https://github.com/jensderond/sudoku-cli/releases/latest/download/sudoku-linux-arm64.tar.gz
tar -xzf sudoku-linux-arm64.tar.gz
sudo mv sudoku /usr/local/bin/sudoku

macOS (Intel)

wget https://github.com/jensderond/sudoku-cli/releases/latest/download/sudoku-macos-amd64.tar.gz
tar -xzf sudoku-macos-amd64.tar.gz
sudo mv sudoku /usr/local/bin/sudoku

macOS (Apple Silicon)

wget https://github.com/jensderond/sudoku-cli/releases/latest/download/sudoku-macos-arm64.tar.gz
tar -xzf sudoku-macos-arm64.tar.gz
sudo mv sudoku /usr/local/bin/sudoku

Option 3: Install with Go (for developers)

To install directly from GitHub:

go install github.com/jensderond/sudoku-cli/cmd/sudoku@latest

Or install a specific version:

go install github.com/jensderond/sudoku-cli/cmd/sudoku@1.0.0

Option 4: Build from Source

git clone https://github.com/jensderond/sudoku-cli.git
cd sudoku-cli
go build -o sudoku ./cmd/sudoku

Development

To run the application in development mode:

go run ./cmd/sudoku

To build and install locally:

go build -o sudoku ./cmd/sudoku
mkdir -p ~/bin
cp sudoku ~/bin/sudoku

Then run the executable:

~/bin/sudoku

Dependencies

Project Status

This is a Sudoku CLI application. The current implementation provides:

  • Basic menu structure
  • Keyboard navigation
  • Interactive selection system
  • Different difficulty levels

Future enhancements could include:

  • Game statistics
  • Save/load functionality