sync-dotfiles
Installation
SKILL.md
When to invoke
- User says "sync dotfiles", "pull configs", "push configs", "check drift"
- After a session where permissions or hooks were modified
- On a new machine after cloning ai-env
Subcommands
Map user intent to sync.sh subcommand:
| Intent | Command | What it does |
|---|---|---|
| "check what's different" | sync.sh diff |
Show drift between repo and home |
| "what's tracked" | sync.sh status |
Show file registry |
| "capture my local changes" | sync.sh pull |
Home → repo (home wins) |
| "deploy repo configs" | sync.sh push |
Repo → home (repo wins) |
| "install skills" | sync.sh skills-push |
Install global skills from dotfiles/skills-lock.json |
| "sync" (ambiguous) | Show diff first, then ask direction | Safe default |