chezmoi

分类: 商业与运营 | 上传者: MasahiroSakoda | 下载: 0 | 版本: v1.0（最新）

使用 chezmoi 管理点文件。在使用 chezmoi 配置、设置或存储库结构、管理文件、模板或脚本（Go 模板语法、run_once_/run_onchange_ 脚本、.chezmoidata）、处理文件属性（符号链接、权限、加密、外部源）、对 chezmoi 操作进行故障排除或了解应用程序顺序时使用。

更新日志: Source: GitHub https://github.com/MasahiroSakoda/dotfiles

目录结构

当前层级: tree/main/.agents/skills/chezmoi/

📁 references/
- 📄 attributes.md 2.7 KB
- 📄 commands.md 3.3 KB
- 📄 externals.md 2.6 KB
- 📄 scripts.md 1.5 KB
- 📄 secrets.md 1009 B
- 📄 special-files.md 2.6 KB
- 📄 templates.md 4.9 KB
📄 SKILL.md 2.8 KB

SKILL.md

---
name: chezmoi
description: >
    Manage dotfiles with chezmoi.
    Use when working with chezmoi config, setup, or repo structure, managing files, templates, or script's
    (Go template syntax, run_once_/run_onchange_ scripts, .chezmoidata),
    handling file attributes (symlinks, permissions, encryption, external sources),
    Troubleshooting chezmoi operations or understanding application order.
allowed-tools:
  - Read
  - Edit
  - Write
  - Glob
  - Grep
  - Bash(chezmoi:*)
---

# chezmoi - Cross platform dotfiles manager

## Core Principles

- **Preview Changes**: Always execute `chezmoi diff` or `chezmoi cat <file>` before any applying.
- **Secret Management**: If you find any security concerns, HIGHLIGHT them and suggest improvements or alternatives.

## Core Concepts

### Three-Tier Architecture

1. **Home directory** (`~`) - Your actual dotfiles (destination state)
2. **Source directory** (`~/.local/share/chezmoi/`) - Chezmoi's managed files (source state)
3. **Remote repository** - Git repo for syncing across machines

### Source State Encoding

Chezmoi encodes file attributes in filenames:

- `dot_bashrc` → `~/.bashrc`
- `private_dot_netrc` → `~/.netrc` (restricted permissions)
- `executable_dot_local/bin/script` → `~/.local/bin/script` (executable)

## Directory Structure

```text
~/.local/share/chezmoi/
├── .chezmoiroot              # Root directory specifier
└──  home/                    # $HOME directory
      ├── .chezmoidata/       # Custom template data
      ├── .chezmoiexternals/  # External resource config
      ├── .chezmoiscripts/    # Script directory
      ├── .chezmoitemplates/  # Reusable partial templates
      ├── .chezmoi.toml.tmpl  # Config template (prompts during init)
      ├── .chezmoiremove.tmpl # Patterns of files to remove on apply
      ├── .chezmoiignore      # Ignore patterns
      └── .chezmoiversion     # Minimum version specifier

```

## References

- **[Commands](references/commands.md)**: chezmoi commands with usage
- **[Special Files & Directories](references/special-files.md)**: `.chezmoi*` files and directories control chezmoi behavior.
- **[Attributes](references/attributes.md)**: Prefixes / suffixes on source filenames control behavior (`dot_`, `private_`, `.tmpl`, etc).
- **[Scripts](references/scripts.md)**: Scripts in `.chezmoiscripts/` run during apply. Format: `run_[once_|onchange_][before_|after_]<order>-<name>.<ext>[.tmpl]`
- **[Templates](references/templates.md)**: Go text/template library syntax used in `chezmoi`, variables, and functions
- **[Externals](references/externals.md)**: External resources config in `.chezmoiexternals/` which is fetched from URLs, archives, and git repositories
- **[Secrets](references/secrets.md)**: Secret management instructions which have to use encryption or 1Password

登录后下载/点赞/收藏 ❤ 7 | ★ 0

chezmoi

目录结构

SKILL.md

举报内容

提示