Brain Bridge
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Brain Bridge search artifacts for 'API design'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
⨠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.jsonData 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 build2. 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 Code4. 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 all Antigravity conversations with summaries |
| List artifact files in a specific conversation |
| Read the full content of a conversation artifact |
| Full-text search across all artifacts |
| Write a note to the shared |
| Delegate a task to a new child conversation |
| Check the status and result of a delegated task |
| 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 testExtension development:
cd ext
# Watch mode (rebuild on changes)
npm run dev
# Package into .vsix
npm run packageš¤ Contributing
Fork the repository
Create your feature branch (
git checkout -b feature/amazing-feature)Commit your changes (
git commit -m 'Add amazing feature')Push to the branch (
git push origin feature/amazing-feature)Open a Pull Request
š License
This project is licensed under the MIT License ā see the LICENSE file for details.
Available Tools
8 toolscheck_task_resultA
Check the status and result of a delegated task. Returns the task description, current status, and result if completed.
Inputs: task_id (required).
delegate_taskA
Delegate a task to a new child conversation. Creates a pending task that the Brain Bridge Extension will automatically pick up and execute via a headless cascade. Use check_task_result to monitor progress.
Inputs: task (required), cwd.
list_artifactsA
List all artifact files in a specific conversation. Returns the markdown files with their sizes and metadata summaries.
Inputs: conversation_id (required).
list_conversationsA
List all Antigravity conversations with their summaries. Scans the brain directory for conversation folders and reads metadata to provide summaries.
Inputs: limit.
list_delegated_tasksB
List all delegated tasks and their current status. Optionally filter by status.
Inputs: status.
read_artifactA
Read the full content of a specific artifact file from a conversation.
Inputs: filename (required), conversation_id (required).
search_artifactsA
Full-text search across artifact files. Searches all conversations or a specific one. Returns matching lines with context.
Inputs: query (required), conversation_id.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogā¦
TDQS
Scored across 8 tools
Each tool targets a distinct resource and action: conversations, artifacts, shared notes, and delegated tasks. No two tools overlap in purpose, making selection unambiguous.
All tools follow a consistent verb_noun pattern (e.g., list_conversations, read_artifact, delegate_task). This predictability aids agent comprehension and selection.
With 8 tools, the server is well-scoped. It covers the core domains (conversations, artifacts, notes, tasks) without unnecessary bloat or sparse coverage.
The tool set covers list/read/search for artifacts and task delegation, but lacks conversation detail reading, artifact writing, shared note reading, and task cancellation. These gaps create potential dead ends (e.g., writing a note with no way to read it).
Related MCP Connectors
An MCP memory server. One memory your agents share ā across models, devices and apps.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
LLM Orchestration Agent (Mcp)
MCP server for building and testing AI agents with multi-model experimentation and insights.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceMCP server that dynamically extracts and manages user memory from LLM conversations, enabling consistent personalization across different models.7-
- AlicenseNot gradedqualityBmaintenanceMCP server for multi-agent collaboration enabling AI agents to communicate, delegate tasks, and share artifacts across clients and machines with federation support.13 npm1MIT
- FlicenseNot gradedqualityDmaintenanceMCP server orchestrating local multi-agent workflows with gated lifecycle, handoff events, and host-level continuation.-
- AlicenseNot gradedqualityDmaintenanceMulti-AI collaboration MCP server enabling message passing, code review workflows, shared todo lists, and agent management with authentication and role-based access.31 npmMIT