Dotfiles (Chezmoi)

Modern, cross-platform dotfile management using chezmoi for rapid machine provisioning.

One command. Fresh machine. Ready in 10 minutes. ⚡

---

🚀 Quick Start

Windows (PowerShell)

iwr -useb https://raw.githubusercontent.com/Randallsm83/dotfiles/main/bootstrap.ps1 | iex

Windows — Restore from Scoop Export (fastest)

If you have a scoop export from a previous machine:

# 1. Install scoop
irm get.scoop.sh | iex

# 2. Import all packages (buckets + apps in one shot)
scoop import .\scoop-export.json

# 3. Apply configs
chezmoi init --apply Randallsm83/dotfiles

Or use the bootstrap script with -ScoopExport:

iwr -useb https://raw.githubusercontent.com/Randallsm83/dotfiles/main/bootstrap.ps1 -OutFile bootstrap.ps1
.\bootstrap.ps1 -ScoopExport .\scoop-export.json

Tip: After setup, chezmoi keeps ~/.config/scoop/scoop-export.json in sync with your feature flags — always ready for next time.

Unix/Linux/WSL (bash/zsh)

curl -fsSL https://raw.githubusercontent.com/Randallsm83/dotfiles/main/setup.sh | bash

This single command will:

1. Install chezmoi (via scoop/mise)
2. Clone this repository
3. Apply all configurations (with platform-specific templates)
4. Install package managers (scoop/mise if missing)
5. Configure shell environments
6. Set up 1Password SSH agent integration
7. Ready to work 🎉

---

📦 What's Included

Core Tools (Always Installed)

• Editors: Neovim (LazyVim-based config)
• Terminals: WezTerm, Windows Terminal (Windows), Warp
• Shell: Zsh (Unix), PowerShell 7+ (Windows)
• Prompt: Starship with custom onedark theme
• Version Control: Git with 1Password SSH agent
• CLI Tools: bat, eza, fzf, ripgrep, fd, delta, vivid, direnv, wget
• Languages: Managed by mise (node, python, ruby, go, rust, lua, bun)

Optional Packages (Feature Flag Controlled)

Languages and tools are controlled by feature flags in .chezmoidata.yaml:

Package	Default	Description
rust	✅ Enabled	Cargo, rustup, completions
golang	✅ Enabled	Go environment setup
python	✅ Enabled	Python environment variables
ruby	✅ Enabled	Ruby environment
lua	✅ Enabled	Lua environment
node	✅ Enabled	Node.js environment
glow	✅ Enabled	Markdown viewer
vivid	✅ Enabled	LS_COLORS generator (follows theme setting)
sqlite3	✅ Enabled	SQLite CLI config
warp	✅ Enabled	Warp terminal configurations
vim	✅ Enabled	Vim config
thefuck	✅ Enabled	Command correction tool
perl	✅ Enabled	Perl environment
tinted_theming	❌ Disabled	Base16/Base24 theme manager (replaced by unified theme system)
php	❌ Disabled	PHP environment
arduino	❌ Disabled	Arduino IDE config

Total managed files: 155+ configurations

---

🎨 Theme & Appearance

Unified Theme System: All apps use a single theme setting in .chezmoidata.yaml.

• Active Theme: Set via theme.name in .chezmoidata.yaml (default: spaceduck)
• Available Themes: spaceduck, onedark, gruvbox-material, tokyonight, tokyonight-storm, dracula, kanagawa
• Apps Using Theme: neovim, wezterm, starship, eza, vivid (LS_COLORS), bat, delta
• Fonts: Hack Nerd Font (primary), FiraCode Nerd Font (fallback with ligatures)

To change theme:

# .chezmoidata.yaml
theme:
  name: "onedark"  # Change this, run chezmoi apply

---

🛠️ Manual Setup (Development)

For development or testing without running the bootstrap:

1. Install Chezmoi

# Windows
scoop install chezmoi

# Unix/Linux
sh -c "$(curl -fsLS get.chezmoi.io)"

2. Initialize from this repository

chezmoi init --apply Randallsm83/dotfiles

3. Verify and update

# See what would change
chezmoi diff

# Apply changes
chezmoi apply

# Update from repository
chezmoi update

---

⚙️ Configuration

Enable/Disable Packages

