Personal Dotfiles

My development environment configuration for macOS.

Overview

This repository contains configuration files and scripts to set up a new MacBook for development.

Contents

File/Directory	Description
Brewfile	Homebrew packages and VS Code extensions
zsh/.zshrc	Zsh shell configuration with aliases
zsh/.zprofile	Zsh login shell configuration
git/.gitconfig	Git configuration with personal email
vscode/extensions.txt	List of VS Code extensions
ssh/config	SSH configuration template
ghostty/	Ghostty terminal configuration
opencode/	Opencode AI assistant configuration
install.sh	Automated setup script

Quick Start

1. Clone this repository

cd ~
git clone git@github.com:jbt95/dotfiles.git
cd dotfiles

2. Run the install script

./install.sh

3. Post-installation steps

1. Add SSH key to GitHub: The install script generated a new SSH key. Add it to GitHub:

   cat ~/.ssh/id_ed25519.pub

   Then visit: https://github.com/settings/keys

2. Install Node.js:

   nvm install node

3. (Optional) Generate GPG key for signed commits:

   gpg --full-generate-key
   git config --global commit.gpgsign true
   git config --global user.signingkey YOUR_KEY_ID

4. Configure Opencode:

   cp ~/dotfiles/opencode/opencode.json.template ~/.opencode/opencode.json
   # Edit the file and add your Fireworks AI API key

5. Restart your terminal or run:

   source ~/.zshrc

What's Installed

Homebrew Packages

• git - Version control
• gnupg - GPG for signing commits
• openssh - SSH client
• ripgrep - Fast search tool
• maven - Java build tool
• openjdk - Java SDK
• tfenv - Terraform version manager
• terraform - Infrastructure as Code

Zsh Configuration

• Oh My Zsh with robbyrussell theme
• Plugins: git, zsh-autosuggestions, zsh-syntax-highlighting
• Aliases for git, npm, docker, terraform, java, and more

Development Tools

• NVM - Node version manager
• pnpm - Fast package manager
• Bun - JavaScript runtime
• Docker - Containerization (install Docker Desktop separately)
• WebStorm - JetBrains IDE for JavaScript/TypeScript
• Opencode - AI coding assistant (Fireworks AI powered)

Productivity Tools

• Raycast - Spotlight replacement with powerful extensions
• Contexts - Fast window switcher with search capabilities
• Rectangle - Window tiling manager (snap windows to edges)

Development & DevOps

• Docker Desktop - Container management and orchestration
• Ghostty - Fast, native GPU-accelerated terminal emulator with quick terminal feature

VS Code Extensions

• GitLens - Enhanced git capabilities
• GitHub Copilot - AI pair programming
• Terraform - HashiCorp Terraform support
• Java Extension Pack - Java development
• Error Lens - Inline error highlighting

Customization

Adding New Aliases

Edit zsh/.zshrc and add to the aliases section:

alias myalias='my command'

Installing New VS Code Extensions

code --install-extension publisher.extension-name
echo "publisher.extension-name" >> vscode/extensions.txt

Adding Homebrew Packages

Edit Brewfile and add:

brew "package-name"

Then run:

brew bundle

Maintenance

Update all packages

brew update && brew upgrade

Sync dotfiles changes

Since configs are symlinked, edits to files in this repo are immediately active. Commit and push changes:

cd ~/dotfiles
git add .
git commit -m "Update configs"
git push origin main

Work vs Personal Differences

Item	Work	Personal
Git email	j.bermejo@canda.com	berme495@gmail.com
IDE	VS Code	VS Code + WebStorm
Terminal	iTerm	Ghostty
Spotlight	Default	Raycast
Window Switcher	Default	Contexts
Window Tiling	Default	Rectangle
Containers	Docker	Docker Desktop
SSL certs	Zscaler corporate certs	None (standard)
VPN	Corporate VPN	Personal preference
AI tools	Work-authenticated	Personal accounts

Troubleshooting

Permission denied when running install.sh

chmod +x install.sh

Command not found after installation

Restart your terminal or run:

source ~/.zshrc

Homebrew not found on Apple Silicon Mac

Add to ~/.zprofile:

eval "$(/opt/homebrew/bin/brew shellenv)"

License

Personal use only.