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 98+ 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

🧐 Cognitive Evolution (Pillar V)

V11.2.2 transforms Boring from a simple loop into a Self-Improving Intelligence System:

  • 🧘‍♀️ Deep & Critical Thinking: Decomposes complex problems using multi-layered reasoning states (System 2).
  • ⚡ Brain Reflex (Active Recall): Instantly recalls past debug patterns. No more "searching"—it remembers how you fixed that AttributeError last time.
  • 🏆 Skill Compilation: High-frequency successful patterns are distilled into Strategic Skills, making your local agent uniquely expert in your stack.
  • 🛠️ Live Tool Synthesis: The agent can now generate its own tools in Python to solve hyper-specific problems on-the-fly.
  • 🌐 Knowledge Swarm: Sync learned patterns across your team via Git-based synchronization.

⚡ Core Capabilities

Feature Description
🧠 Autonomous Loop Runs continuously: thinking → coding → testing → fixing.
🕵️ Context Optimization 80% token savings via smart chunking and 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-monitor: Fullscreen TUI dashboard for live agent monitoring.
  • boring-dashboard: Modern web UI for project health and history.
  • boring-setup: Scaffold new Boring-ready projects in seconds.

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

  • 55+ MCP Tools: RAG, Testing, Review, Security, Git, and more
  • Multi-Language: Python, JavaScript, TypeScript support
  • Quality Gates: CI/CD integration with multi-tier verification
  • Memory System: Persistent learning and pattern recognition
  • LLM-as-a-Judge: Advanced evaluation with bias monitoring

📚 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-11.2.7.tar.gz (485.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-11.2.7-py3-none-any.whl (567.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: boring_aicoding-11.2.7.tar.gz
  • Upload date:
  • Size: 485.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-11.2.7.tar.gz
Algorithm Hash digest
SHA256 4c022f0d8625d931b668ec61f6da71c628b2a0f0cbe00584298496e19a33b681
MD5 b38ce8df372efdcc4eae2ed417db05f4
BLAKE2b-256 fb403196516362c3c7191b44bccad6b201948bf8b36f0539c6c8c19c91ca7569

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for boring_aicoding-11.2.7-py3-none-any.whl
Algorithm Hash digest
SHA256 f6869af55824354ed0b5cb05658e1fcf3133d7db86fc9bce631ad19cc686c5ec
MD5 2f98c7e3d1fb81c5623dd5d75e77c5e1
BLAKE2b-256 2f910ec7c7082ba97a823fd1eff6ff17730be3dca08888e04c6d82d2b8e0343d

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