🚀 Gemini-Kit

🎯 Turn Your Terminal Into an AI Engineering Team

Gemini-Kit is an extension for Gemini CLI that brings 15 specialized AI agents to help you code 10x faster.

🚀 Installation • 📖 Usage • 🤖 Agents • ⌨️ Commands • 📚 API

📋 Table of Contents

What is Gemini-Kit?
How It Works
Benefits
Installation
Usage
Agents
All Commands
MCP Tools
FAQ

📖 Documentation

Guide	Description
🚀 Quick Start	Start in 5 minutes
📚 Features Reference	All detailed features
🔄 Workflows Guide	Workflow guide
🎯 Best Practices	Tips and troubleshooting
📡 API Reference	MCP tools API

🤔 What is Gemini-Kit?

Gemini-Kit is an extension for Gemini CLI that transforms your terminal into a virtual engineering office with 15 specialized AI agents:

Agent	Role
📋 Planner	Create plans, break down tasks
🔍 Scout	Explore and analyze codebase
💻 Coder	Write clean, efficient code
🧪 Tester	Create unit & integration tests
👀 Reviewer	Code review, find bugs
🐛 Debugger	Debug complex issues
🔀 Git Manager	Manage Git, commits, branches
🗄️ Database Admin	Schema design, queries
🔬 Researcher	Research new technologies
🎨 UI Designer	Design UI/UX
📝 Docs Manager	Write documentation
💡 Brainstormer	Brainstorm ideas
🌐 Fullstack Dev	End-to-end development
📊 Project Manager	Project management
✍️ Copywriter	Write marketing content

Key Features

42 slash commands for every situation
One-command workflow: /cook = Plan → Scout → Code → Test → Review
Auto-checkpoint: Automatic backup before changes
Learning System: AI learns from your feedback
Security Hooks: Block secret leaks (30+ patterns)

⚙️ How It Works

┌─────────────────────────────────────────────────────────────────┐
│                        GEMINI-KIT ARCHITECTURE                  │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ┌──────────────┐    ┌──────────────┐    ┌──────────────┐      │
│  │   GEMINI     │───▶│  GEMINI-KIT  │───▶│  MCP SERVER  │      │
│  │     CLI      │    │  EXTENSION   │    │  (15 Tools)  │      │
│  └──────────────┘    └──────────────┘    └──────────────┘      │
│         │                   │                   │               │
│         ▼                   ▼                   ▼               │
│  ┌──────────────┐    ┌──────────────┐    ┌──────────────┐      │
│  │  42 COMMANDS │    │   15 AGENTS  │    │    HOOKS     │      │
│  │  /cook /plan │    │ Planner,Coder│    │ before-tool  │      │
│  │  /scout /test│    │ Tester,Scout │    │ after-tool   │      │
│  └──────────────┘    └──────────────┘    └──────────────┘      │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

The `/cook` Workflow (Full Development Cycle)

📋 PLAN     →  🔍 SCOUT   →  💻 CODE    →  🧪 TEST    →  👀 REVIEW
Create      Find relevant   Implement    Write &      Code review
plan        files           solution     run tests   & quality

🔄 Compound Loop (Advanced)

/explore → /plan → /work → /review → /compound → /housekeeping
    │                                      │
    │                                      ▼
    └─────────────── Knowledge compounds ──┘

Each iteration → Knowledge accumulates → Next iteration is easier!

💎 Benefits

❌ Before Gemini-Kit

😩 Coding alone, no support
😩 Debugging for hours
😩 Forgetting to write tests
😩 Accidentally committing API keys
😩 Repeating workflows manually
😩 Onboarding takes weeks

✅ After Gemini-Kit

🚀 15 AI agents available 24/7
🚀 Debugger finds root cause
🚀 Tester writes tests automatically
🚀 Blocks secrets BEFORE commit
🚀 /cook automates everything
🚀 /scout analyzes codebase in minutes

Time Savings

Task	Manual	With Gemini-Kit
Analyze new codebase	2-4 hours	5 min (`/scout`)
Plan a feature	1-2 hours	10 min (`/plan`)
Implement + Test + Review	1 day	1-2 hours (`/cook`)
Debug complex issue	2-4 hours	30 min (`/debug`)
Write documentation	2-3 hours	20 min (`/docs`)

📦 Installation

System Requirements

Requirement	Version	Check
Node.js	≥ 18.0	`node --version`
Git	≥ 2.0	`git --version`
npm	≥ 8.0	`npm --version`

Step 1: Install Gemini CLI

# macOS / Linux
npm install -g @anthropics/gemini-cli

# Windows (PowerShell as Admin)
npm install -g @anthropics/gemini-cli

# Verify installation
gemini --version

First run will prompt for configuration:

# Run for the first time
gemini

# Follow prompts to:
# 1. Sign in with Google account
# 2. Authorize Gemini CLI

Step 2: Install Gemini-Kit Extension

# Clone the repository
git clone https://github.com/nth5693/gemini-kit.git ~/.gemini/extensions/gemini-kit

# Navigate to directory
cd ~/.gemini/extensions/gemini-kit

# Install dependencies and build
npm install && npm run build

# Link extension
gemini extensions link $(pwd)

Step 3: Verify Installation

# Go to your project
cd /path/to/your/project

# Start Gemini
gemini

# Try a command
> /help

# If you see the command list → Success! 🎉

Update to Latest Version

cd ~/.gemini/extensions/gemini-kit
git pull origin main
npm install && npm run build

💻 Usage

Basic Workflow

# 1. Navigate to your project
cd my-project

# 2. Start Gemini
gemini

# 3. Use commands
> /cook Add user authentication with JWT

Common Scenarios

🆕 Starting a New Feature

