dotfiles

Personal shell configuration for macOS and Ubuntu/Debian.

Quick start

git clone <repo-url> ~/.dotfiles
cd ~/.dotfiles

# Preview what will happen
DRY_RUN=true ./install.sh

# Run for real
./install.sh

The install script detects your OS, installs packages, and symlinks config files into place. Existing files are backed up to ~/.dotfiles-backup-<timestamp>/ before overwriting.

What's included

Shell (bash + zsh)

File	Purpose
.bash_profile	Bash init: loads dotfiles, sets up brew/pyenv/go/cargo/fzf
.zshrc	Zsh init: mirrors .bash_profile with zsh-native options
.zprofile	Zsh login shell: brew, PATH, cargo env
.exports	Environment variables (editor, history, locale)
.aliases	Shortcuts, eza/bat/fd wrappers, k8s/cloud/git aliases
.functions	Utilities: calc, targz, json, gwt (git worktree), etc

.exports, .aliases, and .functions are shared between bash and zsh.

Tools

Config	Tool
.vimrc	Vim (lean, 6 plugins via vim-plug for quick edits)
nvim/	Neovim (lazy.nvim, treesitter, telescope, Claude AI autocomplete via minuet-ai)
starship.toml	Starship prompt (dark teal theme with powerline + nerd font icons)
starship-simple.toml	Minimal single-line starship prompt
ghostty.config	Ghostty terminal
hammerspoon.lua	Hammerspoon window management (macOS)
RectangleConfig.json	Rectangle window snapping (macOS)
karabiner.json	Karabiner-Elements key remapping (macOS)

Packages installed

Both platforms: ripgrep, bat, fd, jq, yq, shellcheck, btop, kubectl, tmux, zoxide, starship, neovim

macOS (brew): eza, sk (skim), jqp, jnv, git-delta, kubectx, pnpm, uv, neovim, difftastic, lazygit, lazydocker, dust, xh, hammerspoon, rectangle, google-cloud-sdk

Ubuntu: Packages not in apt are installed via curl installers (starship, zoxide, kubectl, lazygit, lazydocker, pnpm, uv) or cargo (skim, eza, jnv, difftastic, dust, xh).

Starship theme

The installer prompts for a theme choice (or set STARSHIP_THEME=simple to skip the prompt):

• default -- powerline segments with git metrics, k8s context, language versions, battery
• simple -- minimal single-line prompt

Switching to zsh

To try zsh, run chsh -s /bin/zsh and open a new terminal. The zsh config sources the same .exports, .aliases, and .functions files as bash.

Requirements

• Bash 4+ or Zsh 5+
• A Nerd Font for starship icons (the powerline theme uses nerd font symbols)
• macOS: Xcode Command Line Tools (xcode-select --install)
• Ubuntu: curl, git, sudo