Sync
Manages data synchronization with external tools (Serena, chezmoi, Syncthing, etc.).
Topics
| Topic | Description | Guide |
|---|---|---|
| agents | Windows+WSL multi-agent share layout (~/.agents source of truth + ~/.claude/plugins split) | agents.md |
| chezmoi | dotfile chezmoi template management | chezmoi.md |
| knowledge | Session knowledge → Serena memory sync | knowledge.md |
| mcp | MCP server sync (delegated to chezmoi) | mcp.md |
| syncthing | chezmoi source Syncthing sync and diagnostics | syncthing.md |
Quick Reference
Agents Layout (Windows + WSL)
"Windows WSL agents layout" → ~/.agents source of truth, ~/.claude/{skills,rules,agents} symlinks
"plugins split" → Why ~/.claude/plugins/ is NOT shared
"marketplace EACCES" → Recovery for plugin marketplace rename collisions
Bootstrap script: ~/.agents/skills/dotfile/scripts/link-shared-ai-configs.{sh,ps1}
- Creates symlinks from
~/.agents/{skills,rules,agents}/into Claude / Codex / Gemini / Antigravity - Idempotent + auto-backup to
.bak/<name>-<timestamp>
Knowledge Sync
"knowledge sync" → Current project session → Serena memory
Chezmoi
"chezmoi add" → Add a dotfile to chezmoi
"dotfile management" → chezmoi template operations
Configurations managed by chezmoi:
~/.utcp_config.json- UTCP global config~/.claude.json,~/.cursor/mcp.json- MCP server config~/Library/.../Syncthing/config.xml- Syncthing default config
MCP server sharing:
- Single source:
.chezmoitemplates/mcp-servers.json chezmoi apply→ Automatically applied to all apps
MCP
"MCP server add" → Edit mcp-servers.json → chezmoi apply
"MCP sync" → Apply MCP config to all apps
Syncthing
"syncthing setup" → chezmoi source sync configuration
".stignore" → Ignore pattern configuration
"sync incomplete" → Per-folder status/need item diagnostics
"encryption consistency"→ Garbage encryptionPassword diagnosis & API PUT cleanup
"DB reset" → Stale index reset (delete index-v2)
Auto-generated .stignore:
.git(?d).DS_Store— Prevents orphaned.DS_Storeon remote deletion*.bak