\n\n[](https://github.com/nth5693/gemini-kit/releases)\n[](LICENSE)\n[]()\n[]()\n[]()\n[]()\n[]()\n\n### ๐ฏ Transform Your Terminal into an AI Engineering Team\n\n**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.\n\n[๐ Quick Start](#-quick-start) โข [๐ค Agents](#-agents) โข [๐ ๏ธ Skills](#๏ธ-skills) โข [โจ๏ธ Commands](#๏ธ-commands) โข [๐ API](docs/API.md)\n\n
\n\n---\n\n## ๐ Table of Contents\n\n- [What is Gemini-Kit?](#-what-is-gemini-kit)\n- [Quick Start](#-quick-start)\n- [Agents](#-agents)\n- [Skills](#๏ธ-skills)\n- [Commands](#๏ธ-commands)\n- [MCP Tools](#-mcp-tools)\n- [Security](#-security)\n- [FAQ](#-faq)\n\n---\n\n## ๐ค What is Gemini-Kit?\n\n**Gemini-Kit** transforms Gemini CLI into a **virtual engineering team** with:\n\n| Feature | Count | Description |\n|---------|-------|-------------|\n| ๐ค **AI Agents** | 27 | Specialized roles (Security, Frontend, Backend, DevOps...) |\n| ๐ ๏ธ **Skills** | 15 | Knowledge modules (React, Next.js, Docker, Security...) |\n| โจ๏ธ **Commands** | 45 | Slash commands for every workflow |\n| ๐ **Workflows** | 33 | Structured development workflows |\n| ๐ **Security** | 30+ | Secret detection patterns |\n| ๐ **Scripts** | 50+ | Automation scripts |\n\n### Key Features\n\n- **๐ Compound System**: `/explore โ /plan โ /work โ /review โ /compound` - Each iteration builds a Knowledge Base. Solutions are saved and reused!\n- **๐ง Learning System**: AI learns from your feedback. Correct once, it remembers forever\n- **๐ 23 Critical Patterns**: Common mistakes documented as patterns - AI reads them before coding\n- **๐ฏ Multi-agent Orchestration**: Orchestrator coordinates multiple agents for complex tasks\n- **๐พ Auto-checkpoint**: Automatic Git backup before changes\n- **๐ Security Hooks**: Real-time blocking of secrets (30+ patterns)\n- **๐ข Notifications**: Discord & Telegram integration\n\n---\n\n## ๐ Quick Start\n\n### Prerequisites\n\n| Requirement | Version | Check |\n|-------------|---------|-------|\n| Node.js | โฅ 18.0 | `node --version` |\n| Git | โฅ 2.0 | `git --version` |\n| Gemini CLI | Latest | `gemini --version` |\n\n### Installation (2 minutes)\n\n```bash\n# 1. Clone repository\ngit clone https://github.com/nth5693/gemini-kit.git ~/.gemini/extensions/gemini-kit\n\n# 2. Install & build\ncd ~/.gemini/extensions/gemini-kit\nnpm install && npm run build\n\n# 3. Link extension\ngemini extensions link $(pwd)\n```\n\n### First Run\n\n```bash\n# Go to your project\ncd /path/to/your/project\n\n# Start Gemini CLI\ngemini\n\n# Try these commands:\n> /status # Check project status\n> /explore React # Research a topic\n> /plan Add auth # Create implementation plan\n```\n\n### Update\n\n```bash\ncd ~/.gemini/extensions/gemini-kit\ngit pull && npm install && npm run build\n```\n\n---\n\n## ๐ค Agents\n\n### 27 Specialized AI Agents\n\n#### Core Development (5)\n\n| Agent | Role | When to Use |\n|-------|------|-------------|\n| ๐ **Planner** | Create detailed plans | Starting new features |\n| ๐ **Scout** | Explore codebase | New projects, onboarding |\n| ๐ป **Coder** | Write clean code | Implementing features |\n| ๐งช **Tester** | Write & run tests | Quality assurance |\n| ๐ **Reviewer** | Code review | Before merging PRs |\n\n#### Specialists (12) - NEW in v4.0\n\n| Agent | Role | When to Use |\n|-------|------|-------------|\n| ๐ **Security Auditor** | Security audit, OWASP | Security reviews |\n| โ๏ธ **Frontend Specialist** | React, Next.js, UI/UX | Frontend development |\n| ๐ฅ๏ธ **Backend Specialist** | API, Database, Docker | Backend development |\n| ๐ **DevOps Engineer** | CI/CD, K8s, GitHub Actions | Infrastructure |\n| ๐ **Debugger** | Root cause analysis | Runtime errors |\n| ๐๏ธ **Database Admin** | Schema, migrations | Database work |\n| ๐จ **UI Designer** | Design, animations | UI/UX |\n| ๐ **Fullstack** | End-to-end | Full features |\n| ๐ฑ **Mobile Developer** | React Native, Flutter | Mobile apps |\n| ๐ฎ **Game Developer** | Unity, Godot | Game development |\n| โก **Performance Optimizer** | Core Web Vitals, profiling | Performance issues |\n| ๐ **Penetration Tester** | Security testing | Pentest |\n\n#### Support & Management (6)\n\n| Agent | Role | When to Use |\n|-------|------|-------------|\n| ๐ **Git Manager** | Commits, branches | Version control |\n| ๐ **Docs Manager** | Documentation | README, API docs |\n| ๐ฌ **Researcher** | Research | Technology decisions |\n| ๐ก **Brainstormer** | Ideas | Problem solving |\n| ๐ **Project Manager** | Sprint planning | Project management |\n| โ๏ธ **Copywriter** | Marketing copy | Content |\n\n#### Specialized (4)\n\n| Agent | Role | When to Use |\n|-------|------|-------------|\n| ๐ฏ **Orchestrator** | Multi-agent coordination | Complex tasks |\n| ๐บ **Code Archaeologist** | Legacy code analysis | Refactoring old code |\n| ๐ค **Product Owner** | Requirements, backlog | Product decisions |\n| ๐ **SEO Specialist** | SEO/GEO optimization | SEO work |\n\n### How to Use Agents\n\n```bash\n# Mention agent in your request\n> Use the security-auditor agent to review authentication\n> Use the frontend-specialist to optimize React components\n> Use the backend-specialist to design API architecture\n```\n\n---\n\n## ๐ ๏ธ Skills\n\n### 15 Knowledge Modules\n\nSkills are loaded automatically based on context and agent configuration.\n\n#### Frontend (4)\n\n| Skill | Content |\n|-------|---------|\n| **react-patterns** | Hooks, state management, component composition |\n| **nextjs** | App Router, Server Components, data fetching |\n| **tailwind** | Tailwind CSS v4, responsive design |\n| **performance** | Core Web Vitals, caching, optimization |\n\n#### Backend (3)\n\n| Skill | Content |\n|-------|---------|\n| **api-design** | RESTful patterns, validation, rate limiting |\n| **docker** | Multi-stage builds, Compose, container security |\n| **security** | OWASP Top 10, JWT, XSS/CSRF prevention |\n\n#### Mobile & Testing (2)\n\n| Skill | Content |\n|-------|---------|\n| **mobile** | React Native, Flutter, mobile performance |\n| **testing** | Vitest, MSW, snapshot testing |\n\n#### Workflow (6)\n\n| Skill | Content |\n|-------|---------|\n| **code-review** | Review checklist, patterns |\n| **debug** | 4-phase debugging methodology |\n| **session-resume** | Context recovery |\n| **compound-docs** | Knowledge documentation |\n| **file-todos** | Task tracking |\n| **examples** | Supabase, integrations |\n\n---\n\n## โจ๏ธ Commands\n\n### ๐ Core Workflow\n\n**Slash Commands:**\n| Command | Description | Example |\n|---------|-------------|---------|\n| `/plan` | Create detailed implementation plan | `/plan Add user authentication` |\n| `/review` | Code review with Reviewer Agent | `/review src/api/auth.ts` |\n| `/cook` | Full dev cycle (planโcodeโtestโreview) | `/cook Add login feature` |\n\n**Workflows (type name or use `/workflow`):**\n| Workflow | Description |\n|----------|-------------|\n| `explore` | Research before implementing |\n| `work` | Execute plan step by step |\n| `compound` | Document solution for future use |\n| `housekeeping` | Cleanup before git push |\n| `cycle` | Run full workflow cycle |\n\n### ๐ป Development\n\n| Command | Description | Example |\n|---------|-------------|---------|\n| `/code` | Write code for a task | `/code Create UserService class` |\n| `/code-preview` | Preview code before applying | `/code-preview` |\n| `/cook` | Full development cycle (planโcodeโtestโreview) | `/cook Add login feature` |\n| `/debug` | Debug issues with root cause analysis | `/debug Why API returns 500?` |\n| `/fix` | Quick fix for errors | `/fix ESLint errors in src/utils` |\n| `/test` | Write and run tests | `/test Write tests for UserService` |\n| `/fullstack` | End-to-end feature development | `/fullstack Build user dashboard` |\n\n### ๐ Documentation & Content\n\n| Command | Description | Example |\n|---------|-------------|---------|\n| `/doc` | Update folder documentation | `/doc src/services` |\n| `/docs` | Generate documentation | `/docs Create API reference` |\n| `/adr` | Create Architecture Decision Record | `/adr Use PostgreSQL over MySQL` |\n| `/changelog` | Generate changelog from commits | `/changelog` |\n| `/content` | Create content (tutorials, guides) | `/content Write auth tutorial` |\n| `/copywrite` | Marketing copy | `/copywrite Landing page hero text` |\n| `/journal` | Development journal | `/journal` |\n\n### ๐ Git & PR\n\n| Command | Description | Example |\n|---------|-------------|---------|\n| `/git` | Git operations | `/git commit \"feat: add auth\"` |\n| `/pr` | Create Pull Request | `/pr Create PR for feature` |\n| `/review-pr` | Review Pull Request | `/review-pr 123` |\n\n### ๐ Exploration & Research\n\n| Command | Description | Example |\n|---------|-------------|---------|\n| `/scout` | Explore codebase structure | `/scout src/services` |\n| `/scout-ext` | Extended scout with dependencies | `/scout-ext` |\n| `/research` | Research technologies | `/research Compare React vs Vue` |\n| `/brainstorm` | Brainstorm ideas | `/brainstorm Authentication approaches` |\n\n### ๐จ Design & UI\n\n| Command | Description | Example |\n|---------|-------------|---------|\n| `/design` | UI/UX design guidance | `/design Create dashboard layout` |\n| `/video` | Video content planning | `/video` |\n| `/screenshot` | Screenshot annotation | `/screenshot` |\n\n### ๐๏ธ Database & Integration\n\n| Command | Description | Example |\n|---------|-------------|---------|\n| `/db` | Database operations | `/db Design user schema` |\n| `/integrate` | Integration planning | `/integrate Stripe payment` |\n| `/ticket` | Get ticket details (Jira/Linear) | `/ticket ABC-123` |\n\n### ๐ ๏ธ Project Management\n\n| Command | Description | Example |\n|---------|-------------|---------|\n| `/pm` | Project management | `/pm Sprint planning` |\n| `/project` | Project overview | `/project` |\n| `/status` | Show project status | `/status` |\n| `/kit-setup` | Initialize project context | `/kit-setup` |\n\n### โก Workflows (via `/workflow` command)\n\n> **Note**: These are workflow guides in `.agent/workflows/`. Run them using `/workflow [name]` or just type the workflow name as a prompt.\n\n| Workflow | Description |\n|----------|-------------|\n| `explore` | Deep research before planning |\n| `plan-compound` | Create plan with solution search |\n| `work` | Execute plan step by step |\n| `review-compound` | Multi-pass code review |\n| `compound` | Document solution for reuse |\n| `housekeeping` | Cleanup before git push |\n| `specs` | Create multi-session specifications |\n| `triage` | Triage review findings |\n| `report-bug` | Report bugs with reproduction steps |\n| `adr` | Create Architecture Decision Record |\n| `changelog` | Generate changelog from commits |\n| `kit-setup` | Initialize project context |\n\n### ๐ง Utilities\n\n| Command | Description |\n|---------|-------------|\n| `/help` | Show all commands |\n| `/ask` | Quick Q&A |\n| `/chat` | Free chat |\n| `/do` | Execute task |\n| `/use` | Use specific agent |\n| `/session` | Manage session |\n| `/team` | Team orchestration |\n| `/workflow` | Run specific workflow |\n| `/mcp` | MCP tool operations |\n| `/skill` | View/manage skills |\n| `/watzup` | Quick status check |\n\n---\n\n## ๐ง MCP Tools\n\n### Core Tools\n\n| Tool | Function |\n|------|----------|\n| `kit_create_checkpoint` | Git checkpoint before changes |\n| `kit_restore_checkpoint` | Rollback to checkpoint |\n| `kit_get_project_context` | Get project information |\n| `kit_handoff_agent` | Transfer context between agents |\n\n### Knowledge Tools\n\n| Tool | Function |\n|------|----------|\n| `kit_save_learning` | Save feedback for AI learning |\n| `kit_get_learnings` | Get saved learnings |\n| `kit_index_codebase` | Index codebase for search |\n| `kit_keyword_search` | Search in codebase |\n\n### Integration Tools\n\n| Tool | Function |\n|------|----------|\n| `kit_github_create_pr` | Create GitHub PR |\n| `kit_github_get_issue` | Get issue details |\n| `kit_jira_get_ticket` | Get Jira ticket info |\n\n---\n\n## ๐ Security\n\n### Secret Detection (30+ patterns)\n\nReal-time blocking BEFORE AI writes code:\n\n| Category | Patterns |\n|----------|----------|\n| Cloud | AWS Access Keys, AWS Secrets |\n| Code Hosting | GitHub PAT, GitLab Tokens, npm tokens |\n| AI Providers | OpenAI, Anthropic, Google API Keys |\n| Auth | Bearer tokens, JWT secrets |\n| Keys | RSA, SSH, EC Private Keys |\n| Database | MongoDB, PostgreSQL, MySQL connection strings |\n| Communication | Slack tokens, webhooks |\n\n### Command Blocking\n\n- ๐ซ `rm -rf /`, `rm -rf ~`, `rm -rf *`\n- ๐ซ Fork bombs (`:(){:|:&};:`)\n- ๐ซ Pipe to shell (`curl | sh`, `wget | bash`)\n- ๐ซ Dangerous disk operations (`dd if=`, `mkfs.`)\n\n### Path Traversal Protection\n\n- ๐ซ `../` path traversal\n- ๐ซ `/etc/passwd`, `/etc/shadow`\n- ๐ซ `~/.ssh/` files\n- ๐ซ `.env`, `.pem`, `.key` files\n\n---\n\n## ๐ข Notifications\n\n| Integration | Description |\n|-------------|-------------|\n| ๐ฌ **Discord** | Webhook notifications |\n| โ๏ธ **Telegram** | Bot notifications |\n| ๐ **Session Hooks** | Before/After agent actions |\n\n---\n\n## โ FAQ\n\n### Is Gemini-Kit free?\nโ **Yes**, completely free and open source (MIT License).\n\n### Do I need an API key?\nConfigure **Gemini CLI** with your Google account. No separate API key needed.\n\n### Which languages are supported?\nโ TypeScript, JavaScript, Python, Go, Rust, Java, C++, and more.\n\n### Which OS is supported?\nโ macOS, Linux, Windows (WSL recommended)\n\n---\n\n## ๐ Stats (v4.0.0)\n\n| Metric | Value |\n|--------|-------|\n| Tests | 291 passing |\n| Lint | 0 errors |\n| Agents | 27 |\n| Skills | 15 categories |\n| Commands | 45 |\n| Workflows | 33 |\n| Scripts | 50+ |\n| Coverage | ~81% |\n\n---\n\n## ๐ค Contributing\n\nContributions welcome!\n\n1. Fork the repo\n2. Create branch (`git checkout -b feature/amazing-feature`)\n3. Commit changes (`git commit -m 'Add amazing feature'`)\n4. Push (`git push origin feature/amazing-feature`)\n5. Create Pull Request\n\n---\n\n## ๐ License\n\nMIT ยฉ 2024-2026\n\n---\n\n
\n Made with โค๏ธ by the Gemini-Kit Team \n GitHub โข\n Releases โข\n Issues\n