Terminal-based cellular automata playground
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
- Includes Eight classic cellular automata
- Beautiful TUI navigation menu
- Real-time speed control with up/down arrow keys
- Focus mode for distraction-free fullscreen viewing
- Monochrome toggle for terminal theme compatibility
- Generation-based coloring creating trippy wave effects
| Automaton | Description | Alias |
|---|---|---|
| Conway's Game of Life | The classic cellular automaton with simple rules creating complex patterns | life |
| Brian's Brain | 3-state automaton with beautiful trailing patterns | brain |
| Langton's Ant | Simple ant following two rules creating emergent complexity | ant |
| Larger than Life | Generalized Game of Life with extended neighborhoods | ltl |
| Belousov-Zhabotinsky | Chemical reaction simulation with spiral waves | belousov |
| Faders | Multi-state cells that fade through colors before dying | faders |
| Forest Fire | Trees grow, catch fire, and burn in natural cycles | forest |
| Wildfire | Stochastic fire spread through vegetation | wildfire |
go install github.com/ashish0kumar/cellscape@latestgit clone https://github.com/ashish0kumar/cellscape.git
cd cellscape
go mod tidy
go build
sudo mv cellscape /usr/local/bin/
cellscape --helpcellscapecellscape run life
cellscape run brain -m -f
cellscape run belousov --focus --monochromeAvailable keywords: life, brain, ant, ltl, belousov, faders, forest, wildfire
| Key | Action |
|---|---|
Space |
Pause / resume simulation |
↑ / k |
Increase speed (max 10) |
↓ / j |
Decrease speed (min 1) |
s |
Single-step while paused |
f |
Toggle focus mode |
c |
Toggle monochrome / color |
r |
Reset current automaton |
q / Esc |
Return to menu (or exit) |
--monochrome,-m- Start in monochrome mode--focus,-f- Start in focus mode (fullscreen, no UI)
- Colorful Mode: Generation-based rainbow coloring with wave effects
- Monochrome Mode: Clean grayscale using ANSI terminal colors
- Focus Mode: Fullscreen grid with no status bars or help text
- Bubble Tea - TUI framework
- Lipgloss - Styling and layout
- Cobra - CLI framework
Contributions are welcome! Please feel free to open an issue or submit a pull request.
© 2025-present Ashish Kumar







