Python Debug Config Sync

A VS Code extension that enables bidirectional synchronization of Python debug configurations between VS Code and IntelliJ IDEA/PyCharm.

Features

• Bidirectional Sync: Transfer configurations in both directions
• Smart Merging: Preserves existing configurations while intelligently adding new ones
• Multiple Sources: Supports both persistent run configurations and workspace-specific settings
• Safe Operations: Never overwrites existing configurations without explicit merging logic

Installation

Install from the VS Code Marketplace or via command line:

code --install-extension ChristianPojoni.python-debug-sync

Usage

Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and choose:

• Sync Python Debug Configs to IntelliJ - Export VS Code configurations to IntelliJ
• Sync Python Debug Configs from IntelliJ - Import IntelliJ configurations to VS Code

VS Code to IntelliJ Sync

Converts your VS Code launch.json configurations into IntelliJ run configurations.

• Reads .vscode/launch.json file
• Converts Python debug configurations (debugpy and python types)
• Generates XML files in .idea/runConfigurations/
• Preserves script paths, module names, arguments, and environment variables

Example configuration:

{
    "configurations": [
        {
            "name": "Run Main Script",
            "type": "debugpy",
            "request": "launch",
            "program": "${workspaceFolder}/main.py",
            "args": ["--verbose", "--config=dev"],
            "env": {"DEBUG": "1"}
        }
    ]
}

IntelliJ to VS Code Sync

Imports IntelliJ run configurations into your VS Code setup with intelligent merging.

Sources supported:

• Persistent configurations: .idea/runConfigurations/*.xml (shared with team)
• Workspace configurations: .idea/workspace.xml (local to developer)

Smart merging behavior:

• Preserves existing VS Code configurations that don't conflict
• Updates configurations with matching names while keeping VS Code-specific properties
• Adds new configurations from IntelliJ
• Maintains proper JSON formatting

Configuration Types Supported

Requirements

• VS Code 1.60.0 or higher
• For VS Code to IntelliJ: Existing .vscode/launch.json with Python configurations
• For IntelliJ to VS Code: IntelliJ project with .idea/ folder

Development

Setup

git clone <repository-url>
cd python-vscode-intellij-sync
npm install

Building

# Development build with watch mode
npm run watch

# Production build
npm run bundle

# Run tests
npm test

Packaging

npm run package

This generates build/launch.json-vscode.vsix which can be installed locally or published to the marketplace.

Architecture

src/
├── extension.ts          # Main extension entry point
├── types.ts             # TypeScript interfaces
├── intellijParser.ts    # IntelliJ XML configuration parser
├── launchJsonGenerator.ts # VS Code launch.json generator
├── xmlGenerator.ts      # IntelliJ XML configuration generator
├── workspaceParser.ts   # IntelliJ workspace.xml parser
└── test/               # Test suites

Contributing

Contributions are welcome! Please submit a Pull Request or open an issue for major changes.

License

This project is licensed under the MIT License - see the LICENSE file for details.