hey, dotfiles

My macOS setup. Fast, minimal, mine.

git clone https://github.com/gumadeiras/dotfiles.git ~/dotfiles
git clone <private-remote> ~/git/private
cd ~/dotfiles && sh install.sh

install.sh exits immediately if ~/git/private/dotfiles is missing. Override with PRIVATE_DOTFILES_DIR=/path/to/private/dotfiles sh install.sh if needed.

what's inside

component	what it does
zsh	shell config + aliases/functions
tmux	minimal persistent terminal bootstrap
config/	app configs (gh, ghostty, oh-my-posh, zed)
micromamba	python environments (conda-compatible)
Brewfile	homebrew packages
apps/	karabiner, raycast, iterm, sublime, zotero

quick links

• Aliases: ~/.zsh/alias.zsh
• Functions: ~/.zsh/functions.zsh
• Codex usage: ccusage daily|monthly|session
• tmux: ~/.tmux.conf
• Profile: ~/.zprofile
• Git: ~/.gitconfig
• GH CLI: ~/.config/gh/config.yml
• Ghostty: ~/.config/ghostty/config
• Oh My Posh: ~/.config/oh-my-posh/config.json
• Zed: ~/.config/zed/settings.json
• Sublime: ~/Library/Application Support/Sublime Text/Packages/User

notes

• Python via micromamba (run conda alias works)
• Sensitive local config lives in ~/git/private/dotfiles/
• install.sh will link private overlays when present:
• zsh/env.zsh -> ~/.config/secrets/env.zsh
• zsh/private.zsh -> ~/.config/secrets/private.zsh
• git/config.private -> ~/.config/git/config.private
• git/allowed_signers -> ~/.config/git/allowed_signers
• config/gh/hosts.yml -> ~/.config/gh/hosts.yml
• ssh/config -> ~/.ssh/config
• apps/sublime/User/MySFTP/servers/server.json -> ~/Library/Application Support/Sublime Text/Packages/User/MySFTP/servers/server.json
• agents/ -> ~/.agents
• agents/AGENTS.md -> ~/.codex/AGENTS.md
• agents/skills/ -> ~/.codex/skills
• agents/prompts/ -> ~/.codex/prompts
• Open Sublime once after setup, then run Package Control: Satisfy Dependencies if any packages are missing

tmux

• install.sh links .tmux.conf to ~/.tmux.conf
• tm attaches to or creates a tmux session for the current git root (or current directory outside git)
• Start simple:
  • tm
  • Ctrl-b d to detach
  • Ctrl-b | or Ctrl-b - to split in the current directory
  • Ctrl-b r to reload config
• Keep using Ghostty tabs for quick one-offs; use tmux for persistent shells, remote work, servers, logs, and long-running jobs