菜单
Manage dotfiles across multiple machines: hostname/OS/distro conditionals, WSL detection, per-machine data with .chezmoidata and config [data], conditional .chezmoiignore, and per-machine file selection patterns.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Write chezmoi templates: OS/machine conditionals, user-defined data variables, Sprig functions, shared fragments, and interactive prompts.
Run scripts on apply, once, or on content change — manage run_, run_once_, run_onchange_, run_before_, and run_after_ scripts and their state.
Configure chezmoi behavior: source/target dirs, data injection, encryption, editor, diff/merge tools, git auto-commit, and operation hooks.
Integrate with password managers (Bitwarden, 1Password, etc.) and manage encrypted files using age or gpg.
Bootstrap chezmoi on a new machine, clone an existing dotfiles repo, migrate existing dotfiles, or run one-shot init scripts.
Work with the chezmoi source directory: file naming prefixes, adding/removing files, externals (.chezmoiexternal for external files, archives, and git repos), special directories (.chezmoiignore, .chezmoitemplates/), and git operations.
| name | chezmoi-machine-config |
| description | Manage dotfiles across multiple machines: hostname/OS/distro conditionals, WSL detection, per-machine data with .chezmoidata and config [data], conditional .chezmoiignore, and per-machine file selection patterns. |
Key built-in variables for distinguishing machines:
| Variable | Distinguishes |
|---|---|
.chezmoi.os | Operating system ("linux", "darwin", "windows") |
.chezmoi.arch | Architecture ("amd64", "arm64") |
.chezmoi.hostname | Hostname up to the first . |
.chezmoi.fqdnHostname | Fully-qualified hostname |
.chezmoi.osRelease | /etc/os-release fields, Linux only (e.g., .chezmoi.osRelease.id) |
.chezmoi.kernel.osrelease | Kernel release string, Linux only (used for WSL detection) |
Run chezmoi data to see all values on the current machine.
Template syntax and the full variable list are in the chezmoi-templating skill.
Read OS/distro/WSL/hostname conditional patterns in references/os-patterns.md
Two places to define machine-varying values:
| Source | Templated? | Use for |
|---|---|---|
[data] in the config file (generated by .chezmoi.$FORMAT.tmpl on init) | Yes | Dynamic per-machine values: email, roles, detected facts |
.chezmoidata.$FORMAT / .chezmoidata/ in the source state | No | Static data shared across all machines |
.chezmoidata files cannot be templates because they are read before the template engine starts; anything machine-dependent must go in the config file's [data] section.
Read data source patterns and merge rules in references/per-machine-data.md
.chezmoiignore is always interpreted as a template, so files can be ignored on machines where they do not apply.
The logic is inverted: chezmoi installs everything by default, so write "ignore unless".
{{- if ne .chezmoi.hostname "work-laptop" }}
.work
{{- end }}
Read ignore patterns and rules in references/conditional-ignore.md
| Pattern | When |
|---|---|
Inline {{ if eq .chezmoi.os ... }} blocks in one .tmpl | Small differences |
include separate per-machine source files from one .tmpl | Large differences, plain content |
template named fragments from .chezmoitemplates/ | Large differences, templated content |
| Shared fragment + per-OS target paths + conditional ignore | Same content, different target locations |
| Template that renders empty | Removes the target file on that machine entirely |
Read full examples in references/os-patterns.md
.chezmoidata/.chezmoiignore file mechanics: chezmoi-source-state skill.