vsync

Your AI tools share memory now.

You told Claude Code about your auth architecture. Now you open Cursor. It has no idea. You re-explain. Again.

vsync fixes this. One command. Your AI tools share context automatically.

npx @verifiedstate/sync start

The problem

Every AI coding tool keeps its own memory:

• Claude Code reads CLAUDE.md
• Cursor reads .cursorrules
• ChatGPT, Obsidian, Slack, Notion — all siloed

You make a decision in one tool. The others don't know. You lose 10-15 minutes per session re-explaining context. Worse, tools make contradictory decisions because they don't share state.

What vsync does

Syncs your AI tool configs bidirectionally. Change CLAUDE.md, and .cursorrules updates automatically. And vice versa.

| CLAUDE.md Section | .cursorrules Section | Direction | |---|---|---| | ## Build Rules | ## Rules | ↔ Bidirectional | | ## Stack | ## Tech Stack | ↔ Bidirectional | | ## Core rules | ## Constraints | ↔ Bidirectional | | ## API endpoints | ## API endpoints | ↔ Bidirectional | | ## Session protocol | — | Skipped (Claude Code only) | | — | ## Cursor Settings | Skipped (Cursor only) |

Tool-specific sections are preserved. Shared sections sync. Nothing gets overwritten that shouldn't be.

How it works

• Watches your project directory for changes to CLAUDE.md and .cursorrules
• Syncs matching sections when either file changes
• Hash-based loop prevention — no infinite sync cycles
• Atomic writes — temp file + rename, never corrupts your config
• 2-second debounce — waits for you to finish typing
• Auto-backup — creates .cursorrules.backup / CLAUDE.md.backup before overwriting

Commands

vsync start                 # run in background
vsync start --foreground    # run in terminal (see sync events live)
vsync stop                  # stop the daemon
vsync status                # show sync count and last activity

Part of something bigger

vsync syncs two files locally. That's the start.

VerifiedState connects 8 tools — Cursor, Claude Code, GitHub, Notion, Slack, Google Drive, Linear, Obsidian — into one shared memory. Every tool talks to every tool. 8 tools, 28 connections, one memory.

vsync is the local-first entry point. VerifiedState is the full mesh.

License

MIT

by VerifiedState