Skip to main content

Boring: An AI-powered development support tool for autonomous reasoning, planning, and verification. Optimized for uv and agentic workflows.

Project description

Boring for Gemini

PyPI version License

Autonomous AI Agent Loop with VibeCoder Experience


✨ The Vibe Coder Experience

No Code Needed. Just describe the vibe.

Boring-Gemini features a Universal Natural Language Router. You don't need to remember 60+ complex tools. Just say what you want:

"Search for authentication logic"
"Review my code for security issues"
"幫我寫測試" (Help me write tests)


🚀 Quick Start (One-Click)

🪄 Zero-Config Wizard

Boring features a smart setup wizard that automatically bridges your IDE (Cursor, VS Code, Claude Desktop) with the Gemini agent.

pip install "boring-aicoding[all]"
boring wizard

💎 Smithery Integration

One-click install for Cursor/Claude Desktop.

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

🔮 The Cognitive Revolution (V14.0.0)

V14.0.0 transitions Boring from a tool to a Cognitive Autonomous Agent with a 4-layer architecture:

  • 🧠 Cognitive Architecture (System 2): Uses sequentialthinking to plan, reason, and revise before execution.
  • 🐉 One Dragon Flow: Autonomous traversal of the entire SDLC (Design → Build → Polish → Verify).
  • 🔮 Predictive Intelligence: boring predict and boring bisect catch errors before they happen.
  • 🔌 Offline-First Mode: 100% network-independent operation with local LLMs via llama-cpp-python.
  • 🛡️ Sovereign Autonomy: Managed tool governance (boring policy) and knowledge continuity (boring bio).
  • 🩺 Self-Healing: boring doctor --fix automatically repairs your environment.

⚡ Core Capabilities

Feature Description
🧠 Autonomous Loop Thinking → Coding → Testing → Fixing with System 2 reasoning.
🕵️ Context Optimization 80% token savings via smart chunking and semantic specificity ranking.
🛡️ Shadow Mode Safe execution sandbox catches destructive operations before they happen.
🧩 Natural Language Universal Router: "幫我寫測試" or "Fix auth bugs" triggered instantly.
🧪 Vibe Score Gamified health check: Lint, Security, and Docs tracked over time.

📦 Usage Modes

As MCP Server (Recommended for IDEs)

{
  "mcpServers": {
    "boring": { "command": "boring-mcp" }
  }
}

Managed CLI Utilities

  • boring flow: Start the One Dragon autonomous flow.
  • boring wizard: Bridge Cursor, Claude, VSCode, and more in seconds.
  • boring-monitor: Fullscreen TUI dashboard for live agent monitoring.
  • boring-dashboard: Modern web UI for project health and history.

About boring-route: This command only shows which MCP tool would be selected for your query. To actually execute the tool, use it in your MCP client (Cursor/Claude Desktop).


🔧 Key Features

  • 67+ MCP Tools: RAG, Testing, Review, Security, Git, and more
  • Predictive Error Detection: pro-active anti-pattern analysis
  • Local LLM Support: Llama 3, Qwen 2.5, Phi-3 integration
  • Multi-Language: Python, JavaScript, TypeScript, Go, C++ support
  • Quality Gates: CI/CD integration with multi-tier verification
  • Memory System: Persistent learning and pattern recognition

📚 Documentation


📄 License

Apache 2.0 - See LICENSE

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

boring_aicoding-14.0.0.tar.gz (640.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

boring_aicoding-14.0.0-py3-none-any.whl (751.0 kB view details)

Uploaded Python 3

File details

Details for the file boring_aicoding-14.0.0.tar.gz.

File metadata

  • Download URL: boring_aicoding-14.0.0.tar.gz
  • Upload date:
  • Size: 640.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.14

File hashes

Hashes for boring_aicoding-14.0.0.tar.gz
Algorithm Hash digest
SHA256 ee1bf737b2a76ceea46f3bccbd27d5927bbbcfc9baf4cf375b6440677aa08483
MD5 4d67e461553be360d9be8b959b3ceb06
BLAKE2b-256 9e387bff952f5d0da386dcba1f7e8ac4ace4ddab6eb9c515c9ae93361b15bd55

See more details on using hashes here.

File details

Details for the file boring_aicoding-14.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for boring_aicoding-14.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8eeff067eb67fbafb17237b10753b6d2fd1b3d8d05c73e9c3b8e847edfa3f207
MD5 f00af875c03f0f945458abc02e8d8269
BLAKE2b-256 c35c89ecef6686b26eca6542de3a10f6ed9b3456fea663077afef41de8a727a1

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page