Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nth5693--gemini-kit/badge.svg)](/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

i

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)

  1. # ๐Ÿš€ Gemini-Kit
  2. <div align="center">
  3. [![Version](https://img.shields.io/badge/version-4.0.0-blue.svg)](https://github.com/nth5693/gemini-kit/releases)
  4. [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
  5. [![Tests](https://img.shields.io/badge/tests-291%20passed-brightgreen.svg)]()
  6. [![Agents](https://img.shields.io/badge/AI%20Agents-27-purple.svg)]()
  7. [![Skills](https://img.shields.io/badge/Skills-15-orange.svg)]()
  8. [![Commands](https://img.shields.io/badge/Commands-45-yellow.svg)]()
  9. [![Workflows](https://img.shields.io/badge/Workflows-33-cyan.svg)]()
  10. ### ๐ŸŽฏ Transform Your Terminal into an AI Engineering Team
  11. **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.
  12. [๐Ÿš€ Quick Start](#-quick-start) โ€ข [๐Ÿค– Agents](#-agents) โ€ข [๐Ÿ› ๏ธ Skills](#๏ธ-skills) โ€ข [โŒจ๏ธ Commands](#๏ธ-commands) โ€ข [๐Ÿ“š API](docs/API.md)
  13. </div>
  14. ---
  15. ## ๐Ÿ“‹ Table of Contents
  16. - [What is Gemini-Kit?](#-what-is-gemini-kit)
  17. - [Quick Start](#-quick-start)
  18. - [Agents](#-agents)
  19. - [Skills](#๏ธ-skills)
  20. - [Commands](#๏ธ-commands)
  21. - [MCP Tools](#-mcp-tools)
  22. - [Security](#-security)
  23. - [FAQ](#-faq)
  24. ---
  25. ## ๐Ÿค” What is Gemini-Kit?
  26. **Gemini-Kit** transforms Gemini CLI into a **virtual engineering team** with:
  27. | Feature | Count | Description |
  28. |---------|-------|-------------|
  29. | ๐Ÿค– **AI Agents** | 27 | Specialized roles (Security, Frontend, Backend, DevOps...) |
  30. | ๐Ÿ› ๏ธ **Skills** | 15 | Knowledge modules (React, Next.js, Docker, Security...) |
  31. | โŒจ๏ธ **Commands** | 45 | Slash commands for every workflow |
  32. | ๐Ÿ”„ **Workflows** | 33 | Structured development workflows |
  33. | ๐Ÿ”’ **Security** | 30+ | Secret detection patterns |
  34. | ๐Ÿ“œ **Scripts** | 50+ | Automation scripts |
  35. ### Key Features
  36. - **๐Ÿ”„ Compound System**: `/explore โ†’ /plan โ†’ /work โ†’ /review โ†’ /compound` - Each iteration builds a Knowledge Base. Solutions are saved and reused!
  37. - **๐Ÿง  Learning System**: AI learns from your feedback. Correct once, it remembers forever
  38. - **๐Ÿ“š 23 Critical Patterns**: Common mistakes documented as patterns - AI reads them before coding
  39. - **๐ŸŽฏ Multi-agent Orchestration**: Orchestrator coordinates multiple agents for complex tasks
  40. - **๐Ÿ’พ Auto-checkpoint**: Automatic Git backup before changes
  41. - **๐Ÿ”’ Security Hooks**: Real-time blocking of secrets (30+ patterns)
  42. - **๐Ÿ“ข Notifications**: Discord & Telegram integration
  43. ---
  44. ## ๐Ÿš€ Quick Start
  45. ### Prerequisites
  46. | Requirement | Version | Check |
  47. |-------------|---------|-------|
  48. | Node.js | โ‰ฅ 18.0 | `node --version` |
  49. | Git | โ‰ฅ 2.0 | `git --version` |
  50. | Gemini CLI | Latest | `gemini --version` |
  51. ### Installation (2 minutes)
  52. ```bash
  53. # 1. Clone repository
  54. git clone https://github.com/nth5693/gemini-kit.git ~/.gemini/extensions/gemini-kit
  55. # 2. Install & build
  56. cd ~/.gemini/extensions/gemini-kit
  57. npm install && npm run build
  58. # 3. Link extension
  59. gemini extensions link $(pwd)
  60. ```
  61. ### First Run
  62. ```bash
  63. # Go to your project
  64. cd /path/to/your/project
  65. # Start Gemini CLI
  66. gemini
  67. # Try these commands:
  68. > /status # Check project status
  69. > /explore React # Research a topic
  70. > /plan Add auth # Create implementation plan
  71. ```
  72. ### Update
  73. ```bash
  74. cd ~/.gemini/extensions/gemini-kit
  75. git pull && npm install && npm run build
  76. ```
  77. ---
  78. ## ๐Ÿค– Agents
  79. ### 27 Specialized AI Agents
  80. #### Core Development (5)
  81. | Agent | Role | When to Use |
  82. |-------|------|-------------|
  83. | ๐Ÿ“‹ **Planner** | Create detailed plans | Starting new features |
  84. | ๐Ÿ” **Scout** | Explore codebase | New projects, onboarding |
  85. | ๐Ÿ’ป **Coder** | Write clean code | Implementing features |
  86. | ๐Ÿงช **Tester** | Write & run tests | Quality assurance |
  87. | ๐Ÿ‘€ **Reviewer** | Code review | Before merging PRs |
  88. #### Specialists (12) - NEW in v4.0
  89. | Agent | Role | When to Use |
  90. |-------|------|-------------|
  91. | ๐Ÿ” **Security Auditor** | Security audit, OWASP | Security reviews |
  92. | โš›๏ธ **Frontend Specialist** | React, Next.js, UI/UX | Frontend development |
  93. | ๐Ÿ–ฅ๏ธ **Backend Specialist** | API, Database, Docker | Backend development |
  94. | ๐Ÿš€ **DevOps Engineer** | CI/CD, K8s, GitHub Actions | Infrastructure |
  95. | ๐Ÿ› **Debugger** | Root cause analysis | Runtime errors |
  96. | ๐Ÿ—„๏ธ **Database Admin** | Schema, migrations | Database work |
  97. | ๐ŸŽจ **UI Designer** | Design, animations | UI/UX |
  98. | ๐ŸŒ **Fullstack** | End-to-end | Full features |
  99. | ๐Ÿ“ฑ **Mobile Developer** | React Native, Flutter | Mobile apps |
  100. | ๐ŸŽฎ **Game Developer** | Unity, Godot | Game development |
  101. | โšก **Performance Optimizer** | Core Web Vitals, profiling | Performance issues |
  102. | ๐Ÿ”“ **Penetration Tester** | Security testing | Pentest |
  103. #### Support & Management (6)
  104. | Agent | Role | When to Use |
  105. |-------|------|-------------|
  106. | ๐Ÿ”€ **Git Manager** | Commits, branches | Version control |
  107. | ๐Ÿ“ **Docs Manager** | Documentation | README, API docs |
  108. | ๐Ÿ”ฌ **Researcher** | Research | Technology decisions |
  109. | ๐Ÿ’ก **Brainstormer** | Ideas | Problem solving |
  110. | ๐Ÿ“Š **Project Manager** | Sprint planning | Project management |
  111. | โœ๏ธ **Copywriter** | Marketing copy | Content |
  112. #### Specialized (4)
  113. | Agent | Role | When to Use |
  114. |-------|------|-------------|
  115. | ๐ŸŽฏ **Orchestrator** | Multi-agent coordination | Complex tasks |
  116. | ๐Ÿบ **Code Archaeologist** | Legacy code analysis | Refactoring old code |
  117. | ๐Ÿ‘ค **Product Owner** | Requirements, backlog | Product decisions |
  118. | ๐Ÿ“ˆ **SEO Specialist** | SEO/GEO optimization | SEO work |
  119. ### How to Use Agents
  120. ```bash
  121. # Mention agent in your request
  122. > Use the security-auditor agent to review authentication
  123. > Use the frontend-specialist to optimize React components
  124. > Use the backend-specialist to design API architecture
  125. ```
  126. ---
  127. ## ๐Ÿ› ๏ธ Skills
  128. ### 15 Knowledge Modules
  129. Skills are loaded automatically based on context and agent configuration.
  130. #### Frontend (4)
  131. | Skill | Content |
  132. |-------|---------|
  133. | **react-patterns** | Hooks, state management, component composition |
  134. | **nextjs** | App Router, Server Components, data fetching |
  135. | **tailwind** | Tailwind CSS v4, responsive design |
  136. | **performance** | Core Web Vitals, caching, optimization |
  137. #### Backend (3)
  138. | Skill | Content |
  139. |-------|---------|
  140. | **api-design** | RESTful patterns, validation, rate limiting |
  141. | **docker** | Multi-stage builds, Compose, container security |
  142. | **security** | OWASP Top 10, JWT, XSS/CSRF prevention |
  143. #### Mobile & Testing (2)
  144. | Skill | Content |
  145. |-------|---------|
  146. | **mobile** | React Native, Flutter, mobile performance |
  147. | **testing** | Vitest, MSW, snapshot testing |
  148. #### Workflow (6)
  149. | Skill | Content |
  150. |-------|---------|
  151. | **code-review** | Review checklist, patterns |
  152. | **debug** | 4-phase debugging methodology |
  153. | **session-resume** | Context recovery |
  154. | **compound-docs** | Knowledge documentation |
  155. | **file-todos** | Task tracking |
  156. | **examples** | Supabase, integrations |
  157. ---
  158. ## โŒจ๏ธ Commands
  159. ### ๐Ÿ”„ Core Workflow
  160. **Slash Commands:**
  161. | Command | Description | Example |
  162. |---------|-------------|---------|
  163. | `/plan` | Create detailed implementation plan | `/plan Add user authentication` |
  164. | `/review` | Code review with Reviewer Agent | `/review src/api/auth.ts` |
  165. | `/cook` | Full dev cycle (planโ†’codeโ†’testโ†’review) | `/cook Add login feature` |
  166. **Workflows (type name or use `/workflow`):**
  167. | Workflow | Description |
  168. |----------|-------------|
  169. | `explore` | Research before implementing |
  170. | `work` | Execute plan step by step |
  171. | `compound` | Document solution for future use |
  172. | `housekeeping` | Cleanup before git push |
  173. | `cycle` | Run full workflow cycle |
  174. ### ๐Ÿ’ป Development
  175. | Command | Description | Example |
  176. |---------|-------------|---------|
  177. | `/code` | Write code for a task | `/code Create UserService class` |
  178. | `/code-preview` | Preview code before applying | `/code-preview` |
  179. | `/cook` | Full development cycle (planโ†’codeโ†’testโ†’review) | `/cook Add login feature` |
  180. | `/debug` | Debug issues with root cause analysis | `/debug Why API returns 500?` |
  181. | `/fix` | Quick fix for errors | `/fix ESLint errors in src/utils` |
  182. | `/test` | Write and run tests | `/test Write tests for UserService` |
  183. | `/fullstack` | End-to-end feature development | `/fullstack Build user dashboard` |
  184. ### ๐Ÿ“š Documentation & Content
  185. | Command | Description | Example |
  186. |---------|-------------|---------|
  187. | `/doc` | Update folder documentation | `/doc src/services` |
  188. | `/docs` | Generate documentation | `/docs Create API reference` |
  189. | `/adr` | Create Architecture Decision Record | `/adr Use PostgreSQL over MySQL` |
  190. | `/changelog` | Generate changelog from commits | `/changelog` |
  191. | `/content` | Create content (tutorials, guides) | `/content Write auth tutorial` |
  192. | `/copywrite` | Marketing copy | `/copywrite Landing page hero text` |
  193. | `/journal` | Development journal | `/journal` |
  194. ### ๐Ÿ”€ Git & PR
  195. | Command | Description | Example |
  196. |---------|-------------|---------|
  197. | `/git` | Git operations | `/git commit "feat: add auth"` |
  198. | `/pr` | Create Pull Request | `/pr Create PR for feature` |
  199. | `/review-pr` | Review Pull Request | `/review-pr 123` |
  200. ### ๐Ÿ” Exploration & Research
  201. | Command | Description | Example |
  202. |---------|-------------|---------|
  203. | `/scout` | Explore codebase structure | `/scout src/services` |
  204. | `/scout-ext` | Extended scout with dependencies | `/scout-ext` |
  205. | `/research` | Research technologies | `/research Compare React vs Vue` |
  206. | `/brainstorm` | Brainstorm ideas | `/brainstorm Authentication approaches` |
  207. ### ๐ŸŽจ Design & UI
  208. | Command | Description | Example |
  209. |---------|-------------|---------|
  210. | `/design` | UI/UX design guidance | `/design Create dashboard layout` |
  211. | `/video` | Video content planning | `/video` |
  212. | `/screenshot` | Screenshot annotation | `/screenshot` |
  213. ### ๐Ÿ—„๏ธ Database & Integration
  214. | Command | Description | Example |
  215. |---------|-------------|---------|
  216. | `/db` | Database operations | `/db Design user schema` |
  217. | `/integrate` | Integration planning | `/integrate Stripe payment` |
  218. | `/ticket` | Get ticket details (Jira/Linear) | `/ticket ABC-123` |
  219. ### ๐Ÿ› ๏ธ Project Management
  220. | Command | Description | Example |
  221. |---------|-------------|---------|
  222. | `/pm` | Project management | `/pm Sprint planning` |
  223. | `/project` | Project overview | `/project` |
  224. | `/status` | Show project status | `/status` |
  225. | `/kit-setup` | Initialize project context | `/kit-setup` |
  226. ### โšก Workflows (via `/workflow` command)
  227. > **Note**: These are workflow guides in `.agent/workflows/`. Run them using `/workflow [name]` or just type the workflow name as a prompt.
  228. | Workflow | Description |
  229. |----------|-------------|
  230. | `explore` | Deep research before planning |
  231. | `plan-compound` | Create plan with solution search |
  232. | `work` | Execute plan step by step |
  233. | `review-compound` | Multi-pass code review |
  234. | `compound` | Document solution for reuse |
  235. | `housekeeping` | Cleanup before git push |
  236. | `specs` | Create multi-session specifications |
  237. | `triage` | Triage review findings |
  238. | `report-bug` | Report bugs with reproduction steps |
  239. | `adr` | Create Architecture Decision Record |
  240. | `changelog` | Generate changelog from commits |
  241. | `kit-setup` | Initialize project context |
  242. ### ๐Ÿ”ง Utilities
  243. | Command | Description |
  244. |---------|-------------|
  245. | `/help` | Show all commands |
  246. | `/ask` | Quick Q&A |
  247. | `/chat` | Free chat |
  248. | `/do` | Execute task |
  249. | `/use` | Use specific agent |
  250. | `/session` | Manage session |
  251. | `/team` | Team orchestration |
  252. | `/workflow` | Run specific workflow |
  253. | `/mcp` | MCP tool operations |
  254. | `/skill` | View/manage skills |
  255. | `/watzup` | Quick status check |
  256. ---
  257. ## ๐Ÿ”ง MCP Tools
  258. ### Core Tools
  259. | Tool | Function |
  260. |------|----------|
  261. | `kit_create_checkpoint` | Git checkpoint before changes |
  262. | `kit_restore_checkpoint` | Rollback to checkpoint |
  263. | `kit_get_project_context` | Get project information |
  264. | `kit_handoff_agent` | Transfer context between agents |
  265. ### Knowledge Tools
  266. | Tool | Function |
  267. |------|----------|
  268. | `kit_save_learning` | Save feedback for AI learning |
  269. | `kit_get_learnings` | Get saved learnings |
  270. | `kit_index_codebase` | Index codebase for search |
  271. | `kit_keyword_search` | Search in codebase |
  272. ### Integration Tools
  273. | Tool | Function |
  274. |------|----------|
  275. | `kit_github_create_pr` | Create GitHub PR |
  276. | `kit_github_get_issue` | Get issue details |
  277. | `kit_jira_get_ticket` | Get Jira ticket info |
  278. ---
  279. ## ๐Ÿ”’ Security
  280. ### Secret Detection (30+ patterns)
  281. Real-time blocking BEFORE AI writes code:
  282. | Category | Patterns |
  283. |----------|----------|
  284. | Cloud | AWS Access Keys, AWS Secrets |
  285. | Code Hosting | GitHub PAT, GitLab Tokens, npm tokens |
  286. | AI Providers | OpenAI, Anthropic, Google API Keys |
  287. | Auth | Bearer tokens, JWT secrets |
  288. | Keys | RSA, SSH, EC Private Keys |
  289. | Database | MongoDB, PostgreSQL, MySQL connection strings |
  290. | Communication | Slack tokens, webhooks |
  291. ### Command Blocking
  292. - ๐Ÿšซ `rm -rf /`, `rm -rf ~`, `rm -rf *`
    • Dismissed after review: Runs `rm -rf` against a root or home-directory path
    • Line 385 on GitHub
  293. - ๐Ÿšซ Fork bombs (`:(){:|:&};:`)
  294. - ๐Ÿšซ Pipe to shell (`curl | sh`, `wget | bash`)
  295. - ๐Ÿšซ Dangerous disk operations (`dd if=`, `mkfs.`)
  296. ### Path Traversal Protection
  297. - ๐Ÿšซ `../` path traversal
  298. - ๐Ÿšซ `/etc/passwd`, `/etc/shadow`
  299. - ๐Ÿšซ `~/.ssh/` files
  300. - ๐Ÿšซ `.env`, `.pem`, `.key` files
  301. ---
  302. ## ๐Ÿ“ข Notifications
  303. | Integration | Description |
  304. |-------------|-------------|
  305. | ๐Ÿ’ฌ **Discord** | Webhook notifications |
  306. | โœ‰๏ธ **Telegram** | Bot notifications |
  307. | ๐Ÿ”” **Session Hooks** | Before/After agent actions |
  308. ---
  309. ## โ“ FAQ
  310. ### Is Gemini-Kit free?
  311. โœ… **Yes**, completely free and open source (MIT License).
  312. ### Do I need an API key?
  313. Configure **Gemini CLI** with your Google account. No separate API key needed.
  314. ### Which languages are supported?
  315. โœ… TypeScript, JavaScript, Python, Go, Rust, Java, C++, and more.
  316. ### Which OS is supported?
  317. โœ… macOS, Linux, Windows (WSL recommended)
  318. ---
  319. ## ๐Ÿ“Š Stats (v4.0.0)
  320. | Metric | Value |
  321. |--------|-------|
  322. | Tests | 291 passing |
  323. | Lint | 0 errors |
  324. | Agents | 27 |
  325. | Skills | 15 categories |
  326. | Commands | 45 |
  327. | Workflows | 33 |
  328. | Scripts | 50+ |
  329. | Coverage | ~81% |
  330. ---
  331. ## ๐Ÿค Contributing
  332. Contributions welcome!
  333. 1. Fork the repo
  334. 2. Create branch (`git checkout -b feature/amazing-feature`)
  335. 3. Commit changes (`git commit -m 'Add amazing feature'`)
  336. 4. Push (`git push origin feature/amazing-feature`)
  337. 5. Create Pull Request
  338. ---
  339. ## ๐Ÿ“„ License
  340. MIT ยฉ 2024-2026
  341. ---
  342. <p align="center">
  343. Made with โค๏ธ by the Gemini-Kit Team<br>
  344. <a href="https://github.com/nth5693/gemini-kit">GitHub</a> โ€ข
  345. <a href="https://github.com/nth5693/gemini-kit/releases">Releases</a> โ€ข
  346. <a href="https://github.com/nth5693/gemini-kit/issues">Issues</a>
  347. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If itโ€™s helped, pass it on.