explaingit

josephhampton/awesome-gemini-cli-subagents

Analysis updated 2026-05-18

46ShellAudience · developerComplexity · 1/5LicenseSetup · easy

TLDR

A library of 51 ready-made specialist AI helpers for Gemini CLI, covering coding, security, testing, and infrastructure.

Mindmap

mindmap
  root((repo))
    What it does
      Provides specialist subagents
      Auto-delegates tasks
      Scopes tools per agent
    Tech stack
      Shell
      Gemini CLI
      Markdown frontmatter
    Use cases
      Security code review
      Write tests automatically
    Audience
      Developers
      DevOps teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Delegate a security review of a code diff to the security-auditor subagent automatically.

USE CASE 2

Install a focused test-automator agent that only writes meaningful unit and integration tests.

USE CASE 3

Use language specific agents like rust-pro or react-pro for idiomatic code in that language.

USE CASE 4

Share a curated set of project-level subagents with your team for consistent workflows.

What is it built with?

ShellGemini CLIMarkdown

How does it compare?

josephhampton/awesome-gemini-cli-subagentsgsvps/gsnodehailoc12/ai_native_company
Stars464646
LanguageShellShellShell
Setup difficultyeasyeasyeasy
Complexity1/52/51/5
Audiencedeveloperops devopspm founder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires an existing Gemini CLI installation to use the subagents.

This work is placed in the public domain. You may use, copy, modify, and distribute it for any purpose without asking permission.

In plain English

This repository is a curated library of 51 ready made specialist helpers, called subagents, for Gemini CLI. Gemini CLI is a command line tool that can hand off parts of a task to smaller, focused assistants instead of doing everything itself, and this project gives you a large set of those assistants already written and ready to drop into your setup. Each subagent is a single markdown file that defines one area of expertise, such as reviewing code for security problems, writing tests, designing an API, working with Kubernetes, or reviewing a Rust project. Every subagent gets its own separate conversation space so a big task does not clutter your main chat, and each one only has access to the specific tools it needs, so for example a security reviewing agent can be limited to only reading files, never writing them. The collection is organized into nine groups covering things like core application development, specific programming languages, cloud infrastructure and DevOps, testing and quality, security, data and AI work, developer tooling, specialized domains, and higher level product or orchestration roles. Because each subagent is defined with a name, a description of when to use it, an optional list of allowed tools, and settings like which model or temperature to use, Gemini CLI can automatically pick the right one when you describe a task in plain language. Getting started just means cloning the repository and running an install script that copies every agent into a shared folder on your computer, so they become available in any project you work on. You can also copy individual agent files into a specific project folder if you only want a few of them, or if you want to share a particular set with your team. Once installed, you simply describe what you want, such as asking to review a code change for security issues, and Gemini CLI delegates that request to the matching specialist automatically. The project is released under the CC0 public domain license, so it is free for anyone to use, copy, or build on without restriction.

Copy-paste prompts

Prompt 1
Help me install all 51 subagents from this repo into my Gemini CLI setup.
Prompt 2
Show me how to copy just the code-reviewer and security-auditor agents into my project's .gemini/agents folder.
Prompt 3
Explain the frontmatter fields I need to write my own custom Gemini CLI subagent.
Prompt 4
Which subagent in this collection should I use to review my Terraform infrastructure code?

Frequently asked questions

What is awesome-gemini-cli-subagents?

A library of 51 ready-made specialist AI helpers for Gemini CLI, covering coding, security, testing, and infrastructure.

What language is awesome-gemini-cli-subagents written in?

Mainly Shell. The stack also includes Shell, Gemini CLI, Markdown.

What license does awesome-gemini-cli-subagents use?

This work is placed in the public domain. You may use, copy, modify, and distribute it for any purpose without asking permission.

How hard is awesome-gemini-cli-subagents to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is awesome-gemini-cli-subagents for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.