Getting started

Prerequisites

golings uses mise to pin the toolchain (Go 1.26) and the linter, so you don’t need Go installed globally.

brew install mise        # macOS; see mise docs for other platforms

Set up

git clone https://github.com/madhank93/golings
cd golings
mise install             # provisions Go 1.26, gopls, golangci-lint
mise run watch           # launches the interactive TUI

Use in GitHub Codespaces

Prefer a zero-setup cloud environment? Open the repo in a devcontainer (GitHub Codespaces, or VS Code’s Dev Containers extension). It installs mise and provisions the exact same pinned toolchain as local — Go 1.26, gopls, golangci-lint — then builds the binary. Once the container is ready, just run:

mise run watch

go, gopls, and golangci-lint are on your PATH in the integrated terminal, so editor completion and linting work too.

How it works

1. The TUI highlights the next unfinished exercise and shows its file path.
2. Open that file and make it compile / pass its tests.
3. Remove the // I AM NOT DONE marker when you think it’s done.
4. Save — golings re-runs the exercise. It only advances when the tests pass and golangci-lint is clean.

Keys

Key	Action
↑ / ↓ (or k / j)	move between exercises
⏎	run the selected exercise
e	open the exercise in $EDITOR (vi/vim/emacs/code…)
h	toggle the hint
r	reset the exercise to its original state
n	jump to the next unfinished exercise
q	quit

Streaks

Your streak is the number of consecutive days, ending on your most recent completion, on which you finished at least one exercise. It is never stored as a number — golings only records the timestamp of each first completion in .golings-state.json, and the streak is derived from those timestamps each time it’s shown. Reset an exercise (r) and its completion is dropped, so the streak adjusts automatically; miss a day and your next completion starts a fresh streak of 1.

Other commands

mise run list            # list every exercise + progress
./bin/golings hint <name>   # print a hint
./bin/golings reset <name>  # restore an exercise to its original state
mise run test            # test the tool itself (-race)
mise run lint            # lint the tool source

Next: browse the Curriculum to see the full track.