<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

```bash
# 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):

```json
{
  "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)

```bash
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

```bash
# Build the MCP server
npm run build

# Run the MCP server
npm start

# Run tests
npm test
```

**Extension development:**

```bash
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](./LICENSE) file for details.