Awesome Gemini CLI Subagents plugin

A library of 89 subagents for Gemini CLI and Antigravity CLI: review, security, testing, DevOps, data and language experts.

  • 108 ★ on the repository
  • Last commit
  • CC0-1.0
Plugin

Extended access

Why this level

  • The installer downloads and runs a script and writes files to the agents directory, and subagents with write tools can change project files.
All reasons and checks

josephhampton/awesome-gemini-cli-subagents

Install

Works in

Manual install

curl -fsSL https://raw.githubusercontent.com/JosephHampton/awesome-gemini-cli-subagents/main/install-agents.sh | bash

The one-line install for Gemini CLI from the Install section. The script runs from the network, so read it before running.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The installer downloads and runs a script and writes files to the agents directory, and subagents with write tools can change project files.

This is third-party code. Review the repository files before installing.

What it does

Awesome Gemini CLI Subagents is a collection of subagents for Gemini CLI and Antigravity CLI with its own installer. Each agent is a single Markdown file with a system prompt: focus areas, method, output format and guardrails. Files ship in the formats of both CLIs, and CI validates them on every change. Agents are grouped into nine categories: core development, data and AI, infrastructure, languages and frameworks, testing and quality, security, product orchestration, specialized domains and developer experience. Each has its own context window and toolset: reviewers and auditors get no file-writing tools, so they report problems and change nothing. The main agent delegates to the matching specialist, and `tech-lead-orchestrator` plans and hands out pieces.

Who it is for. Gemini CLI and Antigravity CLI users who want to hand review, security audits and testing to narrow specialists with a separate context.

Good fit when

  • A diff must be checked for security problems without cluttering the main session.
  • A big investigation should run in the subagent's window, not the main chat.
  • A team wants a shared set of agents in `.gemini/agents/` inside the project.
  • An orchestrator plans a feature and hands pieces to language specialists.

Not a fit when

  • You work in Claude Code or Cursor: the set is written for Gemini CLI and Antigravity CLI.
  • You need one narrow role: writing your own agent in a few lines is simpler.
  • Running scripts from the internet is not allowed: the installer is a `curl` piped to `bash`.

Example request

Review this diff for security issues with the auditor subagent and return a list of findings.

Limitations

The agents target Gemini CLI and Antigravity CLI and cannot be attached in other environments. The quick install runs the `install-agents.sh` script from the internet through `curl` and `bash`, and cloning the repository to read the script is safer. Subagents work in their own context, but answer quality depends on the model. The agent count differs between the README and the repository description: 89 against 81. The Antigravity version comes from `antigravity/awesome-subagents/` and is installed separately.

How to disable. Run `./install-agents.sh --uninstall` from a clone of the repository. Agents in `~/.gemini/agents/` or `.gemini/agents/` can also be removed by hand.

FAQ

How do I install the subagents in Gemini CLI?

Run the command from the Install section: `curl -fsSL https://raw.githubusercontent.com/JosephHampton/awesome-gemini-cli-subagents/main/install-agents.sh | bash`. For Antigravity add `-s -- --antigravity`.

How do I install only one category?

Clone the repository and run `./install-agents.sh --category security`. The flag is repeatable, and `--project` installs agents into the current project only.

Where do installed agents live?

For Gemini CLI that is `~/.gemini/agents/` or `.gemini/agents/` in the project. For Antigravity CLI it is `~/.gemini/config/agents/` or `.agents/agents/`.

Can the Antigravity version be installed as a plugin?

Yes, with `agy plugin install ./antigravity/awesome-subagents` from a clone of the repository.

Why do reviewers change nothing?

Reviewers and auditors have no file-writing tools, so they only report problems and edits stay with the main agent or you.

Discussion

No questions or reviews yet.

Plugins

A Gemini CLI extension on the PDCA cycle: 21 agents, 35 skills and 24 commands for planning, design, build and analysis

PluginExtended access66Repository stars

AGENTS.md instructions and skills with a test-first process that scales to the task, for Cursor, Codex CLI, Gemini CLI.

SkillExtended access51Repository stars
Needs a VPN

An MCP server that lets the agent call Gemini through its CLI to analyze large files and whole codebases

MCP serverExtended access2.3KRepository stars

One desktop window for Claude Code, Codex, Gemini CLI and OpenCode: terminals, pull requests, diffs and approvals

CLIBroad access348Repository stars

Agentic OS adds a five-step workflow and checks in git hooks and CI so that a step without evidence does not count as done

WorkflowExtended access234Repository stars

Installer of a working setup for Google Antigravity that puts rules, skills and workflows into a project with one npx command

SkillExtended access512Repository stars

README in short

The repository has an `agents/` folder with Gemini CLI files, an `antigravity/awesome-subagents/` mirror in the Antigravity format, an installer, recipes for agent combinations, a roadmap and CI validation. The license is CC0.

README badge

Report a problem