Lumon is an interactive terminal experience that simulates the macrodata refinement process shown in the TV series "Severance."
This TUI application is built using the Bubble Tea framework and related libraries from Charm.
- On the Web: terminaltrove.com/lumon/
- Over SSH:
ssh lumon.terminaltrove.com - On your machine: Download
lumonfor your platform from releases, then run./lumon
You can download the latest binary from GitHub releases for your platform here.
brew install terminaltrove/tap/lumoneget terminaltrove/lumongo install github.com/terminaltrove/lumon/cmd/lumon@latestRequirements: Go 1.26.11 or later
git clone https://github.com/terminaltrove/lumon.git
cd lumon
go build -o lumon ./cmd/lumon
# or: ./scripts/build.sh for every target, into dist/, with checksums- Find the corrupt clusters in the grid and refine them into five bins
- A fisheye lens that grows the digits under your cursor and pushes the grid apart
- Clusters that swell, redden and eventually detonate if you leave them
- Up to four refiners on a file, on the public server or on your own network
- Computer refiners for company, nine colour themes, and mouse support
- Type
KIERfor a nice treat ;)
![]() Scary numbers growing under the cursor |
![]() The Lumon logo at startup |
![]() Choosing a file |
![]() Refined numbers flying into bin 01 |
![]() Three refiners on one file |
![]() The file in 3D |
![]() Standings |
![]() Controls |
![]() Credits |
Four of the nine themes, on the same board:
![]() lumon |
![]() phosphor |
![]() amber |
![]() trove |
↑↓←→orhjkl- Move the cursorf- Take the cluster under the cursor1-5- Choose a binenterorspace- Refine the cluster under the cursor?- Every controlq- Back out, or quit
The full list is in docs/controls.md.
Ghostty, WezTerm, iTerm2 or kitty are recommended. See more at docs/terminals.md.
- Computer refiners and the full feature list
- Playing with others over the LAN
- Agent Plugins: Agent plugins for Claude Code, Pi and OpenCode.
make help # every task
make test # the suite, under the race detector
make check # fmt, vet and testFor inline plugin development (Bun 1.3.14 or later):
bun install --frozen-lockfile --ignore-scripts
bun run check:plugins
bun run test:pluginsThe integration tests build this checkout's native game and exercise embedded rendering, input, resizing, activation defaults and cleanup.
MIT, in LICENSE. Third-party licences are in licenses/.
This project is not affiliated with, endorsed by, or connected to Apple TV+, "Severance," or Lumon Industries (which is fictional).
- Inspired by the TV show "Severance" on Apple TV+
- Built with Bubble Tea and Lip Gloss from our friends at Charm
- The physics is ported from inertia by Kairav Mittal
- To you for checking out and trying lumon!



















