Claude IDE Bridge — Open Source

#
SHIP CODE
FROM YOUR
PHONE.

Your laptop stays home, plugged in, IDE open. You're on the couch, at a café, on a train — telling Claude to fix tests, push code, and open PRs from your phone. 115+ MCP tools. Full IDE control. Zero presence required.

View on GitHub → How it works
115+
MCP Tools
4+
IDEs Supported
347
Tests Passing
How It Works

## Three pieces.
One remote workflow.

📱
Your Phone
Claude mobile app
or SSH terminal
(Termius, iSH, etc.)
↔ Internet / SSH
⚙️
Bridge Server
MCP over WebSocket
115+ tools
runs on your machine
↔ WebSocket
💻
Your IDE
Windsurf, Cursor,
VS Code, Codex
+ companion extension

The bridge is a Node.js MCP server that sits between Claude Code and your IDE. A companion VS Code extension pushes real-time diagnostics, selections, terminal output, and LSP data to the bridge. Claude connects through Remote Control (scan a QR code from the Claude app) or via SSH.

You type "fix the failing tests" on your phone. Claude scans diagnostics, reads the file, writes the fix, runs the test suite, commits, pushes, opens a PR, and watches CI pass — all while you're watching TV.

Real Scenarios

## Your laptop is home.
You're already shipping.

On the couch
"Fix the failing tests"
Claude scans getDiagnostics, finds the TypeScript error, reads the file with goToDefinition, writes the fix with editText, runs runTests — 8/8 pass. Then gitCommit + gitPush + githubCreatePR. You never left the couch.
getDiagnostics → goToDefinition → editText → runTests → gitCommit → githubCreatePR
On a train
"Debug that auth crash"
Claude sets a conditional breakpoint on the auth middleware, launches the debugger, evaluates expressions at the breakpoint, finds the null reference, fixes it, runs the full suite. PR opened before your stop.
setDebugBreakpoints → startDebugSession → evaluateInDebugger → editText → runTests
At a café
"Refactor the payment module"
Claude creates a workspace snapshot first (safety net), then uses getCallHierarchy and findReferences to understand the dependency graph. Renames symbols, moves functions, runs linter + tests. If anything breaks — one-command rollback.
createSnapshot → getCallHierarchy → findReferences → renameSymbol → runLinter → runTests
Walking the dog
"Check CI and fix lint"
Claude checks githubListRuns — CI failed on lint. Reads the logs with githubGetRunLogs, runs fixAllLintErrors locally, verifies with runLinter, pushes the fix. CI goes green.
githubListRuns → githubGetRunLogs → fixAllLintErrors → runLinter → gitCommit → gitPush
What Claude Can Do In Your IDE

## 115+ tools.
All remote.

💻
Full IDE Control
Open files, navigate to lines, edit code, save, close tabs, view diffs. Claude operates your IDE like a developer sitting at the desk.
openFile, editText, replaceBlock, saveDocument, openDiff, closeTabs
UNIQUE
🐛
Live Debugger
Set conditional breakpoints, start debug sessions, evaluate expressions, inspect variables, step through code. No other AI tool touches the actual debugger.
setDebugBreakpoints, startDebugSession, evaluateInDebugger
🛠️
Deep LSP Intelligence
Go-to-definition, find references, call hierarchy, type hierarchy, hover info, code actions, rename symbol. The depth of a senior dev walkthrough.
goToDefinition, findReferences, getCallHierarchy, renameSymbol, getCodeActions
UNIQUE
📸
Workspace Snapshots
Named checkpoints before risky changes. Instant diff against current state. One-command rollback. Your safety net for every refactor.
createSnapshot, listSnapshots, diffSnapshot, restoreSnapshot
🚀
Git + GitHub + CI
Full loop: commit, push, create PR, list runs, read CI logs, post PR reviews, manage issues. 15 git tools + 11 GitHub tools.
gitCommit, gitPush, githubCreatePR, githubListRuns, githubPostPRReview
UNIQUE
💻
Terminal Orchestration
Spawn terminals, fire commands, wait for output patterns, read logs. Full process control on your home machine — from your phone.
sendTerminalCommand, waitForTerminalOutput, runInTerminal, listTerminals
✅
Integrated Testing
Auto-detects Vitest, Jest, Pytest, Cargo test, Go test. Runs tests, parses results, correlates failures with diagnostics. Structured output.
runTests (vitest, jest, pytest, cargo, go)
🔎
Polyglot Linting
Auto-detects your stack. TypeScript gets tsc + biome. Python gets ruff. Runs linters, auto-fixes, formats — all in one remote pass.
runLinter, fixAllLintErrors, formatDocument, organizeImports
UNIQUE
💬
AI Comment Directives
Drop `// AI: FIX:` anywhere before you leave. Claude finds them, prioritizes them, turns them into tracked GitHub issues.
getAIComments, createGithubIssueFromAIComment
Live Workflow

