Sync#

Manages data synchronization with external tools (Serena, chezmoi, Syncthing, etc.).

Topics#

TopicDescriptionGuideagentsWindows+WSL multi-agent share layout (~/.agents source of truth + ~/.claude/plugins split)agents.mdchezmoidotfile chezmoi template managementchezmoi.mdknowledgeSession knowledge → Serena memory syncknowledge.mdmcpMCP server sync (delegated to chezmoi)mcp.mdsyncthingchezmoi source Syncthing sync and diagnosticssyncthing.md

Quick Reference#

Agents Layout (Windows + WSL)#

text

"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#

text

"knowledge sync"        → Current project session → Serena memory

Chezmoi#

text

"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#

text

"MCP server add"        → Edit mcp-servers.json → chezmoi apply
"MCP sync"              → Apply MCP config to all apps

Syncthing#

text

"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_Store on remote deletion
• *.bak