🚀 Gemini-Kit

---

📋 Table of Contents

• What is Gemini-Kit?
• Quick Start
• Agents
• Skills
• Commands
• MCP Tools
• Security
• FAQ

---

🤔 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!

1. Fork the repo
2. Create branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push (git push origin feature/amazing-feature)
5. Create Pull Request

---

📄 License

MIT © 2024-2026

---

Made with ❤️ by the Gemini-Kit Team
GitHub • Releases • Issues