Open the Command Palette (Cmd+Shift+P on Mac, Ctrl+Shift+P on Windows/Linux)
Run the command: "Agent Rules: Open Agent Rules Editor"
The rules editor will open in a new panel
Using the Agent Rules Editor
Load Rules: Click "Load Rules" to load existing rules from the first available rule file
Edit: Make your changes to your agent instructions in the text area
Save: Click "Save to All Rule Files" to sync the rules across all configured files
File Status: Green badges show existing rule files, red badges show missing rule files
Managing Agent Rule Files
Adding a Rule File
Open Command Palette
Run: "Agent Rules: Add Agent Rule File"
Enter the relative path to the rule file (e.g., .github/copilot-instructions.md)
Removing a Rule File
Open Command Palette
Run: "Agent Rules: Remove Agent Rule File"
Select the rule file to remove from the list
Configuration
You can also manually edit the agent rule files list in VS Code settings:
Open Settings (Cmd+, on Mac, Ctrl+, on Windows/Linux)
Search for "Agent Rules Sync"
Edit the "Rule Files" array
Development
Setup
Install dependencies: npm install
Compile TypeScript: npm run compile
Press F5 to launch a new Extension Development Host window
Build
npm run compile - Compile TypeScript
npm run watch - Watch for changes and recompile
Requirements
VS Code version 1.74.0 or higher
Node.js for development
How It Works
Rules Loading: The extension reads agent rules from the first existing rule file in your list
Rules Saving: When you save, the extension writes the same rules to all configured rule files
Directory Creation: Missing directories are automatically created when saving rule files
File Status: The interface shows which rule files exist and when they were last modified
This is perfect for keeping your coding agent instructions synchronized across different AI tools and platforms - whether you're using Claude, Cursor, GitHub Copilot, Windsurf, or other AI coding assistants.
Installation
Install from VSIX File
Download the extension:
Get the latest agent-rules-sync-x.x.x.vsix file from the GitHub Releases
Install in VS Code/Cursor:
Method 1 (Command Palette):
Press Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux)
Type: Extensions: Install from VSIX...
Select the downloaded .vsix file
Method 2 (Extensions Panel):
Open Extensions panel (Cmd+Shift+X or Ctrl+Shift+X)
Click the ... (three dots) menu in the top-right
Select Install from VSIX...
Choose the downloaded .vsix file
Verify installation:
Open Command Palette (Cmd+Shift+P or Ctrl+Shift+P)
Type "Agent Rules" - you should see the extension commands available
Alternative: Build from Source
git clone https://github.com/oana-ffg/AI-rules-sync-extension.git
cd AI-rules-sync-extension
npm install
npm run compile
npx vsce package --no-dependencies
Then install the generated .vsix file using the steps above.