Chezmoi data#

This page explains the static data files that templates read during rendering. Data files keep machine path rules in one place so templates can stay small.

Data files in this repo#

  • home/.chezmoidata/executable-paths.toml stores executable lookup paths by OS.

  • The data separates home_relative entries from absolute entries.

  • home_relative paths are joined with .chezmoi.homeDir by template helpers.

executable-paths.toml#
 1[executable_paths.linux]
 2home_relative = [".local/bin"]
 3absolute = ["/usr/local/bin", "/usr/bin"]
 4
 5[executable_paths.windows]
 6home_relative = [
 7  'AppData\Local\Microsoft\WinGet\Links',
 8  'AppData\Local\Programs\KDiff3\bin',
 9]
10# Example absolute paths on Windows:
11# 'C:\Program Files\Neovide'
12# 'C:\Program Files\ImageMagick-7.1.2-Q16-HDR'
13absolute = []

Operational notes#

  • Data in .chezmoidata merges into template context and is available as top-level keys.

  • Keep these files static; they are not template files.

  • Use chezmoi data to inspect the merged data dictionary on a machine.