IDE Sync - VSCode-JetBrains IDE Sync

A decentralized synchronization system based on multicast technology that enables seamless real-time synchronization between multiple VSCode, JetBrains IDE instances simultaneously. Compatible with VSCode forks (Cursor, Windsurf) and JetBrains IntelliJ-based IDEs (Rider, IntelliJ IDEA, WebStorm, PyCharm, etc.). No central server required - all IDEs communicate directly with each other in a peer-to-peer fashion.

---

What's New / 最新更新

v1.5.x

New Features / 新功能:

• 📁 Workspace Path Sync / 工作空间路径同步: Synchronizes workspace/project paths between IDEs for better context awareness. / 在 IDE 之间同步工作空间/项目路径，提供更好的上下文感知能力。

Bug Fixes / 问题修复:

• 🔧 Fixed JetBrains → VSCode multicast sync / 修复 JetBrains → VSCode 组播同步: VSCode now correctly receives multicast messages from JetBrains by binding to all interfaces. / VSCode 现在通过绑定到所有接口来正确接收来自 JetBrains 的组播消息。

Improvements / 改进:

• ⚡ Multicast Manager Optimization / 组播管理器优化: Improved multicast implementation for better reliability. / 改进组播实现以提高可靠性。
• 🔄 Dependencies Update / 依赖更新: Updated VSCode extension dependencies and JetBrains plugin configuration. / 更新了 VSCode 扩展依赖和 JetBrains 插件配置。

---

Key Features

• 🔄 Decentralized Architecture: No central server - direct peer-to-peer communication via multicast
• 📂 File Operations Sync: Real-time file opening and closing synchronization across all connected IDEs
• 🎯 Cursor & Selection Sync: Live cursor position and code selection synchronization with precise line/column accuracy
• 🔄 Focus Compensation: Full workspace synchronization when window loses focus, ensuring other IDEs receive the latest state
• 📁 Workspace Path Sync: Synchronizes workspace/project paths between IDEs for better context awareness
• 🔗 Multi-Instance Support: Connect unlimited VSCode and JetBrains IDE instances simultaneously
• ⚡ Zero Configuration: Automatic discovery and connection of IDE instances on the same network, with seamless departure from the network

Installation

VSCode Extension

1. Visit GitHub Releases
2. Download the latest .vsix file for VSCode
3. Open VSCode and press Ctrl+Shift+P
4. Type "Extensions: Install from VSIX..." and select it
5. Choose the downloaded .vsix file
6. Restart VSCode

JetBrains IDE Plugin

1. Visit GitHub Releases
2. Download the latest .zip file for JetBrains IDE
3. Open JetBrains IDE and go to Settings > Plugins
4. Click the gear icon and select "Install Plugin from Disk..."
5. Choose the downloaded .zip file
6. Restart JetBrains IDE

Configuration

Zero-configuration setup with automatic network discovery. Optional customization:

• Multicast Port: Set custom port for group identification (default: 3000)
• Auto-sync Activation: Synchronization starts automatically when IDE launches, configurable via checkbox

Access settings:

• VSCode: Settings > Extensions > IDE Sync - Connect to JetBrains IDE
• JetBrains IDE: Settings > Tools > IDE Sync - Connect to VSCode

Usage

1. Install: Add plugin to your VSCode and/or JetBrains IDEs
2. Start: Launch IDEs
3. Control Sync: Use the sync toggle button to enable/disable synchronization:
   • "Turn IDE Sync On" - Click when sync is disabled to enable synchronization
   • "IDE Sync On" - Displayed when sync is enabled and active
4. Verify: Check status bar indicator for connection status
5. Code: File operations, cursor movements, and text selections sync automatically
6. Focus: Window blur events trigger full workspace sync to other IDEs

Troubleshooting

Error Log Locations

When experiencing synchronization issues, check the error logs in the following locations:

VSCode Extension Logs

• Output Panel: View > Output, then select "IDE 同步" from the dropdown

JetBrains IDE Plugin Logs

• IDE Built-in Log Viewer:
  • Go to Help > Show Log in Explorer/Finder/Files
  • Open idea.log file

Building

Components

VSCode Extension

• Located in /vscode-extension
• Supported versions: VSCode 1.84.0 and newer
• Compatible with VSCode forks: Cursor, Windsurf, etc.

JetBrains IDE Plugin

• Located in /jetbrains-plugin
• Supported versions: 2023.3 and newer
• Compatible IDEs: IntelliJ IDEA, WebStorm, Rider, PyCharm, etc.

Prerequisites

• Node.js and npm for VSCode extension
• JDK 17+ and Gradle for JetBrains IDE plugin

Build Steps

1. Clone the repository

git clone https://github.com/ileeoyo/IDESync-VSCode-JetBrains.git
cd IDESync-VSCode-JetBrains

2. Build VSCode extension

cd vscode-extension
npm install
npm run build
npm run package
cd ..

3. Build JetBrains plugin

cd jetbrains-plugin
./gradlew buildPlugin
cd ..

Feedback & Issues

Please report issues or suggestions on GitHub.