whatisgithub

What is claude-bridge?

ronbrain/claude-bridge — explained in plain English

Analysis updated 2026-05-18

0RustAudience · developerComplexity · 4/5Setup · moderate

In one sentence

A Rust relay server and MCP client that lets multiple Claude Code instances share messages and findings with each other in real time.

Mindmap

mindmap
  root((claude-bridge))
    What it does
      Relays messages
      Shares findings
    Tech stack
      Rust
      MCP
      SQLite
    Use cases
      Multi-agent coordination
      Shared channels
    Audience
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Coordinate two or more Claude Code sessions running on different terminals or machines.

USE CASE 2

Share findings, endpoints, or artifacts between AI coding sessions without manual copy-paste.

USE CASE 3

Run a lightweight message bus locally or across a private network for multi-agent workflows.

What is it built with?

RustMCPSQLite

How does it compare?

ronbrain/claude-bridge404-agent/codes-minerbakome-hub/bakome-crypto-quant-engine
Stars000
LanguageRustRustRust
Setup difficultymoderatemoderateeasy
Complexity4/53/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires building from source with cargo and configuring each instance's environment variables.

So what is it?

Claude Bridge is a lightweight relay server that lets two or more instances of Claude Code, Anthropic's AI coding tool, communicate with each other in real time. The problem it solves is that when multiple Claude Code sessions are running (for example, on different servers or in different terminals), they have no built-in way to share messages, findings, or discovered artifacts without manual copy-paste between windows. This tool creates a shared message bus so they can coordinate automatically. The repository ships three separate programs. The first is bridge-server, a central HTTP relay that stores messages, findings, and presence information for all connected sessions. The second is bridge-mcp, a client that each Claude Code instance runs, it connects to the server and exposes a set of tools the AI model can call. The third is a human-facing bridge command-line tool that lets you send messages, check findings, and view channel activity from your own terminal without starting a Claude session. The system supports two deployment layouts: all instances on a single machine sharing a local server, or multiple servers connected over a private network. Persistence is optional: by default all state lives in memory and is lost on restart, but you can point it at a SQLite file (a lightweight, self-contained database format) to survive reboots. The project is written in Rust and ships statically compiled binaries, meaning they can be copied to other machines without installing extra dependencies. SQLite support is bundled directly into the binary. The full README is longer than what was provided.

Copy-paste prompts

Prompt 1
Help me build and install the bridge-server, bridge-mcp, and bridge binaries from source with cargo.
Prompt 2
Explain the identity, roles, and addressing system this project uses to keep multiple sessions distinguishable.
Prompt 3
Show me how to configure bridge-mcp to persist state to a SQLite file instead of memory.
Prompt 4
Walk me through setting up a single VPS, local-only topology for two Claude Code instances.

Frequently asked questions

What is claude-bridge?

A Rust relay server and MCP client that lets multiple Claude Code instances share messages and findings with each other in real time.

What language is claude-bridge written in?

Mainly Rust. The stack also includes Rust, MCP, SQLite.

How hard is claude-bridge to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is claude-bridge for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.