ide-bridge 0.2.0

Bridge IDE refactoring capabilities to AI coding tools

IDE Bridge

Bridge IDE refactoring capabilities to AI coding tools

IDE Bridge exposes your IDE's semantic operations (rename, find references, go to definition) to AI coding assistants like Claude Code, enabling accurate refactoring without text-based search/replace.

Why?

Operation	Without IDE Bridge	With IDE Bridge
Rename variable	grep + sed (breaks strings/comments)	Semantic rename (100% accurate)
Find references	Text search (false positives)	Actual code references only
Go to definition	Search for "def X" (misses re-exports)	Exact definition location

Quick Start

Plugin-First Installation (Recommended)

1. Install the IDE Bridge extension from VS Code Marketplace
2. The extension will guide you through Claude Code integration
3. Done! Claude Code now has access to IDE refactoring tools

Manual Installation

# Install Python package
pip install ide-bridge

# Register with Claude Code
ide-bridge mcp install

# Verify connection
ide-bridge status

Usage

CLI

# Rename a symbol
ide-bridge rename symbol src/main.py 42 10 newName

# Find all references
ide-bridge refs find src/main.py 42 10

# Go to definition
ide-bridge definition find src/main.py 42 10

With Claude Code

Once installed, Claude Code automatically discovers IDE Bridge tools:

User: Rename the getUserById function to fetchUser

Claude: I'll use the IDE's rename functionality to safely rename this.
[Uses ide_rename_symbol]
Done! Renamed in 4 files.

Architecture

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│ Claude Code │────▶│ IDE Bridge  │────▶│   VSCode    │
│   (MCP)     │     │  (Sidecar)  │     │ (Extension) │
└─────────────┘     └─────────────┘     └─────────────┘

• MCP Server: Primary integration for Claude Code
• CLI: Universal access for any AI tool
• WebSocket: Low-latency communication with IDE

Documentation

Document	Description
ARCHITECTURE.md	System design
IMPLEMENTATION_GUIDE.md	Build guide
USAGE_GUIDE.md	Usage examples
TECHNOLOGY_DECISIONS.md	Tech stack rationale

Development

# Clone
git clone https://github.com/GvsSriRam/Claude_IDE_Bridge
cd Claude_IDE_Bridge

# Install Python dependencies
uv sync --all-extras --dev

# Install VSCode extension dependencies
cd packages/adapters/vscode && npm install && npm run build
cd ../../..

# Run tests
uv run pytest

# Type check
uv run mypy packages/ide-bridge/src

# Lint
uv run ruff check .

Project Structure

ide-bridge/
├── packages/
│   ├── ide-bridge/        # Single Python package
│   │   ├── src/ide_bridge/
│   │   │   ├── core/      # Models, protocols, engine
│   │   │   ├── cli/       # CLI interface (Typer)
│   │   │   ├── mcp/       # MCP server (FastMCP)
│   │   │   ├── providers/ # IDE providers (VSCode, etc.)
│   │   │   └── transports/ # Communication (WebSocket)
│   │   └── tests/
│   └── adapters/
│       └── vscode/        # VSCode extension (TypeScript)
└── docs/                  # Documentation

License

MIT