My application settings in sync (macOS, plus Windows via WSL2 — see Windows) by Mackup
⚠️ This repo is public. Never commit credentials — shell and git config are synced out of~, so an exported token would be published. See Security.
Mackup uses copy mode (not symlinks). macOS Sonoma 14+ no longer supports symlinked preferences.
mackup backupcopies files into this repo;mackup restorecopies them back to~.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"Apple Silicon uses
/opt/homebrew, Intel uses/usr/local. The$BREW_HOMEvariable in.zshenvhandles this — update it if needed.
CLI tools are managed by mise, installed with its own script (not brew — on Intel, brew would compile it from source):
curl https://mise.run | sh
~/.local/bin/mise use -g uv pipx:mackup
brew install git-cryptMackup now works in copy mode, so this repo does not need to live at ~/dotfiles.
git clone git@github.com:zo-ly/dotfiles.git
cd dotfilesUnlock encrypted files (key stored in OneDrive):
git-crypt unlock ~/OneDrive/dotfile.keycp ./Mackup/.mackup.cfg ~/
cp -r ./Mackup/.mackup ~/
~/.local/bin/mise exec -- mackup restoreOn an Intel Mac, also pin the tools whose upstream no longer ships x86_64 macOS binaries
(see Mackup/.config/mise/config.intel.toml):
echo 'export MISE_ENV=intel' >> ~/.zshenv.localRequired before setting up the shell prompt and terminal:
- Fira Code Nerd Font — for Starship prompt and kitty (kitty uses the
Monofamily) - NerdFontsSymbolsOnly — for kitty
Open a new terminal first, then:
mise install # everything in ~/.config/mise/config.toml, as prebuilt binaries
brew install git # not in mise's registry; builds from source on Intelkitty, as a brew cask (a prebuilt app, so it is fast on Intel too):
brew install --cask kitty
kitten themes # creates ~/.config/kitty/current-theme.conf, which kitty.conf includessh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
git clone https://github.com/zsh-users/zsh-syntax-highlighting ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlightingLazyVim manages plugins automatically. On first launch just open Neovim and wait for the installation to complete:
nvimMackup restores the ccstatusline widget config (~/.config/ccstatusline/settings.json), but not the statusLine entry in ~/.claude/settings.json. Run the TUI once and choose Install to Claude Code:
npx -y ccstatusline@latest- Raycast — import extensions from the
raycast/folder - Bob — translation/OCR app (paid build); import
Bob/config.bobconfigfrom inside the app
The shell, Neovim and every mise tool run inside WSL2 (Ubuntu), so the same configs apply. The terminal is WezTerm, a native Windows app that opens straight into WSL. No brew here: apt for the few system packages, mise for the rest.
wsl --install # WSL2 + Ubuntu; reboot, then create the Linux user when prompted
wsl -l -v # the distro name; wezterm.lua assumes "Ubuntu"Install the nightly build: WezTerm-nightly-setup.exe from the
nightly release (the last stable release is from 2024).
Until step 4 it opens PowerShell — run wsl there, or use the Ubuntu app.
oh-my-zsh must go in before mackup restore, or its installer overwrites .zshrc:
sudo apt update && sudo apt install -y zsh git curl build-essential unzip
chsh -s "$(which zsh)"
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" "" --unattended
git clone https://github.com/zsh-users/zsh-autosuggestions ~/.oh-my-zsh/custom/plugins/zsh-autosuggestions
git clone https://github.com/zsh-users/zsh-syntax-highlighting ~/.oh-my-zsh/custom/plugins/zsh-syntax-highlighting
curl https://mise.run | sh
~/.local/bin/mise use -g uv pipx:mackup
git clone https://github.com/zo-ly/dotfiles.git ~/dotfiles # https: no ssh key yet
cp ~/dotfiles/Mackup/.mackup.cfg ~/
cp -r ~/dotfiles/Mackup/.mackup ~/
~/.local/bin/mise exec -- mackup restore
~/.local/bin/mise install
exec zsh- Do not set
MISE_ENV=intelhere — those pins are for the Intel Mac only. - If
mise installstarts compiling Ruby, add its build deps and rerun:sudo apt install -y libssl-dev libyaml-dev zlib1g-dev libffi-dev libreadline-dev Bob/config.bobconfigstays encrypted; nothing on Windows needs it, so nogit-crypt unlock.
The config lives in WSL (~/.config/wezterm/wezterm.lua, restored by Mackup). Tell Windows-side WezTerm where it is,
replacing <user> with the Linux user name:
setx WEZTERM_CONFIG_FILE "\\wsl.localhost\Ubuntu\home\<user>\.config\wezterm\wezterm.lua"Restart WezTerm: it should open in zsh with the starship prompt. Edits over this path may not reload
automatically — press Ctrl+Shift+R.
Anything with Ctrl+Shift belongs to the terminal; plain Ctrl+letter / Alt+letter go to zsh and Neovim
(Ctrl+A/E/U/W/R/K/L, Alt+F/B/. all work). ★ = added in wezterm.lua, the rest are WezTerm defaults.
| Action | Keys |
|---|---|
| New tab / close tab | Ctrl+Shift+T / Ctrl+Shift+W |
| Next / previous tab | Ctrl+Tab / Ctrl+Shift+Tab |
| Go to tab N | Ctrl+Shift+1..9 |
| ★ Split right / down (same directory) | Ctrl+Shift+Enter / Ctrl+Shift+- |
| ★ Move to pane left/down/up/right | Ctrl+Shift+H/J/K/L |
| ★ Swap pane with a picked one | Ctrl+Shift+S |
| Zoom pane | Ctrl+Shift+Z |
| ★ Close pane | Ctrl+Shift+D |
| Copy / paste | Ctrl+Shift+C / Ctrl+Shift+V |
| Search scrollback / copy mode | Ctrl+Shift+F / Ctrl+Shift+X |
| ★ Open link | Ctrl+click (a plain click only selects) |
| Reload config | Ctrl+Shift+R |
Edit ~/.config/wezterm/wezterm.lua in WSL, then mackup backup and commit from ~/dotfiles
(pushing needs an ssh key or gh auth login in WSL).
mackup backupThen commit and push the changes in this repo.
mise use -g <tool> # CLI tool with a macOS release binary; else brew install <tool>
brew install --cask <app>
mise upgrade # upgrades and removes the replaced versions
brew upgrade # on Intel, check `brew upgrade -n` first: anything without a bottle builds from source
mise self-update
mise prune -y # occasionally: versions no config references any moreAfter mise use -g, run mackup backup and commit; on the other machine git pull && mackup restore && mise install.
cd ~/dotfiles && git pull
curl https://mise.run | sh
mackup restore # still the brew one at this point
echo 'export MISE_ENV=intel' >> ~/.zshenv.local # Intel onlyCheck ~/.config/mise/config.toml for a token or machine-only tools before mackup restore —
it is overwritten. Then, in a new terminal:
mise install
for f in starship neovim zoxide fzf ripgrep fd git-delta gh glab lazygit lazydocker onefetch mackup mise eza tailspin; do
brew list "$f" &>/dev/null && brew uninstall "$f"
done
brew autoremove && brew cleanup -s