README

This repository contains my personal dotfiles for synchronization via chezmoi.

Where possible, each configuration is set up to work for Linux 🐧, macOS 26+ 🍎, and Windows 11 🪟. (OS compatibility for each product is indicated with emoji.)

Feel free to use anything here according to your needs!

Currently managed:

• 1Password 🐧 🍎 🪟
  • Config Files
    • src/.chezmoitemplates/1password/agent.toml.tmpl
• Azure CLI 🐧 🍎 🪟
  • Config Files
    • src/.chezmoidata/env-vars.toml
• Cargo 🐧 🍎 🪟
  • Config Files
    • src/.chezmoidata/env-vars.toml
• Claude 🐧 🍎 🪟
  • Config Files
    • src/dot_config/claude/CLAUDE.md
• Clocker 🍎
  • Notes
    • Configuration is imported via script src/.chezmoiscripts/30-macos/run_onchange_defaults-importer.sh.tmpl
  • Config Files
    • src/.scriptdata/macos-defaults/com.abhishek.Clocker.plist
      • Note this is a non-editable binary file, made via defaults export com.abhishek.Clocker com.abhishek.Clocker.plist
• fzf 🐧 🍎
  • Config Files
    • src/dot_config/zsh/dot_zshrc.tmpl
• Ghostty 🐧 🍎
  • Notes
    • Notification permissions are pre-granted via a configuration profile, since macOS has no supported way to grant them silently. Installed via script src/.chezmoiscripts/30-macos/run_onchange_profiles-importer.sh.tmpl
  • Config Files
    • src/dot_config/ghostty/config.tmpl
    • src/.scriptdata/macos-profiles/notifications.mobileconfig
• Git 🐧 🍎 🪟
  • Config Files
    • src/dot_config/git/config.tmpl
    • src/dot_config/git/ignore
  • Folders
    • src/git/gh for GitHub repos
    • src/git/azdo for Azure DevOps repos
• GnuPG 🐧 🍎 🪟
  • Config Files
    • src/.chezmoidata/env-vars.toml
• Go 🐧 🍎 🪟
  • Config Files
    • src/.chezmoidata/env-vars.toml
• Homebrew Autoupdate 🍎
  • Notes
    • Notification permissions are pre-granted via a configuration profile, since macOS has no supported way to grant them silently. Installed via script src/.chezmoiscripts/30-macos/run_onchange_profiles-importer.sh.tmpl
  • Config Files
    • src/.scriptdata/macos-profiles/notifications.mobileconfig
• k9s 🐧 🍎 🪟
  • Config Files
    • src/dot_config/k9s/config.yaml.tmpl
• kubie 🐧 🍎
  • Config Files
    • src/dot_kube/kubie.yaml
• macOS 🍎
  • Config Files
    • src/dot_local/share/ansible-configuration-chezmoi
    • src/.chezmoiscripts/30-macos/run_onchange_after_ansible-configure.sh.tmpl
• micro 🐧 🍎 🪟
  • Config Files
    • src/dot_config/micro/settings.json
• mise 🐧 🍎 🪟
  • Config Files
    • src/dot_config/mise/config.toml
• npm 🐧 🍎 🪟
  • Config Files
    • src/.chezmoidata/env-vars.toml
    • src/dot_config/npm/npmrc
• rustup 🐧 🍎 🪟
  • Config Files
    • src/.chezmoidata/env-vars.toml
• Terminal Color Scheme
  • Applied to Ghostty, Windows Terminal, and Visual Studio Code
  • Generated by Root Loops
• PowerShell 🐧 🍎 🪟
  • Config Files
    • src/.chezmoitemplates/powershell/aliases.ps1.tmpl
    • src/.chezmoitemplates/powershell/env.ps1.tmpl
    • src/.chezmoitemplates/powershell/profile.ps1.tmpl
• Sheldon 🐧 🍎
  • Config Files
    • src/dot_config/sheldon/plugins.toml
• Starship 🐧 🍎 🪟
  • Config Files
    • src/.chezmoidata/env-vars.toml
    • src/dot_config/starship/config.toml.tmpl
• Stats 🍎
  • Notes
    • Configuration is imported via script src/.chezmoiscripts/30-macos/run_onchange_defaults-importer.sh.tmpl
  • Config Files
    • src/.scriptdata/macos-defaults/eu.exelban.Stats.plist
      • Note this is a non-editable binary file, made via defaults export eu.exelban.Stats eu.exelban.Stats.plist
