Brain Bridge

<p align="center"> <h1 align="center">🧠 Brain Bridge</h1> <p align="center"> <strong>Multi-conversation collaboration for <a href="https://github.com/google-deepmind/antigravity">Antigravity</a></strong> </p> <p align="center"> An MCP Server + VS Code Extension that enables cross-conversation memory, task delegation, and parallel workflow orchestration. </p> <p align="center"> <a href="./README_CN.md">📖 中文文档</a> • <a href="#quick-start">Quick Start</a> • <a href="#mcp-tools-reference">MCP Tools</a> • <a href="#license">License</a> </p> </p>

---

✨ Features

🔌 MCP Server

• Cross-conversation artifact access — Read, list, and search artifacts across all Antigravity conversations
• Shared notes — Write notes accessible by any conversation (_shared/ directory)
• Task delegation — Spawn headless child conversations to parallelize complex work
• Task monitoring — Check status, results, and manage delegated sub-tasks

🖥️ VS Code Extension

• Sidebar UI — Dedicated activity bar panel with three views:
  • 📋 Delegated Tasks — Real-time task status with inline actions (check result, focus, cancel)
  • 💬 Conversations — Browse all Antigravity conversations and their artifacts
  • 📝 Shared Notes — View notes written by any conversation
• One-click delegation — Delegate tasks from the command palette or status bar
• Auto-refresh — Tasks update automatically every 5 seconds
• File watcher — Instant pickup of MCP-delegated tasks

🏗️ Architecture

brain-bridge/
├── src/                    # MCP Server (TypeScript)
│   └── index.ts            # Server with 8 MCP tools
├── ext/                    # VS Code Extension
│   └── src/
│       ├── extension.ts        # Extension entry point
│       ├── task-delegation.ts  # Task delegation manager
│       └── task-tree-provider.ts # TreeView data providers
├── .agents/                # Agent skills
│   └── skills/parallel-delegation/
├── test/                   # Test suite
└── package.json

Data directory: ~/.gemini/antigravity/brain/

• <uuid>/ — Conversation artifacts (task.md, implementation_plan.md, etc.)
• _shared/ — Cross-conversation shared notes
• _tasks/ — Delegated task state files

🚀 Quick Start

Prerequisites

• Node.js ≥ 18
• Antigravity (or any MCP-compatible IDE)

1. Install the MCP Server

# Clone the repository
git clone https://github.com/0xlicy/antigravity-brain-bridge.git
cd antigravity-brain-bridge

# Install dependencies & build
npm install
npm run build

2. Configure MCP

Add the following to your MCP client configuration (e.g., Antigravity settings):

{
  "mcpServers": {
    "brain-bridge": {
      "command": "node",
      "args": ["/absolute/path/to/antigravity-brain-bridge/dist/index.js"]
    }
  }
}

Tip: Replace /absolute/path/to/ with the actual path where you cloned the repo.

3. Install the VS Code Extension (Optional)

cd ext

# Install dependencies & build
npm install
npm run build

# Package and install
npm run package
# Then install the generated .vsix file in Antigravity / VS Code

4. Verify

Once configured, you can use the MCP tools in any conversation:

# List all conversations
→ list_conversations

# Search across all artifacts
→ search_artifacts(query: "authentication")

# Delegate a task to a child conversation
→ delegate_task(task: "Write unit tests for the auth module")

📖 MCP Tools Reference

Tool	Description
list_conversations	List all Antigravity conversations with summaries
list_artifacts	List artifact files in a specific conversation
read_artifact	Read the full content of a conversation artifact
search_artifacts	Full-text search across all artifacts
write_shared_note	Write a note to the shared _shared/ directory
delegate_task	Delegate a task to a new child conversation
check_task_result	Check the status and result of a delegated task
list_delegated_tasks	List all delegated tasks with optional status filter

🛠️ Development

# Build the MCP server
npm run build

# Run the MCP server
npm start

# Run tests
npm test

Extension development:

cd ext

# Watch mode (rebuild on changes)
npm run dev

# Package into .vsix
npm run package

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.