## You say "fix the tests."
Here's what happens.

01
Scan diagnostics
getDiagnostics → TypeScript error found
runs on your home machine
02
Trace the type
goToDefinition + findReferences
IDE LSP responds via bridge
03
Apply the fix
editText → save: true
file changes in your editor
04
Run tests
runTests → 8/8 passed
vitest runs in IDE terminal
05
Ship it
gitCommit + gitPush + githubCreatePR
PR opened on GitHub
06
CI passes
githubListRuns → conclusion: success
you're still on the couch
claude-ide-bridge — remote session
Tool Inventory

## Every tool.
At a glance.

7
File Operations
openFile, openDiff, saveDocument, closeTabs, closeAllDiffTabs, checkDocumentDirty, getOpenEditors
12
Search & LSP
searchWorkspace, findFiles, getFileTree, getDiagnostics, goToDefinition, findReferences, getHover, getCodeActions, applyCodeAction, renameSymbol, searchSymbols, getDocumentSymbols
6
Advanced LSP
getCallHierarchy, getTypeHierarchy, getInlayHints, getHoverAtCursor, getCurrentSelection, getLatestSelection
15
Git
getGitStatus, getGitDiff, getGitLog, gitCommit, gitPush, gitPull, gitFetch, gitCheckout, gitListBranches, gitStash, gitStashPop, gitStashList, gitHistory, editText, replaceBlock
11
GitHub
githubCreatePR, githubListPRs, githubViewPR, githubGetPRDiff, githubPostPRReview, githubListRuns, githubGetRunLogs, githubListIssues, githubGetIssue, githubCreateIssue, githubCommentIssue
8
Terminal
sendTerminalCommand, waitForTerminalOutput, runInTerminal, listTerminals, getTerminalOutput, disposeTerminal, runCommand, runTests
7
Lint & Format
runLinter, fixAllLintErrors, formatFile, formatDocument, organizeImports, diffDebugger, searchAndReplace
12
Workspace & Debug
createSnapshot, listSnapshots, diffSnapshot, restoreSnapshot, setDebugBreakpoints, startDebugSession, evaluateInDebugger, getAIComments, watchFiles, unwatchFiles, decorations, workspaceSettings
Comparison

## They need you
at your desk.

Capability | Claude IDE Bridge | Cursor | Copilot | Aider
--- | --- | --- | --- | ---
Control IDE from phone | ✔ via Remote Control | ✕ | ✕ | ✕
Multi-IDE support (Windsurf, Cursor, VS Code) | ✔ All of them | Cursor only | VS Code only | CLI only
Full Git → PR → CI loop | ✔ 26 tools | ✕ | ✕ | partial
Programmatic debugger | ✔ | ✕ | ✕ | ✕
Terminal orchestration | ✔ 8 tools | ✕ | ✕ | ✕
Workspace snapshots + rollback | ✔ | ✕ | ✕ | ✕
Integrated test runner (5 frameworks) | ✔ | partial | ✕ | partial
Total MCP tools | ✔ 115+ | ~20 | ~15 | ~10

Get Started

## 5 minutes
to remote IDE.

1
Install the bridge
git clone <repo>
cd claude-ide-bridge
npm install && npm run build
Node.js 18+ required. Runs on macOS and Linux.
2
Install the extension
cd vscode-extension
npm install && npm run build
npm run package
code --install-extension *.vsix
Works with VS Code, Windsurf, Cursor. Extension auto-connects to bridge.
3
Start everything
npm run start-all -- --workspace .
# Scan the QR code with Claude app
# Or SSH in and run: claude
Launches bridge + Claude CLI + Remote Control in a tmux session. Health monitoring auto-restarts on failure.

## LAPTOP HOME.
YOU SHIP.

Windsurf. Cursor. VS Code. Google Antigravity. 115+ tools. Full remote. No desk required.

View on GitHub → Read the docs