• Ungoogled Chromium 🍎
  • Notes
    • Notification permissions are pre-granted via a configuration profile, since macOS has no supported way to grant them silently. Installed via script src/.chezmoiscripts/30-macos/run_onchange_profiles-importer.sh.tmpl
  • Config Files
    • src/.scriptdata/macos-profiles/notifications.mobileconfig
• UniGetUI 🪟
  • Notes
    • Uses an unusual model of one-file-per-setting, there are many files under the below directory
  • Config Files
    • src/AppData/Local/UniGetUI/Configuration
• Visual Studio Code 🐧 🍎 🪟
  • Notes
    • Configured to support the syncing of profiles
  • Config Files
    • src/.chezmoidata/vscode.toml
      • Defines data used to provision profiles
    • src/.chezmoitemplates/vscode
      • Each file in this directory defines the settings for a profile
    • src/.chezmoiscripts/90-all/run_onchange_after_vscode-profiles.py.tmpl
      • Performs profile provisioning and updating
• VMware Workstation 🪟
  • Notes
    • VMware stores its session state in the same INI file as its settings, so needed settings are patched in-place via script
  • Config Files
    • src/.chezmoidata/windows-ini-patches.toml
• Windows 🪟
  • Config Files
    • src/dot_wslconfig
    • src/AppData/Local/winget-configuration-chezmoi
      • Files under this folder are part of a Winget Configuration used to declaratively configure Windows workstatesion
• Windows Terminal 🪟
  • Config Files
    • src/AppData/Local/Packages/Microsoft.WindowsTerminal_8wekyb3d8bbwe/LocalState/settings.json
• Zsh 🐧 🍎
  • Config Files
    • src/dot_config/zsh/dot_zsh-aliases.tmpl
    • src/dot_config/zsh/dot_zshrc.tmpl
    • src/dot_zshenv.tmpl

Loading this Config

macOS

Preflight

1. Install macOS, logging into Apple Account (unless a VM)
2. Set hostname

Automatic Installation

macOS prerequisites can be automatically installed by running the below:

curl -fS https://raw.githubusercontent.com/natescherer/dotfiles/main/init-macos.sh | bash

Manual Installation

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
eval "$(/opt/homebrew/bin/brew shellenv zsh)"
brew install chezmoi
brew install mise
mise use -g python@latest
eval "$(mise env -s zsh)"
chezmoi init --apply natescherer

Linux

Install the following tools however is appropriate for your distro:

• Starship
• Sheldon
• Mise
• Zsh (make sure to set as default shell)

Then run the below:

mise use -g python@latest
eval "$(mise env -s zsh)"
chezmoi init --apply natescherer

Windows

Preflight

1. Sign into Windows (if you made a local account) (and if you want to)
2. Install core drivers/VMware Tools/etc
   • See [docs/drivers] for known core driver configs for different machines
3. Ensure all Windows Updates are installed
4. Open the Microsoft Store, click Downloads, then click Check for updates, and install all
   • Repeat this step until the store no longer shows any updates

Automatic Installation

Windows prerequisites can be automatically installed by running the below in Windows Terminal:

irm https://raw.githubusercontent.com/natescherer/dotfiles/main/init-windows.ps1 | iex

Manual Installation

NOTE: If you are running Windows 11 25H2 and get a certificate error on any of the below steps, run the following in Admin Terminal to fix, then reopen a non-Admin Terminal and rerun the failed command.

winget settings --enable BypassCertificatePinningForMicrosoftStore
winget upgrade Microsoft.AppInstaller --accept-source-agreements --accept-package-agreements
winget settings --disable BypassCertificatePinningForMicrosoftStore
winget source reset --force

Install the latest PowerShell using this command SPECIFICALLY, as the default MSIX install has sandboxing issues, see PowerShell/PowerShell#13866

winget install --id Microsoft.PowerShell --source winget --installer-type wix

Once PowerShell is installed, reopen Windows Terminal and launch a PowerShell tab instead of Windows PowerShell.

winget install --id twpayne.chezmoi -e
winget install --id jdx.mise -e

Restart the shell, then run the below:

mise use -g python@latest
mise env -s pwsh | iex
chezmoi init --apply natescherer