{"id":29910752,"url":"https://github.com/Theopsguide/gemini-code-flow","last_synced_at":"2025-08-02T01:14:44.152Z","repository":{"id":301429971,"uuid":"1009043176","full_name":"Theopsguide/gemini-code-flow","owner":"Theopsguide","description":"AI-powered development orchestration for Gemini CLI - adapted from Claude Code Flow by ruvnet","archived":false,"fork":false,"pushed_at":"2025-06-27T14:57:52.000Z","size":205,"stargazers_count":87,"open_issues_count":3,"forks_count":11,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-30T14:34:07.155Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Theopsguide.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-26T13:39:54.000Z","updated_at":"2025-07-29T20:30:04.000Z","dependencies_parsed_at":"2025-06-26T21:16:12.819Z","dependency_job_id":"8937810b-9dd6-421b-bf1d-4dc4e3022f60","html_url":"https://github.com/Theopsguide/gemini-code-flow","commit_stats":null,"previous_names":["theopsguide/gemini-code-flow"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Theopsguide/gemini-code-flow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Theopsguide%2Fgemini-code-flow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Theopsguide%2Fgemini-code-flow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Theopsguide%2Fgemini-code-flow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Theopsguide%2Fgemini-code-flow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Theopsguide","download_url":"https://codeload.github.com/Theopsguide/gemini-code-flow/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Theopsguide%2Fgemini-code-flow/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268322588,"owners_count":24231851,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-01T02:00:08.611Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-02T01:14:21.582Z","updated_at":"2025-08-02T01:14:44.080Z","avatar_url":"https://github.com/Theopsguide.png","language":"TypeScript","funding_links":[],"categories":["Frameworks","AI Coding Agents"],"sub_categories":["Gemini CLI"],"readme":"# Gemini Code Flow 🚀\n\n\u003e **Built on the amazing work by [RuV](https://github.com/ruvnet)** - this is an adaptation of [Claude Code Flow](https://github.com/ruvnet/claude-code-flow) for Gemini CLI\n\n## 🙏 Credit\n\n**This project exists because of [RuV's](https://github.com/ruvnet) 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!\n\n👉 **Go check out the original:** https://github.com/ruvnet/claude-code-flow\n\n## 🌟 Overview\n\nGemini 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.\n\n## ✨ Features\n\n- **Multi-Agent Orchestration**: Run up to 10 Gemini agents in parallel\n- **17 SPARC Development Modes**: Specialized agents for every development need\n- **Persistent Memory**: Share knowledge across agents and sessions\n- **Multimodal Support**: Leverage Gemini's ability to process images, PDFs, and sketches\n- **Large Context Window**: Utilize Gemini's 1M token context for complex codebases\n- **Google Search Integration**: Ground responses with real-time information\n\n## 🛠️ SPARC Development Modes\n\n1. 🏗️ **Architect** - System design and architecture\n2. 🧠 **Auto-Coder** - Clean, modular implementation\n3. 🧪 **Tester (TDD)** - Test-driven development\n4. 🪲 **Debugger** - Troubleshooting and bug fixes\n5. 🛡️ **Security Reviewer** - Security audits\n6. 📚 **Documentation Writer** - Comprehensive documentation\n7. 🔗 **System Integrator** - Component integration\n8. 📈 **Deployment Monitor** - Post-launch monitoring\n9. 🧹 **Optimizer** - Performance optimization\n10. ❓ **Ask** - Task formulation guide\n11. 🚀 **DevOps** - Deployment and infrastructure\n12. 📘 **SPARC Tutorial** - Interactive learning\n13. 🔐 **Database Admin** - Database management\n14. 📋 **Specification Writer** - Requirements and pseudocode\n15. ♾️ **MCP Integration** - External service connections\n16. ⚡️ **SPARC Orchestrator** - Complex workflows\n17. 🎨 **Designer** - UI/UX with multimodal capabilities\n\n## 📦 Installation\n\n### Prerequisites\n- Node.js 18+\n- Gemini CLI installed globally\n\n```bash\n# Install Gemini CLI first\nnpm install -g @google/gemini-cli\n\n# Install Gemini Code Flow (now available on npm!)\nnpm install -g gemini-code-flow\n```\n\n**✅ Package is now live on npm:** https://www.npmjs.com/package/gemini-code-flow\n\n## 🔐 Authentication Options\n\nGemini Code Flow supports multiple authentication methods:\n\n### Option 1: Personal Google Account (Recommended for Individual Use)\n**Free usage with generous limits:**\n- 60 requests per minute\n- 1,000 requests per day\n- Access to Gemini 2.5 Pro with 1M token context\n\n```bash\n# Simply login with your Google account when prompted\ngemini-flow init --sparc\n# No API key configuration needed!\n```\n\n### Option 2: API Key (For Professional/Enterprise Use)\nFor multiple simultaneous agents or usage-based billing:\n\n```bash\n# Set your API key from Google AI Studio or Vertex AI\nexport GEMINI_API_KEY=\"your-api-key-here\"\n```\n\n### Current Limitations (Preview)\n- Personal Google accounts: 60 requests/minute, 1,000/day\n- Some advanced features may require API key authentication\n- For the latest usage limits and capabilities, see [Google's official announcement](https://developers.googleblog.com/en/gemini-cli-your-open-source-ai-agent/)\n\n## 🚀 Quick Start\n\n```bash\n# Initialize a new project with SPARC\ngemini-flow init --sparc\n\n# Start the orchestrator\ngemini-flow start\n\n# Run a specific SPARC mode\ngemini-flow sparc architect \"Design a microservices architecture\"\n\n# Launch multi-agent workflow\ngemini-flow sparc \"Build a REST API with authentication\"\n```\n\n## 💡 Usage Examples\n\n### Simple Task\n```bash\ngemini-flow agent \"Refactor this function to use async/await\"\n```\n\n### Complex Multi-Agent Workflow\n```bash\ngemini-flow sparc orchestrator \"Create a full-stack application with React frontend and Node.js backend, including tests and documentation\"\n```\n\n### Multimodal Development\n```bash\ngemini-flow sparc designer \"Convert this wireframe sketch to React components\" --file ./wireframe.png\n```\n\n## 🔧 Configuration\n\nCreate a `.gemini-flow.json` in your project root:\n\n```json\n{\n  \"maxAgents\": 10,\n  \"memoryPath\": \"./gemini-memory.json\",\n  \"authMethod\": \"google-account\",\n  \"modes\": {\n    \"architect\": {\n      \"temperature\": 0.7,\n      \"maxTokens\": 8000\n    }\n  }\n}\n```\n\n**Configuration Options:**\n- `authMethod`: `\"google-account\"` (default) or `\"api-key\"`\n- `apiKey`: Only needed if using `\"api-key\"` method\n- `maxAgents`: Number of parallel agents (consider rate limits)\n- `memoryPath`: Location for persistent memory storage\n\n## 🤝 Contributing\n\n**Full disclosure: I'm a total noob at this!** 🤷‍♂️ This project needs experienced developers to help make it actually good.\n\n### 🆘 I Really Need Help With:\n- 📝 **Code reviews** - I probably did things wrong\n- 🐛 **Bug fixes** - There are definitely bugs I missed\n- 🏗️ **Architecture improvements** - I'm sure there are better ways to do things\n- 📚 **Documentation** - Help make it clearer than my attempts\n- 🧪 **Testing** - I need to learn proper testing practices\n- 🚀 **Performance** - No idea if this is optimized\n- 🔧 **Best practices** - Teach me the right way!\n\n**Seriously, ANY feedback is welcome!** Even if it's \"you're doing this completely wrong\" - I want to learn! 📚\n\n### 👋 New to Open Source?\n**Perfect!** This is a great project to start with. We welcome:\n- 🐛 Bug reports and fixes\n- 💡 Feature ideas and implementations  \n- 📖 Documentation improvements\n- 🧪 Tests and examples\n- 🎨 UI/UX improvements\n- 🌟 Any creative ideas!\n\n### 🚀 Quick Start for Contributors\n```bash\n# 1. Fork this repo on GitHub\n# 2. Clone your fork\ngit clone https://github.com/YOUR-USERNAME/gemini-code-flow.git\n# 3. Install dependencies\nnpm install\n# 4. Make your changes\n# 5. Test your changes\nnpm run build\n# 6. Submit a pull request!\n```\n\n**Don't know where to start?** Look for issues labeled `good first issue` or `help wanted`!\n\nSee our [Contributing Guide](CONTRIBUTING.md) for more details.\n\n## 📄 License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n### 🙏 Also Thanks To\n- **Google Gemini team** - For the excellent CLI tool\n- **Future contributors** - Who will hopefully fix all my mistakes! See [CONTRIBUTORS.md](CONTRIBUTORS.md)\n- **You!** - For being patient with a noob. This is my first \"real\" repo 😅\n\n## 📚 Documentation\n\nFor detailed documentation:\n- **Project Requirements**: See [PRD.md](PRD.md)\n- **SPARC Methodology**: See [SPARC-SUMMARY.md](SPARC-SUMMARY.md)\n- **Contributing**: See [CONTRIBUTING.md](CONTRIBUTING.md)\n\n## 🐛 Issues \u0026 Support\n\nFound a bug or have a suggestion? Please [open an issue](https://github.com/Theopsguide/gemini-code-flow/issues) on GitHub.\n\nFor questions and discussions, feel free to start a conversation in the issues section.\n\n---\n\nBuilt with ❤️ by the community. Adapted from Claude Code Flow\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTheopsguide%2Fgemini-code-flow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FTheopsguide%2Fgemini-code-flow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTheopsguide%2Fgemini-code-flow/lists"}