Personal dotfiles and home directory configuration for consistent development environments across machines.

This repository contains my personal shell configurations, editor settings, and custom utility scripts that I use to quickly set up a productive development environment on new machines. It includes configurations for zsh with Oh My Zsh, Vim settings, and various helpful aliases and tools.

$ cd
$ git clone https://github.com/MasonEgger/homedir.git
$ cd homedir
$ ansible-playbook ansible/setup.yml    # Install everything

Modular Installation Options:

# Install specific components
ansible-playbook ansible/setup.yml --tags packages     # Only install packages
ansible-playbook ansible/setup.yml --tags dotfiles     # Only install core dotfiles  
ansible-playbook ansible/setup.yml --tags claude       # Only install .claude directory
ansible-playbook ansible/setup.yml --tags homedir      # Only install .homedir scripts

# Combine multiple components
ansible-playbook ansible/setup.yml --tags packages,dotfiles
ansible-playbook ansible/setup.yml --tags claude,homedir

Check Mode and Preview Options:

# See what would change without making changes
ansible-playbook ansible/setup.yml --check
ansible-playbook ansible/setup.yml --tags dotfiles --check

# Show detailed before/after diffs of file changes
ansible-playbook ansible/setup.yml --check --diff
ansible-playbook ansible/setup.yml --tags dotfiles --check --diff

Additional Options:

• --check - Preview changes without making them
• --diff - Show detailed before/after diffs

Features:

• Modular installation: Install only the components you need (packages, dotfiles, claude, homedir)
• Cross-platform package management: Automatically installs development tools via Homebrew (macOS) or apt (Ubuntu/Debian)
• Check mode support: Preview changes before making them with --check and --diff
• Idempotent: Safe to run multiple times, only makes necessary changes

Additional Configuration:

• Shell: Zsh with Oh My Zsh (geoffgarside theme)
• Plugins: git
• Path additions: ~/.homedir
• Local configuration: ~/.zshrc.local for machine-specific settings (auto-created, git-ignored)
• Other: thefuck alias integration, GPG TTY export

• Mouse support: Enabled for scrolling and pane selection
• Function key bindings:
  • F2 - Create new window
  • F3 - Previous window
  • F4 - Next window
  • Ctrl+F2 - Horizontal split
  • Shift+F2 - Vertical split
• Pane navigation: Shift+Arrow keys to move between panes
• Visual: Magenta status bar with black text, colored pane borders
• Settings: 10,000 line scrollback buffer, 256-color support, windows numbered from 1

.
├── .claude/                      # Claude AI assistant configuration
│   ├── CLAUDE.md                 # Claude-specific documentation  
│   ├── commands/                 # Custom Claude commands
│   │   ├── brainstorm.md         # Interactive specification development
│   │   ├── do-gh-issue.md        # GitHub issue resolution workflow
│   │   ├── do-prompt-plan.md     # Execute prompt plans with testing
│   │   ├── do-todo.md            # Todo list execution workflow
│   │   ├── find-missing-tests.md # Test coverage analysis
│   │   ├── lyra.md               # AI prompt optimization specialist
│   │   ├── plan.md               # Project planning and blueprints
│   │   ├── session-summary.md    # Session documentation generator
│   │   └── setup.md              # Python project configuration
│   ├── docs/                     # Additional Claude documentation
│   │   └── python.md             # Python development guidelines
│   └── settings.json             # Global Claude settings
├── .homedir/                     # Custom utility scripts
│   ├── lmsify                    # Markdown to HTML converter
│   ├── my-tools                  # Tool help display
│   └── wordcount                 # Word count utility
├── ansible/                      # Ansible automation setup
│   ├── setup.yml                 # Main Ansible playbook (orchestration only)
│   ├── group_vars/               # Variable definitions
│   │   └── all.yml               # Package lists and configuration
│   ├── tasks/                    # Modular task definitions
│   │   ├── packages.yml          # Package management tasks
│   │   ├── dotfiles.yml          # Core dotfiles installation
│   │   ├── claude.yml            # Claude directory installation
│   │   └── homedir.yml           # Homedir scripts installation
│   ├── ansible.cfg               # Ansible configuration
│   ├── hosts                     # Localhost inventory
│   ├── requirements.yml          # External role dependencies
│   └── README.md                 # Ansible usage documentation
├── .tmux.conf                    # Tmux terminal multiplexer configuration
├── .vimrc                        # Vim configuration
├── .zshrc                        # Zsh configuration with aliases
├── .zshrc.local.example          # Template for machine-specific zsh configuration
├── CLAUDE.md                     # Instructions for Claude AI assistant
└── README.md                     # This file

The .zshrc.local file allows you to maintain machine-specific settings without modifying the tracked .zshrc file. This is perfect for:

• API keys and secrets (OpenAI, GitHub tokens, AWS credentials)
• Machine-specific PATH additions (local binaries, custom tools)
• Local aliases (project shortcuts specific to this machine)
• Environment variables (DEBUG flags, local development settings)
• Override repository defaults (custom themes, plugins)

Setup:

• Automatically created during Ansible setup if it doesn't exist
• Ignored by git (safe for secrets and machine-specific settings)
• Never overwritten when re-running ansible-playbook
• Sourced at the end of .zshrc (settings here override repository defaults)

Usage:

# Edit your local configuration
vim ~/.zshrc.local

# Example content:
export OPENAI_API_KEY="sk-..."
alias myproject="cd ~/Projects/my-special-project"
export PATH="$HOME/bin:$PATH"

See .zshrc.local.example in the repository for more examples.

• Package Dependencies: The Ansible setup automatically installs required packages including lolcat, development tools, and uv
• The lmsify command requires lessonmd tool to be installed (not included in automated setup)
• The wordcount script uses uv for Python script execution and supports multiple output formats (text, JSON, CSV)
• All custom scripts in .homedir/ are executable and added to PATH
• Ansible Requirement: Ensure Ansible is installed (pip install ansible or brew install ansible)
• Safe re-runs: Running ansible-playbook ansible/setup.yml multiple times is safe and idempotent

This is a personal configuration repository, but feel free to fork and adapt for your own use. When making changes:

• Test new aliases and scripts locally before committing
• Ensure shell scripts are executable (chmod +x)
• Avoid machine-specific configurations

The CLAUDE.md file provides guidance to Claude Code (claude.ai/code) when working with this repository. Claude.md crafted by myself, and shamelessly taken from harperreed