Syncbridge MCP

Syncbridge

*You're 30 messages deep with Claude. The plan is solid. Now you need to build it

in your editor. So you copy. You paste. You lose half the context. Your editor

doesn't know what Claude knows. And next time you go back to Claude, it doesn't

know what your editor did.*

*Syncbridge fixes this — automatically, for free, no CLI required.*

---

The Problem

Every developer using AI chat faces the same daily toil:

• AI gives a long response with 5 code blocks — you copy block 1, switch to your editor, paste, switch back, scroll to find block 2, copy, switch, paste, repeat
• You make a change in your editor — you want AI feedback — you copy the code, switch to browser, paste, ask the question
• Your chat gets too long — you start a new one — and re-explain your entire project from scratch
• You use ChatGPT for one thing and Claude for another — context never carries over
• You ask Claude for the plan and Cursor to build it — they never know what the other did
• You use Cursor — it can send terminal output to its own AI chat, but there's no way to send AI chat responses back to your terminal automatically
• You use Copilot or Windsurf — there's no bridge at all between their AI and your browser-based AI chats

This is the copy-paste tax. It compounds every single day.

Syncbridge eliminates it.

*Built independently to solve a daily frustration. Turns out even well-funded teams

with dedicated AI editors only solved half this problem. Syncbridge solves both directions

— and works with every AI site, not just one editor's built-in chat.*

---

Who is this for

You don't need a CLI. You don't need a paid subscription. You just need a browser.

Free forever. No API key. No subscription. No CLI required.

---

Quick Start

Path A — Chrome extension only (no CLI needed)

1. Clone or download this repo
2. Go to chrome://extensions → enable Developer mode → Load unpacked → select chrome-extension/ folder
3. Go to any supported AI site — ask something — response auto-copies to clipboard
4. Press Alt+V on any other AI site to inject it

That's it. No VS Code extension needed. No CLI. No setup.

Chrome Web Store version coming soon.

Path B — Full sync (Chrome + VS Code + CLI)

1. Install VS Code extension: search "Syncbridge" in Extensions panel
2. Load Chrome extension (same as Path A step 2)
3. Press Ctrl+Shift+A (Mac: Cmd+Shift+A) → select your project folder
4. Press Ctrl+Shift+E (Mac: Cmd+Shift+E) → deploy file watcher hook
5. Press Ctrl+Shift+S (Mac: Cmd+Shift+S) → open Syncbridge panel
6. Run claude (or your CLI) from your project folder in terminal

You're ready. Ask your AI something — Syncbridge handles the rest.

---

What it does

Syncbridge works in two independent layers — use one or both:

Chrome extension only — works for everyone, no CLI needed:

• Auto-copies AI response to clipboard when it finishes
• Alt+C to manually copy, Alt+V to inject into any AI input
• Switch context between Claude, ChatGPT, Gemini, Grok, Mistral, Perplexity, Copilot with one keystroke
• Green toast confirms copy even when widget is hidden

VS Code extension + Chrome extension — full bidirectional sync:

• AI response auto-copied → one keystroke sends to your CLI instructions file
• CLI runs tasks → VS Code panel shows every action live
• Context migration rebuilds your session for a fresh chat

Supported AI chat interfaces (Chrome extension):

• Claude.ai
• ChatGPT
• Google Gemini
• Perplexity
• Grok (x.ai)
• Mistral
• Microsoft Copilot

Supported coding CLIs (VS Code extension):

• Claude Code (full auto-sync with hooks)
• Cursor
• GitHub Copilot CLI
• Windsurf
• Aider
• Custom (user-defined file names)

---

Screenshots

The Problem — Manual copy-paste between AI and CLI

The Solution — Syncbridge auto-copies AI responses

Two Modes — Floating widget and hidden mode with toast notification

Hidden Mode — Green toast confirms auto-copy when widget is hidden

Live CLI State — VS Code panel updates in real time as CLI runs

---

How it works

AI → CLI — Ask your AI something. Chrome extension auto-copies the response when it finishes. Press Ctrl+Shift+X (Mac: Cmd+Shift+X) in VS Code to write it to your instructions file. Run /sync in Claude Code CLI to execute.

CLI → AI — Claude Code CLI runs tasks and the hook auto-updates claude-state.md after every file write and bash command. The VS Code panel shows these updates live. Copy the state and paste into any AI chat to resume with full context.

Context migration — When your chat gets long, click ⟳ Regenerate in the Syncbridge panel. It merges your last instructions and last 10 CLI actions into a structured migration prompt. Paste into a new chat — the AI picks up exactly where you left off.

---

Architecture

• VS Code extension — sidebar panel, file watcher, status bar, clipboard bridge, project hook deployment
• Chrome extension — floating widget UI, site adapters for each AI platform, auto-copy on response complete
• MCP server — optional Claude Code CLI integration via MCP tools

---

Installation

VS Code Extension

From Marketplace: Search "Syncbridge" in the Extensions panel and click Install.

From .vsix file:

code --install-extension syncbridge-0.1.0.vsix

Chrome Extension

Developer mode (available now):

1. Download or clone this repo
2. Go to chrome://extensions
3. Enable Developer mode
4. Click Load unpacked → select chrome-extension/ folder

Chrome Web Store: Under review — available soon.

MCP Server (Claude Code CLI)

claude mcp add syncbridge npx syncbridge-mcp

Available MCP tools:

• update_state — push CLI state to Syncbridge
• read_instructions — pull latest AI instructions
• get_context — get full merged context
• clear_state — reset state for a new session

---

VS Code Extension

Commands

Panel UI

Opens in VS Code's second column. Displays live contents of all three control files with:

• Copy button per file
• ⟳ Regenerate context.md — rebuilds migration prompt from current state
• ⚠ Clear all control files — resets all three files

The panel auto-refreshes whenever the state file changes on disk.

Status Bar

Shows last CLI action in the status bar. Click to open Claude.ai usage page. Updates automatically when claude-state.md changes — no manual reload needed.

activeCli Setting

Syncbridge adapts control file names based on which CLI you use.

Go to VS Code Settings → search "syncbridge" → set Active CLI:

Non-Claude Code CLIs show an amber banner in the panel — state file must be updated manually for those CLIs.

---

Chrome Extension

Features

• Slim right-edge floating widget — hover to expand, click tab to pin open
• Draggable vertically along the right edge
• X button on hover removes widget from page — runs silently in background
• Toolbar popup to show/hide floating widget from Chrome extensions bar
• Auto-copies AI response to clipboard when response finishes (one copy per response)
• Green toast notification confirms auto-copy — visible even when widget is hidden
• Site adapters with per-site selectors for reading output and injecting input

Supported Sites

Claude.ai · ChatGPT · Google Gemini · Perplexity · Grok · Mistral · Microsoft Copilot

---

Keyboard Shortcuts

To remap VS Code shortcuts:

• Edit contributes.keybindings in package.json, recompile and reinstall
• Or use VS Code built-in editor: Ctrl+K Ctrl+S (Mac: Cmd+K Cmd+S)

To remap Chrome shortcuts: Edit the keydown listener in chrome-extension/src/bot.js then reload at chrome://extensions.

---

Control Files

All three files are created automatically in the workspace root on first activation. File names adapt based on your activeCli setting (see above).

---

Context Migration

Use when your chat gets too long or context drifts.

Steps:

1. Click ⟳ Regenerate context.md in the Syncbridge panel
2. Merges last instructions + last 10 CLI actions into a structured prompt
3. Copy claude-context.md contents
4. Paste into a new chat — AI resumes exactly where you left off

When to use:

• Chat responses are drifting or lo