Dotfiles

Personal dotfiles setup optimized for DevOps workflows, managed with GNU Stow.

📦 What's Included

Core Tools

• Neovim - Lightning-fast navigation with FZF and Telescope, LSP support, DevOps workflows
• ZSH - Extended shell with custom aliases, functions, and performance optimizations
• Git - Version control configuration with delta diffs and workflow aliases
• Kitty - Terminal emulator with theme system and keyboard shortcuts

Development Tools

• Go - Development environment with linter configuration
• Atuin - Advanced shell history with fuzzy search and sync
• Broot - Interactive directory tree navigation
• Ripgrep - Fast text search with configuration
• LSD - Modern ls replacement

System Tools

• Btop - Resource monitor with beautiful TUI
• Ghostty - GPU-accelerated terminal emulator
• LinearMouse - Mouse acceleration configuration

🚀 Installation

Quick Start (macOS)

git clone <your-repo-url> ~/dotfiles
cd ~/dotfiles
./install.sh

The installer handles:

• Homebrew and CLI tools installation
• ZSH setup with Zinit and plugins
• Neovim configuration and plugin sync
• GNU Stow symlink creation
• Path fixes for your environment

📚 Component Documentation

Core Components

• Neovim - Text editor with LSP, plugins, and DevOps tools
• ZSH - Shell with aliases, functions, and performance features
• Git - Version control configuration and aliases
• Kitty - Terminal emulator configuration
• Atuin - Advanced shell history

Development Tools

• Go - Go development environment
• Broot - Tree view and file navigation
• Ripgrep - Text search configuration
• LSD - Modern ls replacement

System Tools

• Btop - System monitor
• Ghostty - GPU-accelerated terminal
• LinearMouse - Mouse configuration

Utilities

• Scripts - Automation scripts and utilities
• Scratchpad - Notes and temporary files

🔄 Sync Between Machines

Synchronize dotfiles across machines:

~/dotfiles/scripts/sync.sh

This script:

• Pulls latest changes from git
• Runs brew bundle to sync packages
• Re-stows all configurations

Workflow

Adding new tools:

brew install new-tool
cd ~/dotfiles
brew bundle dump --force
git add .
git commit -m "Add new-tool"
git push

Syncing to other machines:

~/dotfiles/scripts/sync.sh

💡 Tips

• Run ./scripts/health-check.sh after installation to verify setup
• Use ./scripts/benchmark.sh to check shell startup performance
• See component READMEs for detailed configuration options
• Backup configs with ./scripts/backup-configs.sh before major changes