# Plan first
> /plan Add user authentication with JWT

# Or run full workflow
> /cook Implement JWT authentication

🐛 Fixing a Bug

# Debug the issue
> /debug Why does API return 500 when uploading large files?

# Or quick fix
> /fix TypeError: Cannot read property 'id' of undefined at line 42

🔍 Exploring a New Codebase

# Analyze entire project
> /scout

# Focus on specific directory
> /scout src/services

📝 Writing Documentation

# Generate README
> /docs Generate README for this project

# Create API docs
> /docs Create API documentation for src/api

🤖 Agents

Core Agents

Agent	File	Function	When to Use
📋 Planner	`agents/planner.md`	Create detailed plans with timeline	Starting new features
🔍 Scout	`agents/scout.md`	Analyze codebase structure	New projects, onboarding
💻 Coder	`agents/coder.md`	Write clean code	Implementing features
🧪 Tester	`agents/tester.md`	Write tests, ensure coverage	Quality assurance
👀 Reviewer	`agents/reviewer.md`	Code review, find bugs	Before merging PRs

Specialized Agents

Agent	Function	When to Use
🐛 Debugger	Root cause analysis	Runtime errors
🔀 Git Manager	Commit, branch strategy	Version control
🗄️ Database Admin	Schema design, migrations	Database work
🔬 Researcher	Research packages	Technology decisions
🎨 UI Designer	Dark mode, animations	Frontend UI/UX
📝 Docs Manager	README, API docs	Documentation
💡 Brainstormer	Brainstorm ideas	Problem solving
🌐 Fullstack	End-to-end implementation	Full features
📊 PM	Sprint planning	Project management
✍️ Copywriter	Marketing copy	Content creation

⌨️ All Commands

🍳 Workflow Commands

Command	Description	Example
`/cook`	Full development cycle	`/cook Add payment integration`
`/plan`	Create detailed plan	`/plan Migrate to PostgreSQL`
`/scout`	Explore codebase	`/scout src/services`
`/code`	Implement code	`/code Create UserService class`
`/test`	Write and run tests	`/test Write tests for auth module`
`/review`	Code review	`/review src/api/users.ts`

🐛 Debug & Fix

Command	Description	Example
`/debug`	Analyze and fix bugs	`/debug Memory leak in handler`
`/fix`	Quick fix	`/fix ESLint errors in src/utils`

📚 Documentation

Command	Description	Example
`/docs`	Create/update docs	`/docs Generate API reference`
`/content`	Create content	`/content Write auth tutorial`

🔀 Git

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`

🛠️ Utilities

Command	Description
`/help`	Show help
`/session`	Manage session
`/team`	Team orchestration
`/workflow`	Run specific workflow
`/ask`	Quick Q&A
`/chat`	Free chat

🔧 MCP Tools

Core Tools

Tool	Function
`kit_create_checkpoint`	Create 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 Features

Secret Detection (30+ patterns)

✅ AWS Access Keys
✅ GitHub Tokens
✅ OpenAI API Keys
✅ Private Keys
✅ Database Connection Strings

Dangerous Command Blocking

🚫 rm -rf /
🚫 Fork bombs
🚫 curl | sh

❓ FAQ

Is Gemini-Kit free?

✅ Yes, completely free and open source (MIT License).

Do I need an API key?

You need to configure Gemini CLI with your Google account. No separate API key needed.

Which languages are supported?

✅ TypeScript, JavaScript, Python, Go, Rust, Java, and many more.

Which OS is supported?

✅ macOS, Linux, Windows (WSL recommended)

🤝 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

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

Name		Name	Last commit message	Last commit date
Latest commit History 183 Commits
.agent		.agent
.gemini-kit		.gemini-kit
agents		agents
commands		commands
dist		dist
docs		docs
hooks		hooks
plans		plans
release		release
scripts		scripts
skills		skills
src		src
todos		todos
.gitignore		.gitignore
.prettierrc		.prettierrc
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
GEMINI.md		GEMINI.md
LICENSE		LICENSE
QUICKSTART.md		QUICKSTART.md
README.md		README.md
eslint.config.js		eslint.config.js
gemini-extension.json		gemini-extension.json
package-lock.json		package-lock.json
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
settings.json		settings.json
tsconfig.json		tsconfig.json
vitest.config.ts		vitest.config.ts

Folders and files

Latest commit

History

Repository files navigation

🚀 Gemini-Kit

🎯 Turn Your Terminal Into an AI Engineering Team

📋 Table of Contents

📖 Documentation

🤔 What is Gemini-Kit?

Key Features

⚙️ How It Works

The /cook Workflow (Full Development Cycle)

🔄 Compound Loop (Advanced)

💎 Benefits

❌ Before Gemini-Kit

✅ After Gemini-Kit

Time Savings

📦 Installation

System Requirements

Step 1: Install Gemini CLI

Step 2: Install Gemini-Kit Extension

Step 3: Verify Installation

Update to Latest Version

💻 Usage

Basic Workflow

Common Scenarios

🆕 Starting a New Feature

🐛 Fixing a Bug

🔍 Exploring a New Codebase

📝 Writing Documentation

🤖 Agents

Core Agents

Specialized Agents

⌨️ All Commands

🍳 Workflow Commands

🐛 Debug & Fix

📚 Documentation

🔀 Git

🛠️ Utilities

🔧 MCP Tools

Core Tools

Knowledge Tools

Integration Tools

🔒 Security Features

Secret Detection (30+ patterns)

Dangerous Command Blocking

❓ FAQ

Is Gemini-Kit free?

Do I need an API key?

Which languages are supported?

Which OS is supported?

🤝 Contributing

📄 License

About

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

The `/cook` Workflow (Full Development Cycle)

Packages