bitty

module

v0.2.0 Latest Latest Go to latest Published: Sep 15, 2026 License: MIT

Details

Conway's Game of Life, packed two cells high in your terminal. Pause it, draw a pattern, step it carefully, or set the whole thing loose.

brew install --cask 0xbenc/tap/bitty
bitty

Key	Action
arrows or `hjkl`	move the editing cursor
`space` or `x`	toggle the selected cell
`p` or `enter`	pause/resume
`n`	advance one generation
`r`	regenerate from the configured density
`c`	clear and pause
`+` / `-`	change simulation speed
`w`	toggle edge wrapping
`Esc`, `Ctrl-C`, or `Ctrl-Q`	quit

The simulation starts immediately with a random field. Use --paused to begin in editing mode and --density 0 for an empty canvas.

bitty --density 0.25 --speed 12 --seed 42
bitty --paused --density 0 --width 120 --height 80
bitty --wrap=false

Run bitty --help for every option. NO_COLOR and BITTY_NO_COLOR disable color. BITTY_THEME_FILE selects a portable termsystem .theme file.

Bitty supports Linux and macOS and requires Go 1.26.5 or newer.

go build ./cmd/bitty
go test ./...

MIT

Path	Synopsis
cmd
bitty command
internal
app Package app owns bitty's interactive editor and simulation loop.	Package app owns bitty's interactive editor and simulation loop.
life Package life implements Conway's Game of Life independently of the terminal UI.	Package life implements Conway's Game of Life independently of the terminal UI.
state Package state stores bitty's small per-user runtime bookkeeping.	Package state stores bitty's small per-user runtime bookkeeping.
terminal
termstyle Package termstyle is bitty's small adapter around the shared theme engine.	Package termstyle is bitty's small adapter around the shared theme engine.