Getting Started

Welcome to Fox's Dotfiles! This guide will help you set up a modern macOS development environment in minutes.

Prerequisites

• macOS (Apple Silicon or Intel)
• Git (comes with Xcode Command Line Tools)
• Terminal access

Quick Install

# Clone the repository
git clone https://github.com/Proteusiq/dotfiles.git ~/dotfiles

# Run the installer
cd ~/dotfiles && ./install.sh

That's it! The installer will:

1. Install Xcode Command Line Tools (if needed)
2. Install Homebrew and all packages from the Brewfile
3. Configure Node.js tools (n, Bun)
4. Create Python virtual environments
5. Install tmux and Yazi plugins
6. Symlink all configuration files using GNU Stow

What Gets Installed

Terminal Stack

Tool	Purpose
Ghostty	GPU-accelerated terminal emulator
tmux	Terminal multiplexer
Starship	Cross-shell prompt
sesh	Smart tmux session manager

Development Tools

Tool	Purpose
Neovim	Modern text editor
LazyVim	Neovim configuration framework
lazygit	Terminal UI for git

Modern CLI Replacements

Classic	Modern	Why
cat	bat	Syntax highlighting, git integration
ls	eza	Icons, colors, git status
find	fd	Faster, respects .gitignore
grep	ripgrep	10x faster, smart defaults
cd	zoxide	Learns your habits

Verify Installation

After installation, open a new terminal and run:

# Check if the update command is available
update --help

# See installed tool versions
update --versions

# Check for outdated packages
update --outdated

Next Steps

• Installation Details - Learn about the install system
• Shell Configuration - Customize your Zsh setup
• Neovim Guide - Master your editor
• Tools Reference - Explore all installed tools