260fa9469a
Cleaned up for new machine portability: removed hardcoded paths, EOL packages, and redundant version managers. Consolidated NVM loading, added work git identity support via includeIf. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
154 lines
4.1 KiB
Markdown
154 lines
4.1 KiB
Markdown
# New Mac Setup
|
|
|
|
Step-by-step guide to reproduce the terminal environment on a fresh macOS machine.
|
|
|
|
## 1. Install Homebrew
|
|
|
|
```bash
|
|
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
|
|
```
|
|
|
|
Follow the post-install instructions to add Homebrew to your PATH (it will tell you to run two commands involving `/opt/homebrew`).
|
|
|
|
## 2. Clone this repo
|
|
|
|
```bash
|
|
git clone https://git.kestrelsnest.social/eric/dotfiles.git ~/dotfiles
|
|
```
|
|
|
|
## 3. Install Homebrew packages
|
|
|
|
```bash
|
|
cd ~/dotfiles
|
|
brew bundle
|
|
```
|
|
|
|
This installs all CLI tools, language version managers, databases, fonts, and casks.
|
|
|
|
If any formulae fail, you can skip them — they may not be needed on the new machine.
|
|
|
|
## 4. Install Oh My Zsh
|
|
|
|
```bash
|
|
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
|
|
```
|
|
|
|
**Important:** When the installer asks to set zsh as your default shell, say yes. It will also create a default `.zshrc` — that's fine, the install script in step 6 will replace it.
|
|
|
|
## 5. Install Oh My Zsh custom plugins and theme
|
|
|
|
```bash
|
|
# Powerlevel10k theme
|
|
git clone https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k
|
|
|
|
# zsh-autosuggestions
|
|
git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
|
|
|
|
# zsh-syntax-highlighting
|
|
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting
|
|
```
|
|
|
|
## 6. Install NVM
|
|
|
|
```bash
|
|
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
|
|
```
|
|
|
|
After install, open a new terminal or `source ~/.zshenv`, then:
|
|
|
|
```bash
|
|
nvm install --lts
|
|
nvm alias default node
|
|
```
|
|
|
|
## 7. Symlink dotfiles
|
|
|
|
```bash
|
|
cd ~/dotfiles
|
|
./install.sh
|
|
```
|
|
|
|
This creates symlinks from `~/.zshrc`, `~/.gitconfig`, etc. into this repo. Existing files are backed up with a `.backup.*` suffix.
|
|
|
|
## 8. Set up fzf key bindings
|
|
|
|
```bash
|
|
$(brew --prefix)/opt/fzf/install
|
|
```
|
|
|
|
Say yes to key bindings and completion, no to updating shell config files (the dotfiles already handle that).
|
|
|
|
## 9. Reload your shell
|
|
|
|
```bash
|
|
source ~/.zshrc
|
|
```
|
|
|
|
Or just open a new terminal window.
|
|
|
|
## 10. Optional: Reconfigure Powerlevel10k
|
|
|
|
The existing `.p10k.zsh` config is included, but if you want to run the wizard fresh:
|
|
|
|
```bash
|
|
p10k configure
|
|
```
|
|
|
|
Current config: classic powerline, unicode, light, 12h time, angled separators, sharp heads, flat tails, 1 line, sparse, fluent, transient prompt.
|
|
|
|
## 11. Install iTerm2 shell integration (if using iTerm2)
|
|
|
|
```bash
|
|
curl -L https://iterm2.com/shell_integration/zsh -o ~/.iterm2_shell_integration.zsh
|
|
```
|
|
|
|
## 12. Set your terminal font
|
|
|
|
The Brewfile installs **MesloLGS NF** (Nerd Font). Set this as your terminal font:
|
|
|
|
- **iTerm2**: Preferences > Profiles > Text > Font > MesloLGS NF
|
|
- **Terminal.app**: Preferences > Profiles > Font > Change > MesloLGS NF
|
|
|
|
## 13. Set up work git identity
|
|
|
|
The `.gitconfig` uses your personal email by default. For work repos, create `~/.gitconfig-work`:
|
|
|
|
```bash
|
|
cat > ~/.gitconfig-work << 'EOF'
|
|
[user]
|
|
email = your-work-email@company.com
|
|
EOF
|
|
```
|
|
|
|
Any repos cloned under `~/work/` will automatically use your work email. Clone personal projects elsewhere.
|
|
|
|
## 14. Language version managers
|
|
|
|
The dotfiles configure these version managers — install runtimes as needed:
|
|
|
|
```bash
|
|
# Python (via pyenv)
|
|
pyenv install 3.13.3
|
|
pyenv global 3.13.3
|
|
|
|
# Node (via nvm, done in step 6)
|
|
# Terraform (via tfenv)
|
|
tfenv install latest
|
|
```
|
|
|
|
## What's included
|
|
|
|
| File | Purpose |
|
|
|------|---------|
|
|
| `zshrc` | Main zsh config: plugins, aliases, key bindings, functions |
|
|
| `zshenv` | PATH and version manager init (runs for all shell types) |
|
|
| `p10k.zsh` | Powerlevel10k prompt theme config |
|
|
| `bashrc` | Bash config (NVM, Docker, fzf) |
|
|
| `bash_profile` | Bash login shell (rbenv, Docker) |
|
|
| `profile` | Generic shell profile |
|
|
| `gitconfig` | Git aliases, colors, push config |
|
|
| `gitignore_global` | Global gitignore (.DS_Store, *~) |
|
|
| `fzf.zsh` | fzf PATH and shell integration |
|
|
| `Brewfile` | All Homebrew packages and casks |
|
|
| `install.sh` | Symlink installer script |
|