Built on the amazing work by RuV - this is an adaptation of Claude Code Flow for Gemini CLI
This project exists because of RuV's incredible work on Claude Code Flow. All the brilliant concepts, SPARC methodology, and multi-agent orchestration come from RuV's original project. I'm just a noob trying to adapt it for Gemini CLI!
👉 Go check out the original: https://github.com/ruvnet/claude-code-flow
Gemini Code Flow brings the powerful SPARC methodology and multi-agent orchestration capabilities to Google's Gemini CLI platform. This tool enables developers to leverage multiple AI agents working in parallel to write, test, and optimize code systematically.
- Multi-Agent Orchestration: Run up to 10 Gemini agents in parallel
- 17 SPARC Development Modes: Specialized agents for every development need
- Persistent Memory: Share knowledge across agents and sessions
- Multimodal Support: Leverage Gemini's ability to process images, PDFs, and sketches
- Large Context Window: Utilize Gemini's 1M token context for complex codebases
- Google Search Integration: Ground responses with real-time information
- 🏗️ Architect - System design and architecture
- 🧠 Auto-Coder - Clean, modular implementation
- 🧪 Tester (TDD) - Test-driven development
- 🪲 Debugger - Troubleshooting and bug fixes
- 🛡️ Security Reviewer - Security audits
- 📚 Documentation Writer - Comprehensive documentation
- 🔗 System Integrator - Component integration
- 📈 Deployment Monitor - Post-launch monitoring
- 🧹 Optimizer - Performance optimization
- ❓ Ask - Task formulation guide
- 🚀 DevOps - Deployment and infrastructure
- 📘 SPARC Tutorial - Interactive learning
- 🔐 Database Admin - Database management
- 📋 Specification Writer - Requirements and pseudocode
- ♾️ MCP Integration - External service connections
- ⚡️ SPARC Orchestrator - Complex workflows
- 🎨 Designer - UI/UX with multimodal capabilities
- Node.js 18+
- Gemini CLI installed globally
# Install Gemini CLI first
npm install -g @google/gemini-cli
# Install Gemini Code Flow (now available on npm!)
npm install -g gemini-code-flow✅ Package is now live on npm: https://www.npmjs.com/package/gemini-code-flow
Gemini Code Flow supports multiple authentication methods:
Free usage with generous limits:
- 60 requests per minute
- 1,000 requests per day
- Access to Gemini 2.5 Pro with 1M token context
# Simply login with your Google account when prompted
gemini-flow init --sparc
# No API key configuration needed!For multiple simultaneous agents or usage-based billing:
# Set your API key from Google AI Studio or Vertex AI
export GEMINI_API_KEY="your-api-key-here"- Personal Google accounts: 60 requests/minute, 1,000/day
- Some advanced features may require API key authentication
- For the latest usage limits and capabilities, see Google's official announcement
# Initialize a new project with SPARC
gemini-flow init --sparc
# Start the orchestrator
gemini-flow start
# Run a specific SPARC mode
gemini-flow sparc architect "Design a microservices architecture"
# Launch multi-agent workflow
gemini-flow sparc "Build a REST API with authentication"gemini-flow agent "Refactor this function to use async/await"gemini-flow sparc orchestrator "Create a full-stack application with React frontend and Node.js backend, including tests and documentation"gemini-flow sparc designer "Convert this wireframe sketch to React components" --file ./wireframe.pngCreate a .gemini-flow.json in your project root:
{
"maxAgents": 10,
"memoryPath": "./gemini-memory.json",
"authMethod": "google-account",
"modes": {
"architect": {
"temperature": 0.7,
"maxTokens": 8000
}
}
}Configuration Options:
authMethod:"google-account"(default) or"api-key"apiKey: Only needed if using"api-key"methodmaxAgents: Number of parallel agents (consider rate limits)memoryPath: Location for persistent memory storage
Full disclosure: I'm a total noob at this! 🤷♂️ This project needs experienced developers to help make it actually good.
- 📝 Code reviews - I probably did things wrong
- 🐛 Bug fixes - There are definitely bugs I missed
- 🏗️ Architecture improvements - I'm sure there are better ways to do things
- 📚 Documentation - Help make it clearer than my attempts
- 🧪 Testing - I need to learn proper testing practices
- 🚀 Performance - No idea if this is optimized
- 🔧 Best practices - Teach me the right way!
Seriously, ANY feedback is welcome! Even if it's "you're doing this completely wrong" - I want to learn! 📚
Perfect! This is a great project to start with. We welcome:
- 🐛 Bug reports and fixes
- 💡 Feature ideas and implementations
- 📖 Documentation improvements
- 🧪 Tests and examples
- 🎨 UI/UX improvements
- 🌟 Any creative ideas!
# 1. Fork this repo on GitHub
# 2. Clone your fork
git clone https://github.com/YOUR-USERNAME/gemini-code-flow.git
# 3. Install dependencies
npm install
# 4. Make your changes
# 5. Test your changes
npm run build
# 6. Submit a pull request!Don't know where to start? Look for issues labeled good first issue or help wanted!
See our Contributing Guide for more details.
MIT License - see LICENSE file for details.
- Google Gemini team - For the excellent CLI tool
- Future contributors - Who will hopefully fix all my mistakes! See CONTRIBUTORS.md
- You! - For being patient with a noob. This is my first "real" repo 😅
For detailed documentation:
- Project Requirements: See PRD.md
- SPARC Methodology: See SPARC-SUMMARY.md
- Contributing: See CONTRIBUTING.md
Found a bug or have a suggestion? Please open an issue on GitHub.
For questions and discussions, feel free to start a conversation in the issues section.
Built with ❤️ by the community. Adapted from Claude Code Flow