EVC Local Sync

Keep your project /docs and Obsidian notes always in sync — bidirectional, local-first, no copy/paste.

Built for AI-assisted coding workflows (Cursor / Claude Code / Copilot): let AI update repo docs while your Obsidian specs stay fresh automatically.

---

The Problem

You code with AI. Your AI writes and updates docs in /docs. But your Obsidian specs go stale. Or you update specs in Obsidian, and the repo doesn't know.

Result: AI hallucinates from outdated context. Teammates read wrong docs. You copy-paste manually.

Local Sync fixes this: bidirectional, automatic, local-first.

---

Install

Option A — BRAT (available now, recommended)

1. Install BRAT: Settings → Community plugins → Browse → "BRAT" → Install
2. Open BRAT: Settings → BRAT → Add beta plugin
3. Paste repo URL: https://github.com/entire-vc/evc-local-sync-plugin
4. Enable: Settings → Community plugins → EVC Local Sync → Enable

Option B — Community Plugins

Pending review. Track status →

Option C — Manual

1. Download main.js, manifest.json, and styles.css from the latest release
2. Create folder .obsidian/plugins/evc-local-sync/ in your vault
3. Copy downloaded files to this folder
4. Enable in Settings → Community plugins

---

Quickstart (3 minutes)

1. Open plugin settings → Add mapping
   • Vault path: Specs/
   • Local path: /path/to/project/docs/
2. Click Sync Now
3. (Optional) Enable Auto sync and choose a conflict strategy

✅ Changes now mirror in both directions.

AI Starter Pack — pre-configured rules for Claude Code, Cursor, and Windsurf that teach your AI agent how to work with synced /docs. Get the pack →

---

Workflows

1 — AI writes docs → Obsidian stays fresh

AI updates /docs while you code → Local Sync keeps your Obsidian notes current. No more "AI hallucinated because the spec was outdated."

2 — You edit in Obsidian → repo docs update for teammates and CI

Edit spec in Obsidian → sync → teammates and CI pipelines always read the latest docs.

3 — Dev team docs that never go stale

Connect your team's project docs to a shared vault. When any dev updates /docs (or AI does), the vault stays current. End the cycle of stale documentation.

---

Key Features

• Bidirectional sync (vault ↔ local folders)
• Multiple mappings (multiple projects / subfolders)
• Configurable conflict handling (keep both / overwrite / prompt)
• Auto sync (on-change, on-startup, scheduled)
• File deletion sync — deleted files sync across locations
• Per-mapping settings — override conflict resolution and file types per project
• Dry-run preview — see changes before syncing
• File watching with configurable debounce
• Symlink support for complex project structures
• Detailed logging with filtering and CSV export
• Backup creation before overwriting files
• Import/Export configuration for portability
• Supports .md, .canvas, .excalidraw.md files
• Fully local — works offline, nothing sent to external servers

---

Conflict Handling

Sync conflicts happen when both sides change before a sync runs.

Recommended starting point:

• Start with manual sync while testing your mapping
• Use Keep both copies until you're confident
• Check docs/Troubleshooting.md for common edge cases

---

Comparison

	Copy/paste	Manual export	Git submodule	Local Sync
Always current	❌	❌	partial	✅
Bidirectional	❌	❌	❌	✅
Conflict handling	manual	none	merge conflicts	configurable
Offline / private	✅	✅	✅	✅
Setup complexity	none	none	high	3 steps
AI IDE workflow	❌	❌	partial	✅

---

Working with a Team?

Local Sync is designed for solo workflows. If you need team collaboration or want to publish your vault as a website (private, protected, or public):

→ EVC Team Relay — self-hosted with web publish (free, bring your own VPS) or hosted (zero ops)

Why teams choose Team Relay:

• Real-time collab without Git merge conflicts
• Web publish: share vault as a beautiful website (internal wiki, client portal, or public docs)
• Flat pricing instead of $8/user/month (Notion) or $12/user/month (GitBook)

---

Feedback

Edge cases and integration requests help make this solid:

• Report a bug →
• Report a conflict case →
• Request a feature →

---

Troubleshooting

See docs/Troubleshooting.md

Common topics: renames/moves · case sensitivity (Windows/macOS) · watcher missed events · rapid edits

---

Part of the Entire VC Toolbox

Product	What it does	Link
Local Sync ← you are here	Vault ↔ AI dev tools sync	this repo
Team Relay	Self-hosted collaboration server	repo
Team Relay Plugin	Obsidian plugin for Team Relay	repo
Team Relay MCP	AI agent ↔ vault access	repo
Team Relay OpenClaw Skill	AI agent ↔ vault access	repo
Spark MCP	MCP server for AI workflow catalog	repo

---

Community

• 🌐 Telegram
• 💬 Discussions
• 📧 in@entire.vc

License

MIT