Edit .chezmoidata.yaml (chezmoi source directory):

package_features:
  rust: true      # Enable rust
  python: false   # Disable python

Then apply:

chezmoi apply

Platform-Specific Configs

Configs automatically adapt to your platform:

• Windows: PowerShell profile, Windows Terminal settings, WSL config
• Unix/Linux: Zsh config, shell integrations
• WSL: Special detection and configuration
• macOS: Homebrew integration (if needed)

Package Management

• Windows: Scoop (CLI tools), Winget (GUI apps), Mise (language runtimes)
• Linux/WSL/macOS: Mise (everything via cargo + runtimes)

Package lists are in .chezmoidata.yaml under packages.scoop, winget_packages, mise_runtimes.

---

📁 Repository Structure

.local/share/dotfiles/          # Chezmoi source directory
├── .chezmoi.toml.tmpl         # Chezmoi configuration
├── .chezmoidata.yaml          # Template variables & feature flags
├── .chezmoiignore             # Platform & package exclusions
├── .chezmoiscripts/           # Auto-run installation scripts
├── .chezmoitemplates/         # Reusable template snippets
│
├── dot_config/                # XDG config files
│   ├── git/                   # Git configuration
│   ├── nvim/                  # Neovim configuration
│   ├── wezterm/               # WezTerm terminal
│   ├── starship/              # Starship prompt
│   ├── mise/                  # Mise version manager
│   ├── zsh/                   # Zsh configuration
│   └── [language packages]    # Language-specific configs
│
├── Documents/PowerShell/      # PowerShell profile (Windows)
├── AppData/Roaming/Code/      # VS Code settings (Windows)
├── dot_local/bin/             # Local scripts
├── dot_cache/zsh/             # Zsh completions
│
├── bootstrap.ps1              # Windows bootstrap script
├── setup.sh                   # Unix bootstrap script
└── README.md                  # This file

---

🔧 Common Tasks

Update Dotfiles

# Pull latest changes and apply
chezmoi update

Edit a Config

# Edit in chezmoi source
chezmoi edit ~/.config/nvim/init.lua

# Or edit and apply immediately
chezmoi edit --apply ~/.gitconfig

Add New File

# Add existing file to chezmoi
chezmoi add ~/.config/myapp/config.yml

# Add as template (for platform-specific content)
chezmoi add --template ~/.config/myapp/config.yml

View Managed Files

# List all managed files
chezmoi managed

# Count managed files
chezmoi managed | wc -l

Test Changes

# See what would change (safe)
chezmoi diff

# Dry-run apply
chezmoi apply --dry-run --verbose

---

🔐 Secrets & SSH

1Password SSH Agent Integration

SSH keys are managed by 1Password SSH agent:

• Windows: Named pipe (\\.\pipe\openssh-ssh-agent)
• Unix: Socket (~/.1password/agent.sock)

Git is configured to use 1Password for SSH authentication automatically.

Setup 1Password SSH Agent

1. Install 1Password 8+
2. Enable SSH agent in settings
3. Add SSH keys to 1Password
4. Configs automatically use the agent

---

🐧 WSL-Specific Notes

Windows Subsystem for Linux is fully supported:

• .wslconfig template for WSL2 settings
• Automatic WSL detection in configs
• 1Password SSH agent integration via npipe
• Zsh as default shell with full config

---

📝 Migration from Stow

This repository replaces the old GNU Stow-based dotfiles with modern chezmoi:

Improvements:

• ✅ One-command provisioning
• ✅ Template-based platform detection
• ✅ Feature flags for optional packages
• ✅ Integrated bootstrap scripts
• ✅ Built-in secrets management
• ✅ ~5-10 minute setup (vs 30-60 minutes)

Old repository: Stow-based (deprecated)
New repository: This one (Randallsm83/dotfiles)

---

📚 Documentation

• Chezmoi Documentation
• WARP.md - AI agent technical reference (package feature flags, testing, architecture)

---

🤝 Contributing

This is a personal dotfiles repository, but feel free to:

• Fork for your own use
• Open issues for bugs
• Submit PRs for improvements

---

📜 License

MIT License - Feel free to use and modify for your own dotfiles!

---

Made with ❤️ using chezmoi

Last updated: 2025-01-14
Managed files: 155+
Platforms: Windows, Linux, WSL, macOS