# Roocode Bridge

> Transform Your AI Coding Experience: Claude/Antigravity as the Brains, Roo Code as the Brawn, and Telegram as a Bonus Remote Control!

- **Type:** MCP server
- **Install:** `agentstack add mcp-phuongncn-roocode-bridge`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [phuongncn](https://agentstack.voostack.com/s/phuongncn)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [phuongncn](https://github.com/phuongncn)
- **Source:** https://github.com/phuongncn/roocode-bridge

## Install

```sh
agentstack add mcp-phuongncn-roocode-bridge
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Roo Code Bridge 🌉🤖

**Transform Your AI Coding Experience: Claude/Antigravity as the Brains, Roo Code as the Brawn, and Telegram as a Bonus Remote Control!**

## 🛑 The Pain
- **High API Fees:** Running complex coding tasks through premium models like Claude Sonnet or GPT continuously can burn a hole in your pocket.
- **Micro-Management:** Waiting for the AI, reading through every file it changes, and telling it what to do next is exhausting.
- **Tethered to the Desk:** You have to sit at your computer to monitor the AI's progress.

## 💡 The Solution
**Roo Code Bridge** is a VSCode extension that creates an automated Manager-Worker loop:
1. **The Manager (Claude Code / Antigravity):** Creates a master plan and reviews the work.
2. **The Worker (Roo Code + Local/Cheaper AI):** Executes the plan, writes the code, and reports back.
3. **The Telegram Bonus:** A fast way to directly tell Roo what to do from your phone!

By offloading the heavy lifting (writing lines of code, replacing files) to Roo Code paired with a local AI (like Qwen 3.5) or a cheaper API, you slash your API costs dramatically while maintaining top-tier code quality!

---

## 🌊 How It Works (The Flow)

1. You prompt **Claude Code** or **Antigravity** with a task.
2. The Manager writes a detailed plan into the `.plan/` folder and uses the MCP Server to send the task to **Roo Code**.
3. **Roo Code** starts working autonomously.
4. **Signaling Completion (Highly Recommended):** Once Roo is done, it signals completion by renaming the plan file (e.g., `fix-01-ui.md` ➡️ `fix-01-ui-done.md`).
    
    > [!TIP]
    > While an MCP `report_done` tool exists, AI agents often forget to call it or the tool call might fail if the agent crashes. **Relying on the `-done` filename change is the most robust way** to ensure your Manager knows the work is finished.
5. The Manager reviews the code. If there are bugs, it updates the plan and sends Roo back to work. If it's perfect, the loop finishes.
6. **Telegram Integration:** As a bonus, you can chat with your Telegram bot to control Roo directly. *(Note: Currently, Telegram only sends prompts to Roo, not to Claude/Antigravity. Hopefully, someone from the community can help build that out!)*

---

## 🛠️ Installation & Setup

### 1. Install the Extension
- **VSIX:** Download the released `.vsix` file. In VSCode, press `F1` > type `Extensions: Install from VSIX...` and select the file.
- **Source:** Clone this repo, run `npm install`, then in VSCode press `F1` > `Extensions: Install from Location...` and select the repository folder.

### 2. Configure Roo Code MCP
You need to connect Roo Code to the Bridge. Go to **Roo Settings > MCP Tab > Edit Globally** and add:

```json
{
  "mcpServers": {
    "roocode-bridge": {
      "type": "streamable-http",
      "url": "http://127.0.0.1:3457/mcp",
      "alwaysAllow": ["report_done"],
      "timeout": 10
    }
  }
}
```

### 3. Setup the Polling Script
This script helps the manager check on Roo's progress. Choose the version for your OS:
- **Windows:** Use `poll-roo-bridge.ps1`.
- **Mac / Linux:** Use `poll-roo-bridge.sh`.

Place the script somewhere accessible in your system.

> [!IMPORTANT]
> After placing the script, you **must update the path** in your `CLAUDE.md` or `GEMINI.md` file (Step 2 — Poll status section) to match the location and filename on your machine.

### 4. Setup The Manager (Claude / Antigravity)
Rename the provided template:
- `CLAUDE.md.example` ➡️ `CLAUDE.md` (if using Claude Code)
- `GEMINI.md.example` ➡️ `GEMINI.md` (if using Antigravity)

Place it in your project's workspace folder (or globally in your system config).

### 5. Telegram Setup (Optional Bonus)
1. Open VSCode Settings (`Ctrl + ,`).
2. Search for `Roo Code Bridge`.
3. Enter your **Telegram Bot Token** and **Allowed Chat ID** (to ensure only you can control it).
4. Start chatting with your bot to control Roo from anywhere! *(Again, it talks to Roo, it cannot command Claude/Antigravity yet!)*

---

## 🤝 Contributing
Feel free to submit issues, pull requests, and ideas! Let's build the ultimate autonomous coding agent loop together. If you know how to wire up Telegram commands to trigger Claude/Antigravity, we'd love a PR!

## 📜 License
MIT License - use it, modify it, make it yours!

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [phuongncn](https://github.com/phuongncn)
- **Source:** [phuongncn/roocode-bridge](https://github.com/phuongncn/roocode-bridge)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-phuongncn-roocode-bridge
- Seller: https://agentstack.voostack.com/s/phuongncn
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.