⚠️ ALPHA STATUS: This project is in active development (v0.1.0). Core features work but expect breaking changes. Use in production at your own risk. See roadmap →
An intelligent CLI tool that helps you build project-specific Gemini rule systems with smart project analysis - optimized for free tier accounts.
- 🤖 Intelligent Project Analysis - Scans existing codebases and suggests rules
- 📝 Interactive GEMINI.md Builder - Guides you through creating project context
- 🔄 Rule Application Engine - Enforces rules with retry logic and rate limiting
- 📊 Token Tracking - Real-time monitoring of API usage and costs
- 🎯 MCP Integration - Works with Model Context Protocol servers
- 💰 Free Tier Optimized - Smart rate limiting for ALL Gemini models
- 🐳 Docker Ready - Complete containerization with Docker Compose
- 📚 Professional Docs - Comprehensive guides and templates
Version: 0.1.0 (Alpha)
Status: 🚧 In Active Development
- ✅ Core AI service with rate limiting
- ✅ Project intelligence and analysis
- ✅ Token tracking and caching
- ✅ Docker containerization
- ✅ MCP server configurations
Coming Soon (See Roadmap):
- 🚧 Advanced rate limiting (v0.2.0 - Dec 2025)
- 🚧 Model fallback system (v0.2.0)
- 🚧 Context caching (v0.3.0 - Jan 2026)
- 🚧 Streaming responses (v0.4.0)
- 🚧 Web dashboard (v0.7.0)
# Clone the repository
git clone https://github.com/StewardshipAI/gemini-cli-rules-tools-builder.git
cd gemini-cli-rules-tools-builder
# Install dependencies
npm install
# Configure environment
cp .env.example .env
# Edit .env and add your GEMINI_API_KEY
# Test it works
npm run start -- --help# Clone and build
git clone https://github.com/StewardshipAI/gemini-cli-rules-tools-builder.git
cd gemini-cli-rules-tools-builder
# Configure
cp .env.example .env
# Add your GEMINI_API_KEY
# Build and run
docker-compose up -d
# See logs
docker-compose logs -fSee DOCKER.md for detailed Docker instructions.
# Initialize a new project with intelligent analysis
npm run init
# Apply rules to files (coming soon)
npm run apply
# Check usage stats
npm run stats- Getting Started - First steps
- Configuration Guide - All settings explained
- Docker Setup - Containerization guide
- MCP Integration - MCP server setup
- Contributing - How to contribute
- Roadmap - Future plans
- Changelog - Version history
We welcome contributions! This project is in early stages and needs:
- 🐛 Bug reports - Found an issue? Open an issue
- ✨ Feature requests - Have an idea? Request a feature
- 📝 Documentation - Help improve docs
- 💻 Code - Check out good first issues
See CONTRIBUTING.md for guidelines.
If this tool helps you, consider supporting its development:
Other ways to support:
- ⭐ Star this repo
- 📣 Share with others
- 🐛 Report bugs
- 💻 Contribute code
- 📝 Improve docs
See SPONSORS.md for more details.
This project was inspired by:
- llm-cursor-rules by @RayFernando1337 - Rule structure concept
- Google Gemini CLI - CLI architecture patterns
Special thanks to:
- Ray Fernando for sharing his work openly
- Google AI team for Gemini API
- Open source community for tools and inspiration
See CREDITS.md for complete attributions.
MIT License - see LICENSE file for details.
- Repository: https://github.com/StewardshipAI/gemini-cli-rules-tools-builder
- Issues: https://github.com/StewardshipAI/gemini-cli-rules-tools-builder/issues
- Discussions: https://github.com/StewardshipAI/gemini-cli-rules-tools-builder/discussions
- Roadmap: ROADMAP.md
- Sponsor: https://github.com/sponsors/StewardshipAI
This is alpha software. While it works, expect:
- Breaking changes between versions
- Bugs and rough edges
- Incomplete features
- Active development
Not recommended for production use yet. See roadmap for v1.0 timeline (Q3 2026).
Built with ❤️ by StewardshipAI
Powered by Google Gemini API