dotfiles

Personal dotfiles for macOS — zsh, WezTerm, Starship, and more.

Structure

dotfiles/
├── AGENTS.md           # Shared Codex and Claude Code instructions
├── zshenv              # env vars (all zsh instances)
├── zprofile            # login shell (Homebrew)
├── zshrc               # interactive shell (plugins, tools)
├── zlogin
├── zsh/
│   ├── base.zsh        # key bindings, history, word style
│   ├── option.zsh      # shell options
│   ├── alias.zsh       # aliases, macOS settings
│   └── completions.zsh # completion, syntax highlighting
├── config/
│   ├── starship.toml   # Starship prompt config
│   └── wezterm/
│       └── wezterm.lua # WezTerm terminal config
├── claude/
│   ├── CLAUDE.md       # Symlink to ../AGENTS.md
│   └── statusline-command.sh
├── docker/
│   └── config.json     # Docker CLI config (Colima context)
└── Makefile

Setup

git clone <repo-url> ~/git/clonable-eden/dotfiles
cd ~/git/clonable-eden/dotfiles
make install   # create symlinks
make deps      # install Homebrew formulae and casks

Uninstall

make uninstall   # remove symlinks
make undeps      # uninstall Homebrew formulae and casks

Dependencies

Installed automatically via make deps:

Homebrew formulae:

• zsh — latest zsh
• zsh-autosuggestions — history-based inline suggestions
• zsh-completions — additional completions
• zsh-syntax-highlighting — syntax highlighting
• zoxide — smarter cd
• mise — runtime version manager
• starship — cross-shell prompt
• watch — periodic command execution (used by WezTerm git log pane)
• jq — JSON processor
• gh — GitHub CLI
• git — distributed version control
• sqlite — lightweight SQL database engine
• tmux — terminal multiplexer
• colima — container runtime on macOS
• docker — Docker CLI
• docker-buildx — Docker Buildx CLI plugin
• docker-compose — Docker Compose CLI plugin
• docker-credential-helper — Docker credential helper (osxkeychain)
• aws-vault — secure AWS credential storage
• awscli — AWS command line interface

Homebrew casks:

• WezTerm — terminal emulator
• Moralerspace HW — font

Manual install required:

• Homebrew — prerequisite