Skip to content

Oh My Mac

Oh My Mac turns a fresh Mac into a terminal-first dev environment: Ghostty + Oh My Zsh + Starship + tmux + Neovim (LazyVim) + AeroSpace tiling, with Catppuccin Mocha everywhere and JetBrainsMono Nerd Font.

Source

On a fresh Mac:

Terminal window
git clone https://github.com/zerovoid99/ohmymac.git ~/Code/ohmymac
~/Code/ohmymac/install.sh

The script installs Homebrew, every package in the Brewfile, and Oh My Zsh, then symlinks the configs into $HOME. Existing files are backed up to ~/.dotfiles-backup/<timestamp>/. It’s safe to re-run.

Everything is symlinked, so editing a file in the repo takes effect immediately.

Folder Linked to
zsh/ ~/.zshrc
starship/ ~/.config/starship.toml
fastfetch/ ~/.config/fastfetch/config.jsonc
ghostty/ ~/Library/Application Support/com.mitchellh.ghostty/config.ghostty
git/ ~/.gitconfig (your identity lives in ~/.gitconfig.local, not committed)
bat/ ~/.config/bat/
nvim/ ~/.config/nvim (LazyVim + Catppuccin)
tmux/ ~/.config/tmux/tmux.conf (TPM + Catppuccin)
lazygit/ ~/Library/Application Support/lazygit/config.yml
ssh/ ~/.ssh/config (keys are never in the repo)
aerospace/ ~/.config/aerospace/aerospace.toml (tiling window manager)
borders/ ~/.config/borders/bordersrc (focused-window border)

macos/ holds defaults.sh and wallpaper.sh, which the installer runs instead of linking.

Navigation: cd proj (zoxide, partial names work) · fcd pick a folder · fe pick and open a file

fzf: Ctrl+T find a file · Ctrl+R search history · Alt+C jump to a folder

Git: gs status · gl log graph · gd diff · gfb pick a branch · lg lazygit

Ghostty: Cmd+D split right · Cmd+Shift+D split down · Cmd+Shift+Enter zoom · Cmd+Shift+R reload config

Neovim: Space leader · Space e file tree · Space f f find file · Space s g grep · Space g g lazygit

tmux: prefix is Ctrl+Space · tm attach or create a session for this folder · prefix | / prefix - split · Ctrl+hjkl move between panes, also inside Neovim

AeroSpace (Alt = Option): Alt+hjkl focus · Alt+Shift+hjkl move window · Alt+1..9 workspace · Alt+f fullscreen · Alt+Enter new Ghostty

See the full cheat sheet in the repo.