gemini-kit
๐ 19 AI Agents + 44 Commands for Gemini CLI - Code 10x faster with auto planning, testing, review & security
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/nth5693--gemini-kit)HTML
<a href="/listings/nth5693--gemini-kit"><img src="/api/listings/nth5693--gemini-kit/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md ยท README ยท 463 lines ยท 2 findings marked
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # ๐ Gemini-Kit
- <div align="center">
- [](https://github.com/nth5693/gemini-kit/releases)
- [](LICENSE)
- []()
- []()
- []()
- []()
- []()
- ### ๐ฏ Transform Your Terminal into an AI Engineering Team
- **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.
- [๐ Quick Start](#-quick-start) โข [๐ค Agents](#-agents) โข [๐ ๏ธ Skills](#๏ธ-skills) โข [โจ๏ธ Commands](#๏ธ-commands) โข [๐ API](docs/API.md)
- </div>
- ---
- ## ๐ Table of Contents
- - [What is Gemini-Kit?](#-what-is-gemini-kit)
- - [Quick Start](#-quick-start)
- - [Agents](#-agents)
- - [Skills](#๏ธ-skills)
- - [Commands](#๏ธ-commands)
- - [MCP Tools](#-mcp-tools)
- - [Security](#-security)
- - [FAQ](#-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)
- ```bash
- # 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
- ```bash
- # 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
- ```bash
- 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
- ```bash
- # 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 *`
- Dismissed after review: Runs `rm -rf` against a root or home-directory path
- Line 385 on GitHub
- - ๐ซ Fork bombs (`:(){:|:&};:`)
- Dismissed after review: Matches a classic shell fork-bomb pattern
- Line 386 on GitHub
- - ๐ซ 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
- ---
- <p align="center">
- Made with โค๏ธ by the Gemini-Kit Team<br>
- <a href="https://github.com/nth5693/gemini-kit">GitHub</a> โข
- <a href="https://github.com/nth5693/gemini-kit/releases">Releases</a> โข
- <a href="https://github.com/nth5693/gemini-kit/issues">Issues</a>
- </p>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If itโs helped, pass it on.