~/.dotfiles · wiki

My macOS dev setup

The tools I use every day, where their configs live, and every key I set. Pick a tool to see its keys. The key tables are generated from the real configs, so they match what is installed.

All keys by layer →

Tools

Pick a tool above to see what it does and all its keys.

How the layers fit

AeroSpacewindows, workspaces
Ghosttyterminal window
tmuxpanes, sessions
Neovimediting
zshcommands

Shows what AeroSpace is doing.

Opens as a tmux popup.

Makes tmux windows for worktrees.

A key goes to the outermost layer first. AeroSpace takes Alt keys, Ghostty takes Cmd keys, tmux takes anything after its prefix, and the rest reaches Neovim or zsh.

Start here

git clone https://github.com/sefatanam/dotfiles ~/.dotfiles && cd ~/.dotfiles && ./setup.sh
Set up a new Mac. Add --dry-run to only preview.
./setup-validate.sh
Check that links, configs and these pages are all correct.
./update-keybindings.sh
Run after changing a key. Rebuilds the key tables on this page.
transparency toggle
Turn transparent mode on or off for Ghostty, tmux and Neovim together. Restart Ghostty after.

Gotchas

Cmd+B zoom relies on a tmux default

It sends prefix + z. My config never sets z, so if tmux changes its defaults, the key stops working without any error.

Cmd+S splits, it does not save

It sends prefix + s, which splits the pane into a top and bottom half.

tmux split names look backwards

split-window -h puts panes side by side. -v stacks them.

Space does nothing alone in Neovim

It is the leader key. A bare Space waits for the next key.

prefix + Ctrl+r restores a session

The config also binds it to the yazi file manager, but tmux-resurrect loads later and takes the key, so yazi cannot be opened from any key.

Transparent mode is one switch

Never turn it on in just one tool. Use transparency so Ghostty, tmux and Neovim stay in sync.

Full explanations →