description
A modern, cross-platform development environment for WSL2, Arch, and Debian, powered by chezmoi and mise.

My Dotfiles

A modern, cross-platform development environment for WSL2, Arch/EndeavourOS, and Debian/Ubuntu, powered by chezmoi and mise.

Features

• Enhanced Documentation — Professional static site powered by MkDocs Material.
• Cross-Distro — Works on Arch, EndeavourOS, Ubuntu, Debian, and WSL2.
• Tiered Shell Support — zsh for full interactive UX, bash for stable server baseline.
• Tool Management — All CLI tools and environment variables managed declaratively via mise.toml.
• Auto-Sync — chezmoi apply automatically commits and pushes changes.
• Idempotent — Safe to re-run install at any time.
• Failure-Safe Install — Install/bootstrap roll back partial state on failure instead of leaving orphaned files.
• Performance Optimized — Lazy-loading and optimized mise caching for faster shell initialization.
• Modern Tmux UX — Intuitive copy/paste flow, resilient status integrations, and unified clipboard behavior.
• Server Deployment: Guide for deploying to servers and homelabs via Ansible or bootstrap.

Quick Start

Tip

New here? Check out the Day One Guide for a narrative walkthrough. For detailed installation instructions (Mac, Windows, Servers), see Installation Guide.

Linux/macOS (one-line bootstrap):

curl -fsSL https://raw.githubusercontent.com/jerdaw/dotfiles/main/scripts/bootstrap | bash

Minimal / Server (local clone, minimal toolset):

git clone https://github.com/jerdaw/dotfiles.git ~/repos/dotfiles
cd ~/repos/dotfiles
./scripts/bootstrap --server

Dotfiles Only (via chezmoi):

chezmoi init --apply jerdaw/dotfiles --exclude "run_once_*"

How It Works

graph LR
    repo[Using <b>mise</b> & <b>chezmoi</b>]

    repo -->|1. Installs Tools| mise[mise.toml]
    repo -->|2. Manages Dotfiles| chezmoi[chezmoi]

    mise -->|Provides| tools[NeoVim, Node, Go, Rust...]
    chezmoi -->|Configures| configs[~/.zshrc, ~/.gitconfig...]

    tools & configs -->|Powering| term[🚀 Your Terminal]

Loading

Key Tools

Tool	Category	Replaces	Description
mise	Manager	asdf/nvm	Polyglot tool version manager
chezmoi	Dotfiles	stow	Template-based dotfile manager
neovim	Editor	vim	Hyperextensible text editor
eza	Files	ls	Modern ls with icons
bat	Files	cat	Syntax-highlighted cat
ripgrep	Files	grep	Ultra-fast recursive grep
fzf	Files	-	Fuzzy finder for everything
zoxide	Navigation	cd	Smarter cd that learns
lazygit	Git	-	Terminal UI for git
atuin	Shell	history	Magical shell history sync

Note

See Tools Reference for the complete list of 60+ tools.

Maintenance

The dots command is your unified interface:

dots bootstrap            # Bootstrap prerequisites + install flow
dots install              # Install dotfiles and tools
dots update               # Update everything (git pull + mise upgrade)
dots doctor               # Health check
dots test                 # Run test suite
dots sync                 # Sync repo (git pull + push)
dots cz apply             # Apply changes via chezmoi

Documentation

View Full Documentation Site →

Document	Description
Installation	Detailed setup guide
Day One Guide	Narrative walkthrough
Work Environments	Deploy to professional/work servers
Tools Reference	Full tool list & rationale
Customization	Personalization guide
Troubleshooting	Common issues and fixes
Contributing	How to contribute

License

MIT