dmmulroy/.dotfiles Documentation

The system is built on several core components:

• Symlink Management: Uses GNU Stow to link files from ~/.dotfiles/home/ to your actual home directory (~).
• Package Management: Uses Homebrew with two distinct bundles: packages/bundle for base tools and packages/bundle.work for work-specific tools.
• Shell & Tools: Configures Fish shell (via Fisher), Neovim (via lazy.nvim), and Herdr (for workspaces).
• Modular Design: Configurations are separated by tool (e.g., home/.config/nvim/) and context (work vs personal).

To set up your development environment using these dotfiles, clone the repository to ~/.dotfiles and run the dot init command. You can customize the installation by skipping specific components like SSH key generation or font installation using flags.

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

# Full setup (installs everything)
./dot init

# Or customize the installation
./dot init --skip-ssh --skip-font

The dot command is the primary interface for managing your environment. After the initial setup, use it for updates, health checks, and package management.

dot update          # Pull latest changes, update Homebrew, and re-stow
dot doctor          # Run comprehensive environment diagnostics
dot check-packages  # Show installed vs missing packages
dot retry-failed    # Reinstall packages that failed during setup

If you encounter issues, follow these steps:

• dot command not found: Source your Fish config (source ~/.config/fish/config.fish) or manually add $HOME/.dotfiles to your PATH.
• Package failures: Run dot check-packages to identify failures and dot retry-failed to attempt reinstallation.
• Broken symlinks: Run dot doctor to diagnose and dot stow to fix them.
• pi (AI agent) issues: Ensure Vite+ is installed, then install pi via the tool registry using vp install -g @mariozechner/pi-coding-agent.

To make the dot command available from any directory (adding it to your PATH), use the link command. To remove it, use unlink.

dot link   # Install globally
dot unlink # Remove global installation

Use dot benchmark-shell to measure Fish shell startup performance. It provides high-precision timing and statistical analysis (average, min, max, range) with color-coded performance assessments.

# Run 10 benchmarks (default)
dot benchmark-shell

# Run specific number of benchmarks
dot benchmark-shell -r 20

# Show verbose output with individual timings
dot benchmark-shell -v

# Combine options
dot benchmark-shell -r 15 -v