chezmoi

Manage your dotfiles across multiple diverse machines, securely.

Detected by chezmoi | macOS, Linux, Windows |www.chezmoi.io

chezmoi already syncs these files itself. Two writers on one file fight, and the tool wins — it holds the file open and rewrites it from its own copy. Leave these to chezmoi, or turn its own sync off before handing them to anything else. Otty lists this tool like any other and leaves it switched off, and asks before you turn it on.

Sync rules

What travels, what stays, what never leaves

chezmoi in your home directory Every rule on this page, by file

sourceDir = "/Users/octocat/.local/share/chezmoi"machine-local

destDir = "/Users/octocat"machine-local

cacheDir = "/Users/octocat/Library/Caches/chezmoi"machine-local

workingTree = "/Users/octocat/dotfiles"machine-local

persistentState = "/Users/octocat/Library/Application Support/chezmoi/chezmoistate.boltdb"machine-local

mode = "file"

umask = 0o022

…

Each machine keeps its own copy of these.

sourceDir: /home/octocat/.local/share/chezmoimachine-local

destDir: /home/octocatmachine-local

cacheDir: /home/octocat/.cache/chezmoimachine-local

workingTree: /home/octocat/dotfilesmachine-local

persistentState: /home/octocat/.config/chezmoi/chezmoistate.boltdbmachine-local

mode: file

data:

email: octocat@example.com

…

Each machine keeps its own copy of these.

{

"sourceDir": "/home/octocat/.local/share/chezmoi",machine-local

"destDir": "/home/octocat",machine-local

"cacheDir": "/home/octocat/.cache/chezmoi",machine-local

"workingTree": "/home/octocat/dotfiles",machine-local

"persistentState": "/home/octocat/.config/chezmoi/chezmoistate.boltdb",machine-local

"mode": "symlink",

"data": {

"email": "octocat@example.com",

…

Each machine keeps its own copy of these.

· chezmoi.jsonc Sync

· ~/.cache/chezmoi/ Exclude

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/chezmoi.tomlThe file this page is generated from

id = "chezmoi"

name = "chezmoi"

homepage = "https://www.chezmoi.io"

description = "Manage your dotfiles across multiple diverse machines, securely."

icon = "theSVG:chezmoi"

detect = ["chezmoi"]

# https://www.chezmoi.io/reference/configuration-file/ — "chezmoi searches for

# its configuration file according to the XDG Base Directory Specification",

# reading $HOME/.config/chezmoi/chezmoi.$FORMAT on Unix and

# %USERPROFILE%/.config/chezmoi/chezmoi.$FORMAT on Windows, where $FORMAT is

# one of json, jsonc, toml or yaml. The two spell the same path here.

paths = [

"~/.config/chezmoi/chezmoi.toml",

"~/.config/chezmoi/chezmoi.yaml",

"~/.config/chezmoi/chezmoi.json",

"~/.config/chezmoi/chezmoi.jsonc",

]

# internal/cmd/config.go, newConfigFile(): CacheDirAbsPath is

# `bds.CacheHome/chezmoi`, and chezmoi's twpayne/go-xdg BaseDirectorySpecification

# sets CacheHome to $XDG_CACHE_HOME, else ~/.cache, with no per-OS branch — the

# XDG cache home on macOS too, hence [xdgCache] rather than [cacheHome].

exclude = ["[xdgCache]/chezmoi/"]

# chezmoi holds no credential file of its own: secrets are pulled from an

# external manager (1Password, pass, Bitwarden, …) when a template renders.

secret = []

# Carrying these files between machines is chezmoi's entire job.

self_sync = true

# Every one of these is an absolute path to a directory on this machine —

# see the "Variables" table at

# https://www.chezmoi.io/reference/configuration-file/variables/ (cacheDir

# "Cache directory", destDir "Destination directory", persistentState

# "Location of the persistent state file", sourceDir "Source directory",

# workingTree "git working tree directory"). A machine that relocated any of

# them must keep its own value. Relocating any of them is the user's own doing

# and has to be redone by hand on a rebuild, so the values are kept: backup.

[[machine_lines]]

file = "~/.config/chezmoi/chezmoi.toml"

match = { key_path = ["sourceDir", "destDir", "cacheDir", "workingTree", "persistentState"] }

scope = "backup"

[[machine_lines]]

file = "~/.config/chezmoi/chezmoi.yaml"

match = { key_path = ["sourceDir", "destDir", "cacheDir", "workingTree", "persistentState"] }

scope = "backup"

[[machine_lines]]

file = "~/.config/chezmoi/chezmoi.json"

match = { key_path = ["sourceDir", "destDir", "cacheDir", "workingTree", "persistentState"] }

scope = "backup"

# chezmoi.jsonc gets no rule: JSONC is not one of the parsers a rule can name,

# so a consumer could not apply it.

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/chezmoi. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page. None of them splits sourceDir and destDir for you — that part is Otty’s own sync, or a template you write by hand.