dotfiles

My personal dotfiles, managed with chezmoi.

Warning

Fork this repository and review the code before use. Don't blindly use my settings unless you know what they do. Use at your own risk!

For New Users

To use this repository as a template:

1. Fork this repository to your GitHub account
2. Update step 3 below: Replace lv416e/dotfiles with YOUR_USERNAME/dotfiles
3. Follow the installation steps below - you'll be prompted for your configuration
4. See Fork Guide for detailed instructions

Installation

1. Install prerequisites

First, install Homebrew if not already installed:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Then install required tools:

brew install chezmoi age 1password-cli mise

2. Configure git

git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

3. Initialize dotfiles

You'll be prompted for configuration (email, vault name, encryption options, etc.):

chezmoi init lv416e/dotfiles

4. Set up secrets (optional)

If you enabled 1Password integration during initialization:

eval $(op signin)

If you enabled age encryption, generate your key:

chezmoi age-keygen --output ~/.config/chezmoi/key.txt

Note

These steps are optional. The repository works without 1Password or age encryption.

5. Apply dotfiles

chezmoi apply -v

6. Install packages

cd ~/.local/share/chezmoi
brew bundle install
mise install
mise trust

See New Machine Setup Guide for detailed instructions and troubleshooting.

Usage

Task	Command
Edit files	chezmoi edit ~/.zshrc
Apply changes	chezmoi apply
Commit and push	chezmoi cd && git add -A && git commit -m "Update config" && git push
Quick apply (alias)	mise a
Full system sync	mise sync
Verify secrets setup	mise secrets-verify
Sign in to 1Password	mise ops
Add encrypted file (if age enabled)	chezmoi add --encrypt ~/.ssh/id_rsa

Maintenance

Task	Command
Update mise tools	mise sys-update
Update Homebrew packages	brew update && brew upgrade
Clean caches	mise sys-clean
Health check	mise sys-health

What's Included

Shell & Terminal

• zsh - Fast shell with Powerlevel10k prompt
• tmux / Zellij - Terminal multiplexers (switchable)
• WezTerm - GPU-accelerated terminal emulator
• starship - Cross-shell prompt (alternative)

Development Tools

• mise - Universal version manager + task runner
• jj (Jujutsu) - Modern VCS (co-exists with git)
• neovim - Extensively configured editor
• gh - GitHub CLI
• docker - Containerization

Productivity

• fzf - Fuzzy finder
• ripgrep - Fast search
• fd - Fast find
• bat - Better cat
• eza - Better ls
• zoxide - Smart cd

Security & Secrets

• age - Modern encryption tool
• 1password-cli - Secret management
• gitleaks - Secret scanning
• lefthook - Fast git hooks

Documentation

• New Machine Setup Guide - Complete setup guide
• Fork Guide - Fork and customize instructions
• Secrets Management - 1Password and age encryption
• Pre-Commit Hooks - Git hooks with lefthook and gitleaks
• Zsh Config Switching - Modular vs monolithic
• Multiplexer Abstraction - Unified tmux/zellij interface
• Keybindings Reference - Quick reference for tmux/zellij
• Modern Tools - jj, WezTerm, Zellij guides
• Mise Tasks - Task runner documentation