Hams 🐹

Declarative workstation setup that actually feels normal to use

A hamster stuffs its cheek pouches with food to save for later. hams does the same for your packages, system tweaks, dotfiles, and git repos — all tucked into YAML so a fresh machine is one command away from feeling like home.

Get Started →

GitHub

Install and record, same step

Type hams brew install git. It installs and writes the Hamsfile entry. No editing YAML first.

One command on a new machine

hams apply —bootstrap —from-repo=user/store and walk away. Come back to a ready workstation.

14 providers ready out of the box

Homebrew, apt, pnpm, npm, cargo, go, VS Code, git, macOS defaults — the usual suspects.

Edit the YAML, hams does the math

Change a Hamsfile, run hams apply. It figures out the diff and only touches what’s different.

What it looks like day-to-day


# Install something, hams quietly writes it down
hams brew install htop
 
# Three months later, brand-new laptop
hams apply --bootstrap --from-repo=zthxxx/hams-store --tag=macOS
 
# Curious what's managed?
hams list