residual

a minimal, portable linux os designed to boot from usb on any x86_64 machine,
leave no trace on the host, and persist its own state quietly across sessions.

it is not a distribution. it is not a desktop environment.
it is a designated environment that follows you.

---

built on alpine linux (lts kernel). amber terminal. keyboard-driven.
suckless tools, a c compiler, and go. nothing else you didn't ask for.

persistence is optional. if none is configured, residual boots read-only
and tells you so. run `residual setup` to configure it.

---

docs/design.md       full design document
docs/persistence.md  persistence architecture
docs/cli-reference.md  residual tool reference
docs/aesthetic.md    color scheme and ui philosophy