Getting Started¶

Installation¶

git clone https://github.com/pypeaday/dotfiles.git ~/dotfiles
cd ~/dotfiles

Stow¶

Use GNU Stow to symlink configs to your home directory.

For a quick intro check out ThePrimeagen's YT video

Available Packages¶

Package	Description
`nvim`	Neovim + LazyVim config
`tmux`	Tmux configuration
`zsh`	Zsh shell config
`starship`	Prompt configuration
`git`	Git config and aliases
`lazygit`	Lazygit TUI config
`fzf`	Fuzzy finder config
`k9s`	Kubernetes TUI config
`kitty`	Kitty terminal config
`aerospace`	macOS window manager
`opencode`	AI coding assistant config
`iron`	Work environment (GitHub Copilot)
`home`	Home environment (free models)

Basic Usage¶

cd ~/dotfiles

# Symlink a single package
stow nvim

# Symlink multiple packages
stow nvim tmux zsh starship git lazygit fzf

# Remove symlinks
stow -D nvim

# Restow (update symlinks)
stow -R nvim

Platform-Specific Setup¶

macOS¶

# Install Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install core tools
brew install neovim tmux fzf ripgrep fd lazygit starship stow

# Install window manager
brew install --cask aerospace kitty

Linux (Ubuntu/Debian)¶

# Install core tools
sudo apt update
sudo apt install neovim tmux fzf ripgrep fd-find stow

# Install from other sources
# lazygit: https://github.com/jesseduffield/lazygit#installation
# starship: curl -sS https://starship.rs/install.sh | sh

Quick Start¶

# Clone and set up essential configs
git clone https://github.com/pypeaday/dotfiles.git ~/dotfiles
cd ~/dotfiles
stow nvim tmux zsh starship git