Boring for Gemini

Autonomous AI Agent Loop with VibeCoder Experience

English | 繁體中文

✨ The Vibe Coder Experience (V10.24)

No Code Needed. Just describe the vibe.

Boring-Gemini now features a Universal Natural Language Router. You don't need to remember 98+ complex tools. Just say what you want in English or Chinese:

"Search for authentication logic"

"Review my code for security issues"

"幫我寫測試" (Help me write tests)

"我想做登入功能" (I want to build login feature)

Try it in your terminal:

boring-route "review my code"
# 🎯 Routes to boring_code_review (100%)

👉 Learn more about Vibe Coder Experience

⚡ boring 的厲害 (Why Boring?)

Boring isn't just an MCP server; it's a Intelligence Maximization System:

1. 🧠 Autonomous Loop: Not just a chatbot. Boring runs in a loop (boring start), thinking, coding, testing, and fixing until the job is done.
2. 🕵️ Hybrid RAG: Advanced code search combining keywords, vectors, and dependency graphs (HyDE + Cross-Encoder). It finds code you didn't even know existed.
3. 🛡️ Security Shadow Mode: Safe execution sandbox. It catches dangerous operations before they happen.
4. ⚡ 30% Faster: Smart caching and optimized router reduce context usage by 80% (from 98 tools to 19).
5. 🧩 Vibe Coder: The most human-friendly AI coding interface. Zero friction between thought and code.

🚀 Quick Start

Boring: Your Autonomous Coding Partner

Enterprise-grade Autonomous AI Development Agent
A full-language automated coding and verification engine built for Cursor / Claude Desktop / VS Code / Gemini CLI.

中文版 README | Full Documentation

🚀 Core Advantages

[!IMPORTANT] Boring is now primarily an MCP tool (used via Cursor / Claude Desktop / IDE)

• ❌ Not recommended to run boring start directly in CMD/terminal: Gemini CLI no longer supports free authorization (unless using API, which is not well-tested)
• ✅ Recommended usage: Use Boring tools through Smithery or MCP config in your IDE or Client
• ✅ Monitoring tools still work: boring-monitor, boring-dashboard can be run locally

Most features are optimized for the MCP environment. CLI mode is no longer the primary supported method.

📦 Quick Installation

Option 1: Smithery (✅ Recommended)

npx -y @smithery/cli@latest install boring/boring --client gemini-cli

⚠️ Gemini Client Users: If you encounter issues installing via Smithery, please use Option 2 (Local pip). Direct Smithery integration on Gemini Client can be intermittent.

Option 2: Local pip Installation

# Install with all features (Recommended for Vibe Coder)
pip install "boring-aicoding[all]"

# Or minimal install
pip install boring-aicoding

🤔 Which one should I choose?

⚙️ MCP Environment Variables

Profile Comparison:

📖 Full MCP Configuration Guide

Option 3: Clone from GitHub (Fallback)

Best for: Developers or if pip install fails

git clone https://github.com/Boring206/boring-gemini.git
cd boring-gemini
pip install -e .

🚀 Usage

1️⃣ MCP Mode (Recommended)

Add Boring to your Cursor or VS Code config. The Agent will become an autonomous engineer in your IDE.

• Prompts: Click the ✨ button or use Cmd+I to select a prompt.
• Workflows: Type / in Chat to trigger a workflow.

💎 Top 5 Most Used Functions

👉 View Complete Reference Manual (All 30+ Functions)

2️⃣ Maintenance Commands

Run these commands in your terminal:

# Install Git Hooks (Auto-verify commits)
python -m boring hooks install

# Open Dashboard (Web UI)
python -m boring dashboard

# Check Health
python -m boring status

3️⃣ LSP Server (Optional - For VS Code / Neovim Only)

[!NOTE] Cursor users: You DON'T need LSP! Cursor has built-in AI features. Just use MCP config above.

LSP is for: VS Code (without AI), Neovim, and other terminal editors.

What's the difference?

[!CAUTION] DO NOT run python -m boring lsp start directly in terminal. This command is for editor configuration only. The LSP server communicates via stdin/stdout.

⚙️ MCP Configuration

For Smithery

{
  "mcpServers": {
    "boring": {
      "command": "npx",
      "args": ["-y", "@smithery/cli", "run", "@boring/boring", "--config", "{}"]
    }
  }
}

For Local pip

{
  "mcpServers": {
    "boring": {
      "command": "python",
      "args": ["-m", "boring.mcp.server"],
      "env": {
        "BORING_MCP_MODE": "1"(NEEDED),
        "PROJECT_ROOT_DEFAULT": ".",
        "BORING_MCP_PROFILE": "lite"
      }
    }
  }
}

🎛️ Tool Profiles (V10.24)

Problem: 98 tools can overwhelm LLM context windows. Solution: Choose a profile to expose only the tools you need.

Configure in .boring.toml:

[boring.mcp]
profile = "lite"  # Options: minimal, lite, standard, full

Or via environment variable:

export BORING_MCP_PROFILE=lite

🎯 Universal Router: With lite profile, use boring("search for auth code") - the router automatically directs to the right tool!

🎯 Quick Start Prompts

📚 Documentation

✨ Vibe Coder Pro Toolset

🎉 Interactive Tutorial on Startup! First-time MCP connection triggers mcp_intro to guide new users.

🗣️ Natural Language Triggers (No Code Required!)

Just say these to Boring:

👉 Full Prompt Guide

🧰 Core Tools

🔐 Security Scan Integration

Vibe Coder Pro includes built-in Token detection for:

• Python: PyPI, AWS, GCP, Azure, etc.
• JS/Node.js: NPM, Vercel, Supabase, Firebase, Stripe.
• General: GitHub, GitLab, Slack, SendGrid (20+ types).

# Health check triggers security scan automatically
result = boring_vibe_check(project_path=".", max_files=100)
print(result["security_issues"])

🧠 External Intelligence

Boring integrates the most powerful external MCP tools by default, turning the Agent into a super engineer.

🚀 Performance (v10.21.0)

• Thread-local SQLite: Zero-overhead DB connections.
• WAL Mode: 50% faster concurrent reads.
• Smart Caching: 30s query cache & Pattern cache for instant RAG.

🛡️ Shadow Mode

Shadow mode protects you from destructive AI operations:

DISABLED  ⚠️  No protection (Container only)
ENABLED   🛡️  Auto-approve safe, Block risky (Default)
STRICT    🔒  Approve all writes (Production)

boring_shadow_mode(action="set_level", level="STRICT")

🔧 Troubleshooting & Environment

Common Issues

1. "Command not found" or Wrong Python Version If running boring commands fails or uses the wrong Python environment (e.g., system Python instead of venv), use python -m:

# ✅ Recommended usage for reliability
python -m boring --help
python -m boring hooks install

2. "tree-sitter-languages not installed" Warning This means the advanced code parser is missing. RAG features will be limited to keyword search only.

Fix:

pip install tree-sitter-languages
# Or update all dependencies
pip install "boring-aicoding[all]"

🎯 Future Vision

Note: The following features require server support (not yet implemented)

• 🌐 Boring Cloud: Cloud collaboration and team sharing
• 🤝 Team Workflows: Multi-person workflow synchronization
• 🔐 Enterprise SSO: Enterprise-grade identity authentication

🙏 Acknowledgments

• Google Gemini - AI Engine
• Anthropic Claude - MCP Protocol
• Smithery - Deployment Platform

📄 License

MIT License - Open source and free to use

🔗 Links