gentoo-state is a transparent, human-readable backup tool for Gentoo Linux.
It captures the actual state of a system —
not as an image, not as a snapshot, but as structured data you can understand and version.
No magic.
No restore surprises.
No black boxes.
- boring is good
- X11 focused
- reproducible > automatic
- readable > compressed
- explicit > clever
This tool exists because disk images and snapshots do not explain systems.
- Portage configuration (
/etc/portage) - Selected system metadata
- User configuration (
~/.config,.xmonad, shell configs) - Installed package state
- Gentoo profile & USE flags
📄 Full list: see MANIFEST.md
- Browser profiles & history
- Cache directories
- Temporary files
- Steam libraries & game drives
- Secrets (unless explicitly enabled)
🎯 Target audience Gentoo users
XMonad / minimal WM users
People who reinstall systems intentionally
Anyone who wants control, not automation
🛡 License MIT – do whatever you want, but know what you’re doing 😉