The Cognitive Reasoning Engine for Autonomous Development
English | 繁體中文 | Documentation
Boring-Gemini isn't just a collection of tools; it's the thinking layer for your AI development workflow. While standard AI models suggest code, Boring reasons, verifies, and learns.
"Intent is the new Implementation."
In the era of Vibe Coding, your role shifts from writing syntax to defining Intent. Boring-Gemini acts as your agentic partner, handling the gap between a "Vibe" (Natural Language) and "Production" (Verified Code).
🧠 Pillar I: Cognitive Reasoning (Agentic Loop)
Boring implements a rigorous Planning -> Execution -> Verification loop. It doesn't just run commands; it uses sequentialthinking and criticalthinking to analyze its own steps, critiquing logic before hitting your disk.
🛡️ Pillar II: Resilient Autonomy (Active Recall)
The first agent with a Global Brain. When Boring encounters a failure, it consults its persistent knowledge base (.boring/brain) to recall how similar issues were solved across sessions. It learns from its mistakes so you don't have to.
⚡ Pillar III: Ultra-Fast Ecosystem (UV Native)
Designed for the modern Python stack. Boring natively supports uv for near-instant package management, lockfile synchronization, and isolated environment execution.
⚓ Pillar IV: Production-Grade Safety (Safety Net)
Trust is built on safety. Boring automatically creates Git Checkpoints before any risky operation. Combined with Shadow Mode, you have a "undo" button for AI agentic actions, ensuring your repository remains stable even during complex refactors.
🧬 Pillar V: Full-Power Boring (V11.4.2)
Not just execution, but evolution. V11.3.0 achieves Full-Power status by activating all high-value cognitive tools.
- SpecKit Activation: Enabled full Specification-Driven Development tools (
plan,tasks,analyze) for methodical planning. - Global Brain Tools: Unlocked cross-project knowledge sharing (
boring_global_export) to recycle success patterns. - Skills Autonomy: New
boring_skills_installallows the Agent to autonomously install missing Python packages. - Node.js Autonomy: Automatic Node.js download/install to ensure
gemini-cliworks even on fresh systems. - Lightweight Mode (BORING_LAZY_MODE): Perfect for "Quick Fixes" without polluting directories with
.boringfolders.
🧠 Pillar VI: Intelligent Adaptability (V11.5.0)
Introduction of Self-Awareness and Adaptive Safety.
- Usage Dashboard (P4): The Agent now tracks its own tool usage, visualizing stats in a CLI/Web dashboard.
- Anomaly Safety Net (P5): Automatically halts "stuck" loops (same tool + same args > 50 times) to save tokens and prevent crashes.
- Contextual Prompts (P6): Adaptive Profile now injects specific guides (e.g., Testing Guide) only when you need them.
| Feature | Description | |
|---|---|---|
| 🧠 | Unified Gateway (Cognitive Router) | The boring tool is now your single entry point. Use boring "check security", boring help, or boring discover "rag" to access all capabilities. |
| 🕵️ | Hybrid RAG | Combined Vector + Dependency Graph search. Understands not just what code says, but how it's used globally. |
| 🧪 | Vibe Check | Gamified health scanning. Calculates a Vibe Score and generates a "One-Click Fix Prompt" for the agent. |
| 🛡️ | Active Recall | Automatically learns from error patterns. Recalls past solutions to avoid repeating mistakes across sessions. |
| 📚 | Full Tool Reference | Complete catalog of 98+ tools with parameters and usage (中文). |
| 🧬 | Skill Compilation | Distills repeated successful patterns into high-level Strategic Skills. |
| 🪢 | Node.js Autonomy | Zeroconf Node.js & gemini-cli setup. No manual installation required. |
Boring adapts to your environment to save tokens and context:
- LITE (Default): Essential tools for daily coding using ~5% of context window.
- FULL: All 98+ tools active.
- ADAPTIVE (Recommended): Automatically builds a custom profile based on your top 20 most frequently used tools + Prompt Injection.
- Enable:
export BORING_MCP_PROFILE=adaptive
- Enable:
Designed for Vibe Coders. Setup in < 30 seconds.
Windows (PowerShell):
powershell -c "irm https://raw.githubusercontent.com/Boring206/boring-gemini/main/scripts/install.ps1 | iex"Linux / macOS:
curl -fsSL https://raw.githubusercontent.com/Boring206/boring-gemini/main/scripts/install.sh | bashpip install boring-aicoding
boring wizard🔧 Advanced Installation (uv, modular)
Using uv (Recommended for Speed):
uv pip install "boring-aicoding[all]"Modular Components:
pip install "boring-aicoding[vector]" # RAG Support
pip install "boring-aicoding[gui]" # Dashboard
pip install "boring-aicoding[mcp]" # MCP ServerTip
New to Boring? Check out the Visual Cheatsheet for a one-page summary of the 5 core commands.
Just say these phrases to the AI in your IDE (Cursor/Claude):
boring_flow: 🐉 One Dragon Engine. The ultimate autonomous workflow. Handles Setup -> Plan -> Build -> Polish automatically via code.start session: 🚀 Vibe Session. Activates Deep Thinking to autonomously manage the entire lifecycle of a complex task./vibe_start: Kick off a new project from scratch.quick_fix: Automatically repair all linting and formatting errors.review_code: Request a technical audit of your current file.smart_commit: Generate a semantic commit message from your progress.boring_vibe_check: Run a comprehensive health scan of the project.
Boring comes bundled with elite tools to boost AI performance:
- Context7: Real-time documentation querying for the latest libraries.
- Thinking Mode: Forces the agent into deep analytical reasoning (Sequential Thinking).
- Security Shadow Mode: A safety sandbox that intercepts dangerous AI operations.
- License: MIT
- Repository: GitHub
- Smithery: Boring Server
Built by Boring206 with 🤖 AI-Human Collaboration