LHI AI Agent Sync

# 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

Cross-Platform Paths

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.

Patrick Watson