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