Case study — Infrastructure
SuperShell
One command turns a fresh Arch/CachyOS or Windows 11 machine into the same terminal environment. A separate updater keeps every machine in sync without ever touching system state.
- Role
- Author
- Stack
- Fish · PowerShell 7 · Bash · fzf · Starship
- Platforms
- Arch / CachyOS · Windows 11
- Source
- GitHub ↗
The problem
Same muscle memory, any machine
The goal is the same terminal on every machine, Linux or Windows, without rebuilding it by hand after each fresh install. SuperShell treats the environment as a versioned artifact: install once per machine, update everywhere, and every machine can report exactly which version it's running.
What's in the box
Classic tools, modern replacements
- lseza
- catbat
- findfd
- grepripgrep
- cdzoxide
- dudust
- psprocs
- topbtop
- sedsd
- curlxh
- digdoggo
- rmtrash-cli
fzf ties them together: fuzzy-search code and open it at the matching line, jump into a running container, follow its logs, switch branches sorted by latest commit, or pick a commit to fix up.
Key decisions
Why it works this way
-
01
Install and update are different jobs
The installer changes the system: packages, default shell, group membership, services. The updater only deploys config. It never upgrades packages, changes the shell or touches services, so it's safe to run on any machine at any time. When the configs expect a tool that isn't installed, it names it and leaves installing to the installer.
-
02
Every machine knows its version
Each update stamps the version, commit, branch and timestamp onto the machine, so "what is this box running?" has a one-line answer. Releases are versioned automatically from conventional commits.
-
03
One interface, two platforms
A fish config on Linux and a PowerShell 7 profile on Windows expose the same aliases, functions and shortcuts, built from the same tools through pacman and the AUR on one side and winget and scoop on the other.
-
04
Safe to try, quiet to repeat
Both scripts take a dry-run flag that shows what would change. Repeat runs back a config up only when its contents actually differ, so they don't litter the disk with backup files.
-
05
Discoverable, not memorized
Three layers of help: a quick reference, a searchable list of every tool, and interactive cheatsheets for each custom command.