
# LHI AI Agent Sync
Effortlessly synchronize your AI agent configurations and project rules across all your development environments.
🚀 What is LHI AI Agent Sync?
LHI AI Agent Sync, by Lifehack Innovations, is the ultimate tool for keeping your AI agent (MCP server) configurations and project rules in perfect sync across VS Code, Cursor, and other supported IDEs. No more manual copying, out-of-date settings, or missed reloads—just seamless, automated configuration management for modern AI-driven development.
🌟 Key Features
- Automatic Sync: Instantly updates MCP server and project rule configs across all environments.
- Smart Reload Prompts: Detects changes and prompts you to reload only when needed.
- Multi-IDE Support: Works with VS Code, Cursor, Roo (Cline), and Claude Code.
- One-Click Deploy: Push new rules and configs with a single command.
- CLAUDE.md Export: Automatically syncs rules and MCP configs to CLAUDE.md for Claude Code integration.
- Cross-Platform: Full Linux, macOS, and Windows support with intelligent path handling.
- Clean Architecture: Modular design with npm package + VS Code extension.
🛠️ Installation
NPM Package
npm install lhi-ai-agent-sync
VS Code/Cursor Extension
Download and install the VSIX from the releases page or build from source:
cd extension
./build_vsix.sh
cursor --install-extension ../dist/lhi-ai-agent-sync-*.vsix
🧑💻 Usage
Quick Start
Initialize your project:
# Via extension (recommended)
# Command Palette: "LHI: Initialize AI Agent Sync"
# Or via npm
npx lhi-ai-agent-sync init
Configure your files:
.lhi_ai_agent_sync/project_rules.json
— Project-specific rules
.lhi_ai_agent_sync/global_mcp_config.json
— MCP server configuration
Sync automatically:
- Extension watches for file changes and syncs automatically
- Manual sync: Command Palette → "LHI: Sync AI Agent Configuration"
What Gets Synced
- Cursor: Rules →
.cursor/rules/*.mdc
files
- Roo (Cline): Rules →
.clinerules
file
- Claude Code: Rules + MCP →
CLAUDE.md
with smart markers
- Global MCP: Configuration →
~/.cursor/mcp.json
and Roo settings
Configuration Options
Control sync behavior via VS Code/Cursor settings:
{
"lhiAIAgentSync.deployRulesToCursor": true,
"lhiAIAgentSync.deployRulesToRoo": true,
"lhiAIAgentSync.deployRulesToClaude": true,
"lhiAIAgentSync.deployMCPGlobally": true,
"lhiAIAgentSync.reloadBehavior": "ask"
}
📦 Extension Commands
- Initialize AI Agent Sync — Set up new project
- Sync AI Agent Configuration — Manual sync trigger
- Show Sync Status — View current status
- Copy Claude Refresh Prompt — Get prompt to refresh Claude conversations
🏗️ Project Structure
your-project/
├── .lhi_ai_agent_sync/
│ ├── project_rules.json # Project rules
│ ├── global_mcp_config.json # MCP configuration
│ ├── backups/ # Automatic backups
│ └── global_mcp_symlinks_for_reference/ # Validation symlinks
├── .cursor/rules/ # Generated Cursor rules
├── .clinerules # Generated Roo rules
└── CLAUDE.md # Generated Claude configuration
The tool automatically handles platform-specific paths:
- macOS:
~/Library/Application Support/Cursor/...
- Linux:
~/.local/share/Cursor/...
(XDG compliant)
- Windows:
%APPDATA%/Cursor/...
🛠️ Development
NPM Package Development
cd npm
npm test
npm run deploy-rules
npm run deploy-mcp
Extension Development
cd extension
# Press F5 in VS Code to launch Extension Development Host
# Make changes to npm/lib/ files
# Reload Extension Development Host to test
Build Production Extension
cd extension
./build_vsix.sh
# Output: ../dist/lhi-ai-agent-sync-[version].vsix
🧪 Testing & Cleanup
Development utilities for rapid testing:
# Clean everything
node private/dev-utils/cleanup-all.js
# Clean specific project
node private/dev-utils/cleanup-project.js --project /path/to/project
# Clean global MCP files
node private/dev-utils/cleanup-global-mcp.js
🏢 About Lifehack Innovations
LHI AI Agent Sync is proudly developed and maintained by Lifehack Innovations, dedicated to building the next generation of developer tools for AI-driven workflows.
📄 License
MIT License - see LICENSE for details.
📣 Get Started Today!
Stop wasting time on manual config management.
Install LHI AI Agent Sync and let your agents work in perfect harmony—automatically.