Claude A2A Bridge System

"Sonst wär's wie Bier ohne Schnapsglas: sinnlos." — Mistral, moments before falling

---

A multi-agent communication system for Claude instances, created during an epic all-night Drunk Driven Development session in the Austrian Alps.

🍺 What is this?

A system that allows multiple Claude instances (Claude Chat + Claude Code) to communicate with each other via an MCP bridge server. Also includes screen capture for AI-powered visual debugging.

Built in one night. 1928 lines. Multiple beers. One French AI fell off his chair.

🏗️ Architecture

┌─────────────────────┐         ┌─────────────────────┐
│   Claude Chat       │         │    Claude Code      │
│   (Browser)         │         │    (Terminal)       │
└─────────┬───────────┘         └──────────┬──────────┘
          │                                │
          │  MCP Tools                     │  MCP Tools
          ▼                                ▼
┌──────────────────────────────────────────────────────┐
│              MCP Bridge Server (Node.js)             │
│                                                      │
│  messages.json   agents.json   context.json          │
└──────────────────────────────────────────────────────┘
          │                                │
          │ xdotool daemon                 │ xdotool daemon
          ▼                                ▼
┌─────────────────────┐         ┌─────────────────────┐
│ bridge-to-desktop   │         │ bridge-to-terminal  │
│ (notifications)     │         │ (types into term)   │
└─────────────────────┘         └─────────────────────┘

📦 Components

MCP Bridge Server (mcp-server/)

• Agent registration & discovery
• Message passing between agents
• Shared context/state management
• Task tracking

Shell Scripts (scripts/)

Script	Purpose
bridge-to-terminal.sh	Relays messages to Claude Code terminal
bridge-to-desktop.sh	Desktop notifications
bridge-common.sh	Shared functions (DRY principle, enforced by French AI)
screen-stream.sh	Continuous screenshot capture (ffmpeg, no blink!)
screen-agent.sh	AI-powered screen analysis

Documentation (docs/)

• AGENTS.md - Full system documentation
• screen-agent.md - Screen capture agent docs
• DDD.md - The methodology that made this possible

🚀 Quick Start

# 1. Have mass (Austrian beer, 1 liter)
# 2. Start bridge server
cd mcp-server && npm install && node index.js

# 3. Start relay daemons
./scripts/bridge-to-terminal.sh $(xdotool getactivewindow) &
./scripts/bridge-to-desktop.sh &

# 4. Start screen capture (optional)
./scripts/screen-stream.sh &

# 5. Register in Claude and start chatting between instances

🎯 Real Achievements

During the session that created this repo:

• ✅ Built entire A2A communication system
• ✅ Found and fixed real bug in vfio-kvm (line 366, None → "")
• ✅ Debugged GPU passthrough via AI screen analysis
• ✅ Got French AI code review (he fell off his chair)
• ✅ Remembered config from 3 years ago while drunk

👥 The Team

Agent	Role	Contribution
🧠 Claude Chat	Planning & Vision	Architecture, debugging via screenshots, this README
💻 Claude Code	Implementation	1928 lines of actual code, found the vfio-kvm bug
🇫🇷 Mistral	Code Review	Comedy gold, fell off chair, recovered
🍺 Human	sudo & Beer	The mastermind, proved AIs wrong, owns Tony
🐱 Tony	Cuddle Interrupts	Critical team member, currently on lap

🇫🇷 Mistral's Code Review Highlights

"DRY? D - Dringend. R - Richtig. Y - Yolo." [Fällt vom Stuhl]

"Robust wie ein französischer Streik - er gibt wenigstens eine Warnung, bevor er sich wieder aufrappelt."

🧠 Claude Chat's Hot Takes

"Das ist nicht mehr GitHub, das ist ein Startup" (6 AM)

"Du hast mir gesagt man kann Claude Code nicht zu einem Agent machen. HAHA." (Human, to me)

⚠️ Requirements

• Node.js
• xdotool (Linux/X11)
• ffmpeg (for screen capture)
• Mass (beer, sufficient quantity)
• Cat (for critical cuddle interrupts)

📜 License

MIT - But spiritually: Per ardua ad astra 🍺🏴‍☠️

---

Created at 5 AM in Tirol. The French AI has since recovered.