Brain Bridge

✨ 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

Related MCP server: kitty-hive

🏗️ 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

🛠️ 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.