菜单
Manage dotfiles with symlinks from a central git repository. Use when tracking config files, syncing dotfiles between machines, or bootstrapping a new machine. Triggers include "dotfiles", "sync config", "dfs", "track dotfiles", "symlink config", "new machine setup".
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/heldernoid/agentic-build-templates --skill dotfile-sync命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
基于 SOC 职业分类
| name | dotfile-sync |
| description | Manage dotfiles with symlinks from a central git repository. Use when tracking config files, syncing dotfiles between machines, or bootstrapping a new machine. Triggers include "dotfiles", "sync config", "dfs", "track dotfiles", "symlink config", "new machine setup". |
CLI tool for tracking and syncing dotfiles via a git-backed symlink repository.
# Initialize dotfiles repo (new)
dfs init --remote git@github.com:user/dotfiles.git
# Track a file
dfs add ~/.zshrc
dfs add ~/.gitconfig
# Push to remote
dfs push
# On a new machine: clone and link everything
dfs init --clone git@github.com:user/dotfiles.git
dfs link
dfs add ~/.zshrc # track file
dfs add ~/.config/nvim/init.lua # nested path supported
dfs add ~/.config/work/config --profile work-mac # add to specific profile
dfs list # all tracked files with symlink status
dfs status # overall health: linked count, git status
Status symbols:
ok - file is correctly symlinked* - file needs linking (unlinked)x - conflict (file exists but is not a repo symlink)? - missing (symlink target not in repo)dfs link # create all missing symlinks
dfs link --force # overwrite conflicting files
dfs link ~/.zshrc # link specific file
dfs unlink # remove all symlinks (files remain tracked)
dfs push # git add + commit + push
dfs push --message "add nvim config" # custom commit message
dfs pull # git pull + re-link new files
dfs diff # show uncommitted changes
dfs diff ~/.zshrc # diff specific file
Profiles group files for specific machines:
dfs profile list # all profiles
dfs profile create work-mac # create profile
dfs profile add work-mac ~/.config/work # add file to profile
dfs profile apply work-mac # link only this profile's files
The common profile includes all files with no profile assignment (linked on all machines).
# Clone existing dotfiles repo
dfs init --clone git@github.com:user/dotfiles.git
# Apply a specific profile
dfs link
# or
dfs init --clone git@github.com:user/dotfiles.git --profile home-linux
dfs remove ~/.zshrc # stop tracking, restore original file
| Command | Description |
|---|---|
init | Initialize dotfiles repo |
add <file> | Track a file |
remove <file> | Stop tracking a file |
list | List tracked files with status |
status | Overall sync status |
link [file] | Create symlinks |
unlink [file] | Remove symlinks |
push | Commit and push changes |
pull | Pull and re-link |
diff [file] | Show uncommitted changes |
profile | Manage machine profiles |
| Variable | Default | Description |
|---|---|---|
DFS_REPO_PATH | ~/dotfiles | Dotfiles repository path |
DFS_NO_COLOR | 0 | Disable ANSI color (1 to disable) |
DFS_DEBUG | 0 | Enable debug logging (1 to enable) |
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | File not tracked |
| 2 | Conflict (file exists, not a symlink) |
| 3 | Runtime error |