Content
<div align="center">
# 🤖 roo-code-configs
### The free, open-source library of Roo-Code Custom Modes, MCP setups & agentic workflow configs
[](https://opensource.org/licenses/MIT)
[](https://github.com/DiegoGuti2115)
[](https://x.com/guti10_FT)
[](https://github.com/DiegoGuti2115/roo-code-configs/stargazers)
**Everything I learn about Roo-Code — shared openly, tested on real projects, updated weekly.**
[Custom Modes](#-custom-modes) · [MCP Setups](#-mcp-server-setups) · [Model Benchmarks](#-model-benchmarks) · [How to use](#-how-to-use) · [Contributing](#-contributing)
</div>
---
## 🧠 What is this?
[Roo-Code](https://github.com/RooVetGit/Roo-Code) is an open-source, BYOK AI agent for VS Code that executes terminal commands, reads/writes files, and supports custom modes and MCP (Model Context Protocol). It's the most powerful AI coding tool most developers have never heard of.
This repo is the community resource I wished existed when I started. Every config here is:
- ✅ **Tested** on real projects, not just demos
- ✅ **Free** — MIT license, use anything however you want
- ✅ **Explained** — every file includes a rationale, not just raw config
- ✅ **Updated** as Roo-Code evolves
> ⭐ **Star this repo** so you can find it again when you need it.
---
## 🎭 Custom Modes
Custom Modes let you give Roo-Code a specialised identity with its own system prompt, allowed tools, and behaviour rules. Think of them as "roles" for your AI agent.
### Available modes
| Mode | Purpose | Difficulty |
|---|---|---|
| [`security-auditor`](./custom-modes/security-auditor.md) | OWASP Top 10 auto-checker on every file touched | ⭐⭐⭐ |
| [`docs-writer`](./custom-modes/docs-writer.md) | Auto-generates README, JSDoc & inline comments | ⭐⭐ |
| [`architect-reviewer`](./custom-modes/architect-reviewer.md) | System design critique & refactor suggestions | ⭐⭐⭐ |
| [`test-engineer`](./custom-modes/test-engineer.md) | Writes unit + integration tests for existing code | ⭐⭐ |
| [`migration-agent`](./custom-modes/migration-agent.md) | Handles JS→TS, v1→v2 API, framework migrations | ⭐⭐⭐ |
> 🚧 More modes added weekly. Watch this repo to get notified.
### How to install a Custom Mode
1. Open Roo-Code in VS Code
2. Click the **mode selector** dropdown (top of the Roo panel)
3. Select **"Edit Modes"**
4. Paste the contents of the `.md` file you want into a new mode entry
5. Save and select your new mode
---
## 🔌 MCP Server Setups
MCP (Model Context Protocol) lets Roo-Code connect to external data sources and tools, making it context-aware beyond just your codebase.
### Available setups
| Setup | What it enables | MCP Server |
|---|---|---|
| [`postgres-mcp`](./mcp-setups/postgres-mcp.md) | Schema-aware coding, auto-migrations, ORM generation | `@modelcontextprotocol/server-postgres` |
| [`github-mcp`](./mcp-setups/github-mcp.md) | Issue → code → PR full automation | `@modelcontextprotocol/server-github` |
| [`filesystem-mcp`](./mcp-setups/filesystem-mcp.md) | Safe multi-directory file operations | `@modelcontextprotocol/server-filesystem` |
| [`notion-mcp`](./mcp-setups/notion-mcp.md) | Read/write Notion docs from inside Roo | `@modelcontextprotocol/server-notion` |
### Quick MCP config template
Add this to your Roo-Code `mcp_settings.json`:
```json
{
"mcpServers": {
"your-server-name": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-NAME"],
"env": {
"YOUR_API_KEY": "your-key-here"
}
}
}
}
```
Each setup file in `/mcp-setups/` contains the full config, env variables needed, and a demo prompt to test it works.
---
## 📊 Model Benchmarks
Which model should you use with Roo-Code? It depends on your task. Here's the data.
| Model | Best for | Cost/1M tokens | Speed | Local? |
|---|---|---|---|---|
| `claude-3-5-sonnet` | Complex multi-file tasks | ~$3 input / $15 output | Fast | ❌ |
| `deepseek-chat` | Cost-efficient agentic tasks | ~$0.27 input / $1.10 output | Fast | ❌ |
| `gpt-4o-mini` | Simple refactors, docs | ~$0.15 input / $0.60 output | Very fast | ❌ |
| `llama3:8b` (Ollama) | Air-gapped / zero cost | **$0** | Medium | ✅ |
| `qwen2.5-coder` (Ollama) | Best local coding model | **$0** | Medium | ✅ |
> Full benchmark methodology and task-by-task breakdown: [`model-benchmarks/cost-per-task.md`](./model-benchmarks/cost-per-task.md)
---
## 🚀 How to use
**Prerequisites:**
- [VS Code](https://code.visualstudio.com/) installed
- [Roo-Code extension](https://marketplace.visualstudio.com/items?itemName=RooVetGit.roo-cline) installed
- At least one API key (or [Ollama](https://ollama.com/) for local/free setup)
**Clone this repo:**
```bash
git clone https://github.com/DiegoGuti2115/roo-code-configs.git
cd roo-code-configs
```
Then pick a config from any folder and follow the instructions inside the file. Each config is self-contained with a step-by-step setup guide.
---
## 🗺️ Repo structure
```
roo-code-configs/
├── custom-modes/
│ ├── security-auditor.md
│ ├── docs-writer.md
│ ├── architect-reviewer.md
│ ├── test-engineer.md
│ └── migration-agent.md
├── mcp-setups/
│ ├── postgres-mcp.md
│ ├── github-mcp.md
│ ├── filesystem-mcp.md
│ └── notion-mcp.md
├── model-benchmarks/
│ └── cost-per-task.md
├── workflow-templates/
│ └── full-feature-from-issue.md
└── README.md
```
---
## 🤝 Contributing
Found a better config? Built a mode that solves a real problem? PRs are very welcome.
1. Fork the repo
2. Create a branch: `git checkout -b my-new-mode`
3. Add your config file following the template format in any existing file
4. Open a PR with a short description of what it does and what you tested it on
All contributors get credited in the README.
---
## 📬 Stay updated
I post new configs, benchmarks and agentic workflow tutorials weekly.
- 🐦 **X/Twitter:** [@DiegoGuti2115](https://x.com/DiegoGuti2115) — threads on every new config
- 💻 **GitHub:** Watch this repo for release notifications
---
<div align="center">
MIT License · Made by [Diego Gutiérrez](https://github.com/DiegoGuti2115) · CS Student @ URJC Madrid
*Learning in public. Sharing everything.*
</div>
