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:
- Fork this repository to your GitHub account
- Update step 3 below: Replace
lv416e/dotfileswithYOUR_USERNAME/dotfiles - Follow the installation steps below - you'll be prompted for your configuration
- 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