$git clone https://github.com/nth5693/gemini-kitGemini-Kit is an extension for Gemini CLI that brings 27 specialized AI agents, 45 commands, and 33 workflows to help you code 10x faster.
| 1 | # 🚀 Gemini-Kit |
| 2 | |
| 3 | <div align="center"> |
| 4 | |
| 5 | [](https://github.com/nth5693/gemini-kit/releases) |
| 6 | [](LICENSE) |
| 7 | []() |
| 8 | []() |
| 9 | []() |
| 10 | []() |
| 11 | []() |
| 12 | |
| 13 | ### 🎯 Transform Your Terminal into an AI Engineering Team |
| 14 | |
| 15 | **Gemini-Kit** is an extension for [Gemini CLI](https://github.com/google-gemini/gemini-cli) that brings **27 specialized AI agents**, **45 commands**, and **33 workflows** to help you code 10x faster. |
| 16 | |
| 17 | [🚀 Quick Start](#-quick-start) • [🤖 Agents](#-agents) • [🛠️ Skills](#️-skills) • [⌨️ Commands](#️-commands) • [📚 API](docs/API.md) |
| 18 | |
| 19 | </div> |
| 20 | |
| 21 | --- |
| 22 | |
| 23 | ## 📋 Table of Contents |
| 24 | |
| 25 | - [What is Gemini-Kit?](#-what-is-gemini-kit) |
| 26 | - [Quick Start](#-quick-start) |
| 27 | - [Agents](#-agents) |
| 28 | - [Skills](#️-skills) |
| 29 | - [Commands](#️-commands) |
| 30 | - [MCP Tools](#-mcp-tools) |
| 31 | - [Security](#-security) |
| 32 | - [FAQ](#-faq) |
| 33 | |
| 34 | --- |
| 35 | |
| 36 | ## 🤔 What is Gemini-Kit? |
| 37 | |
| 38 | **Gemini-Kit** transforms Gemini CLI into a **virtual engineering team** with: |
| 39 | |
| 40 | | Feature | Count | Description | |
| 41 | |---------|-------|-------------| |
| 42 | | 🤖 **AI Agents** | 27 | Specialized roles (Security, Frontend, Backend, DevOps...) | |
| 43 | | 🛠️ **Skills** | 15 | Knowledge modules (React, Next.js, Docker, Security...) | |
| 44 | | ⌨️ **Commands** | 45 | Slash commands for every workflow | |
| 45 | | 🔄 **Workflows** | 33 | Structured development workflows | |
| 46 | | 🔒 **Security** | 30+ | Secret detection patterns | |
| 47 | | 📜 **Scripts** | 50+ | Automation scripts | |
| 48 | |
| 49 | ### Key Features |
| 50 | |
| 51 | - **🔄 Compound System**: `/explore → /plan → /work → /review → /compound` - Each iteration builds a Knowledge Base. Solutions are saved and reused! |
| 52 | - **🧠 Learning System**: AI learns from your feedback. Correct once, it remembers forever |
| 53 | - **📚 23 Critical Patterns**: Common mistakes documented as patterns - AI reads them before coding |
| 54 | - **🎯 Multi-agent Orchestration**: Orchestrator coordinates multiple agents for complex tasks |
| 55 | - **💾 Auto-checkpoint**: Automatic Git backup before changes |
| 56 | - **🔒 Security Hooks**: Real-time blocking of secrets (30+ patterns) |
| 57 | - **📢 Notifications**: Discord & Telegram integration |
| 58 | |
| 59 | --- |
| 60 | |
| 61 | ## 🚀 Quick Start |
| 62 | |
| 63 | ### Prerequisites |
| 64 | |
| 65 | | Requirement | Version | Check | |
| 66 | |-------------|---------|-------| |
| 67 | | Node.js | ≥ 18.0 | `node --version` | |
| 68 | | Git | ≥ 2.0 | `git --version` | |
| 69 | | Gemini CLI | Latest | `gemini --version` | |
| 70 | |
| 71 | ### Installation (2 minutes) |
| 72 | |
| 73 | ```bash |
| 74 | # 1. Clone repository |
| 75 | git clone https://github.com/nth5693/gemini-kit.git ~/.gemini/extensions/gemini-kit |
| 76 | |
| 77 | # 2. Install & build |
| 78 | cd ~/.gemini/extensions/gemini-kit |
| 79 | npm install && npm run build |
| 80 | |
| 81 | # 3. Link extension |
| 82 | gemini extensions link $(pwd) |
| 83 | ``` |
| 84 | |
| 85 | ### First Run |
| 86 | |
| 87 | ```bash |
| 88 | # Go to your project |
| 89 | cd /path/to/your/project |
| 90 | |
| 91 | # Start Gemini CLI |
| 92 | gemini |
| 93 | |
| 94 | # Try these commands: |
| 95 | > /status # Check project status |
| 96 | > /explore React # Research a topic |
| 97 | > /plan Add auth # Create implementation plan |
| 98 | ``` |
| 99 | |
| 100 | ### Update |
| 101 | |
| 102 | ```bash |
| 103 | cd ~/.gemini/extensions/gemini-kit |
| 104 | git pull && npm install && npm run build |
| 105 | ``` |
| 106 | |
| 107 | --- |
| 108 | |
| 109 | ## 🤖 Agents |
| 110 | |
| 111 | ### 27 Specialized AI Agents |
| 112 | |
| 113 | #### Core Development (5) |
| 114 | |
| 115 | | Agent | Role | When to Use | |
| 116 | |-------|------|-------------| |
| 117 | | 📋 **Planner** | Create detailed plans | Starting new features | |
| 118 | | 🔍 **Scout** | Explore codebase | New projects, onboarding | |
| 119 | | 💻 **Coder** | Write clean code | Implementing features | |
| 120 | | 🧪 **Tester** | Write & run tests | Quality assurance | |
| 121 | | 👀 **Reviewer** | Code review | Before merging PRs | |
| 122 | |
| 123 | #### Specialists (12) - NEW in v4.0 |
| 124 | |
| 125 | | Agent | Role | When to Use | |
| 126 | |-------|------|-------------| |
| 127 | | 🔐 **Security Auditor** | Security audit, OWASP | Security reviews | |
| 128 | | ⚛️ **Frontend Specialist** | React, Next.js, UI/UX | Frontend developm |