← All projects

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

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

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 05

    Discoverable, not memorized

    Three layers of help: a quick reference, a searchable list of every tool, and interactive cheatsheets for each custom command.