Cursor Vaults (VSCode-format extension for Cursor)

Sync rules and commands from remote vaults directly into the standard Cursor folders:

• .cursor/rules/**
• .cursor/commands/**

No alternate folders are used; content is merged and overwritten according to precedence.

Features (MVP)

• Configure vaults (absolute path or file:// URL)
• Merge-and-overwrite into .cursor/rules and .cursor/commands
• Precedence via vault order and precedence value
• Include/Exclude globs
• Commands: Sync Now, Add/Remove/Toggle Vault, View Planned Changes

Install & Build

npm install
npm run compile

Load the extension in VS Code/Cursor (Run -> Start Debugging) or package with vsce.

Configure

In settings (settings.json):

{
  "cursorVaults.vaults": [
    {
      "name": "acme-core",
      "url": "/absolute/path/to/acme-core-vault",
      "enabled": true,
      "precedence": 10,
      "includeGlobs": ["**/*"],
      "excludeGlobs": ["**/*.bak"]
    }
  ],
  "cursorVaults.namespacing.mode": "none",
  "cursorVaults.protectLocal": false,
  "cursorVaults.conflictPolicy": "overwrite",
  "cursorVaults.syncOnOpen": true,
  "cursorVaults.dryRunOnSync": false
}

Vault layout must contain .cursor/rules and/or .cursor/commands.

Commands

• Cursor Vaults: Sync Now
• Cursor Vaults: Add Vault
• Cursor Vaults: Remove Vault
• Cursor Vaults: Enable/Disable Vault
• Cursor Vaults: View Planned Changes (dry-run plan)

Notes

• The extension writes only under .cursor/rules and .cursor/commands in your workspace.
• Defaults enforce merge-and-overwrite (last-wins by precedence/order).