{"id":14530709,"url":"https://github.com/fedeztk/sku","last_synced_at":"2025-10-08T21:42:47.635Z","repository":{"id":57705561,"uuid":"500503526","full_name":"fedeztk/sku","owner":"fedeztk","description":"Simple TUI written in go to play sudoku in the terminal","archived":false,"fork":false,"pushed_at":"2022-11-10T16:36:23.000Z","size":27,"stargazers_count":73,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-27T06:35:12.609Z","etag":null,"topics":["cli","command-line","go","sudoku","tui"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fedeztk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"license","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-06-06T16:10:10.000Z","updated_at":"2025-04-20T07:19:17.000Z","dependencies_parsed_at":"2022-08-26T12:33:12.748Z","dependency_job_id":null,"html_url":"https://github.com/fedeztk/sku","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fedeztk/sku","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fedeztk%2Fsku","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fedeztk%2Fsku/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fedeztk%2Fsku/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fedeztk%2Fsku/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fedeztk","download_url":"https://codeload.github.com/fedeztk/sku/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fedeztk%2Fsku/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279000704,"owners_count":26082837,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","command-line","go","sudoku","tui"],"created_at":"2024-09-05T00:01:09.306Z","updated_at":"2025-10-08T21:42:47.606Z","avatar_url":"https://github.com/fedeztk.png","language":"Go","funding_links":[],"categories":["\u003ca name=\"games\"\u003e\u003c/a\u003eGames","Applications"],"sub_categories":["Games"],"readme":"# sku\nSimple TUI written in go to play sudoku in the terminal\n\n[![GO](https://github.com/fedeztk/sku/actions/workflows/go.yaml/badge.svg)](https://github.com/fedeztk/sku/tree/master/.github/workflows/go.yml) [![GHCR](https://github.com/fedeztk/sku/actions/workflows/deploy.yaml/badge.svg)](https://github.com/fedeztk/sku/tree/release/.github/workflows/deploy.yml) [![AUR](https://img.shields.io/aur/version/sku-git?logo=archlinux)](https://aur.archlinux.org/packages/sku-git) [![Go Report Card](https://goreportcard.com/badge/github.com/fedeztk/sku)](https://goreportcard.com/report/github.com/fedeztk/sku)\n\n## Table of Contents\n\n[Usage](#orgfa2aa9c) -\n[Features](#org26baa6c) -\n[Testing](#org2744438)\n\nsku is a simple TUI for playing sudoku inside the terminal. It uses the awesome [bubbletea](https://github.com/charmbracelet/bubbletea) TUI library for the UI.\n\nScreenshots [here](#org26baa6c)\n\n\u003e Disclaimer: there are probably many other sudoku TUIs around with all kind of features that sku does not have. PRs are welcomed but it is generally a better idea to just use those programs, since adding some features, like a pencil mode used to annotate the sudoku, would require too much effort.\n\n\n\u003ca id=\"orgab62fc1\"\u003e\u003c/a\u003e\n\n# Usage\n\n- Install `sku`: \n\nWith the `go` tool:\n```sh\ngo install github.com/fedeztk/sku/cmd/sku@latest\n```\n**Or** from source:\n```sh\n# clone the repo\ngit clone https://github.com/fedeztk/sku.git\n# install manually \nmake install\n```\nIn both cases make sure that you have the go `bin` directory in your path:\n```sh\nexport PATH=\"$HOME/go/bin:$PATH\"\n```\nIf you are an Arch user there is also an AUR package available:\n```sh\nparu -S sku-git\n```\n- Run it interactively:\n```sh\nsku            # use default mode (easy)\n```\nFor more information about version and modes check the help (`sku -h`)\n\u003ca id=\"org26baa6c\"\u003e\u003c/a\u003e\n\n# Features\n\n- Minimal/clean interface, only displays the board, the help and the game state (timer and remaining cells). Cursor position is marked with green. Greyed cells are unmodifiable (the base of the sudoku); when the cursor is under those cells it will darken\n![Screenshot from 2022-06-06 17-35-14](https://user-images.githubusercontent.com/58485208/172200830-677fb8f4-ea29-455c-989b-1c5ea774ae78.png)\n\n- Game check:\n\t- when the last cell is filled, `sku` will perform a check of the sudoku:\n\t\t- if it is correct, an animation will let you know that you won the game\n\t\t\n\t\thttps://user-images.githubusercontent.com/58485208/172200661-78ce055f-b5b9-44aa-bf4d-a27e9f8fce85.mp4\n\n\t\t- otherwise it will color with red the errors \n   ![Screenshot from 2022-06-06 17-36-56](https://user-images.githubusercontent.com/58485208/172201574-e1ebe9ec-fc44-4d6c-a80a-287c8433133d.png)\n\n\n- Simple keys to interact with the puzzle:\n\t- moving around: use the arrows or the vim motion keys, as preferred\n\t- setting a cell: just press the desired number\n\t- unsetting a cell: press spacebar or enter\n\t- toggle help: press the question mark\n\t- quit: you can quit anytime by pressing esc or q\n\t![Screenshot from 2022-06-06 17-36-19](https://user-images.githubusercontent.com/58485208/172201555-1dcc1851-6853-4760-ac7a-6d5285c2f0b6.png)\n\n\n- Check the version with `sku -v`\n- Get the help menu with `sku -h`\n- Set a sudoku mode with `sku MODE`. Valid MODEs are: easy, medium, hard and expert (also displayed with `-h` flag)\n\n\n\u003ca id=\"org2744438\"\u003e\u003c/a\u003e\n\n# Testing\n\nDevelopment is done through `docker`, build the container with:\n\n    make docker-build\n\nCheck that the build went fine:\n\n    docker images | grep sku\n\nTest it with:\n\n    make docker-run\n\nPre-built Docker image available [here](https://github.com/fedeztk/sku/pkgs/container/sku)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffedeztk%2Fsku","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffedeztk%2Fsku","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffedeztk%2Fsku/lists"}