github.com/daypunk/punkdoku @v1.1.3

punkdoku

개요

punkdoku는 macOS, Linux에서 동일하게 동작하는 터미널 스도쿠 게임입니다. Go로 작성되었고 Bubble Tea와 Lipgloss로 보기 좋은 TUI를 제공합니다. 퍼즐은 난이도별로 생성되며, Daily 모드는 UTC 날짜 기반 시드를 사용해 모든 사용자가 동일한 퍼즐을 받습니다. 입력 애니메이션, Undo, Auto‑Check, 타이머 등을 지원합니다.

Overview

punkdoku is a cross‑platform terminal Sudoku for macOS and Linux. It's written in Go, built on Bubble Tea and Lipgloss for a clean, responsive TUI. Puzzles are generated per difficulty with a focus on uniqueness and reproducibility; Daily mode uses a UTC date‑based seed so everyone plays the same grid. The game ships with input flashes, undo/redo, auto‑check, and a compact timer.

Installation

Homebrew (Recommended)

brew install daypunk/tap/punkdoku

Direct Download

# macOS
curl -L https://github.com/daypunk/punkdoku/releases/latest/download/punkdoku-macos -o /usr/local/bin/punkdoku && chmod +x /usr/local/bin/punkdoku

# Linux
curl -L https://github.com/daypunk/punkdoku/releases/latest/download/punkdoku-linux -o /usr/local/bin/punkdoku && chmod +x /usr/local/bin/punkdoku

Run

punkdoku

How to Play

1. Launch: Run punkdoku in your terminal
2. Navigate: Use arrow keys to move around
3. Input: Press 1-9 to place numbers, 0 to clear
4. Settings: Press a for auto-check, t for timer

Difficulty Levels

• Easy: Perfect for beginners
• Normal: Balanced challenge
• Hard: Requires strategy
• Lunatic: Expert level
• Daily: Everyone gets the same puzzle based on the date

Controls

• Arrow keys: Navigate the grid
• 1-9: Place numbers
• 0/Space: Clear cell
• u: Undo last move
• a: Toggle auto-check (highlights mistakes)
• t: Toggle timer
• m: Return to main menu
• q: Quit

Features

• Clean interface: Minimalist design that stays out of your way
• Daily puzzles: Same puzzle for everyone, changes each day
• Smart generation: Every puzzle has exactly one solution
• Undo/Redo: Full move history
• Auto-check: Optional real-time error highlighting
• Timer: Track your solving speed

Technical Details

The game generates puzzles by starting with a complete solution and carefully removing numbers while ensuring uniqueness. Daily puzzles use the UTC date as a seed, so everyone worldwide gets the same puzzle.

• Generator uses backtracking with randomization
• Solver verifies puzzle uniqueness
• UI built with Bubble Tea and Lipgloss
• Single binary, no dependencies

Project Structure

cmd/
  punkdoku/
    main.go              # entrypoint
internal/
  config/               # YAML load/save under ~/.punkdoku
  game/                 # board state, moves, duplicates/conflicts
  generator/            # difficulty params, daily seeding, carving
  solver/               # backtracking solver + uniqueness counting
  theme/                # color palette (Punk theme)
  ui/                   # Bubble Tea app, model, view, styles, keymap

Development

# Run locally
go run ./cmd/punkdoku

# Build
go build -o punkdoku ./cmd/punkdoku

Built for modern terminals with Unicode support. Works best with monospace fonts and true color support.