Skip to content

Comprehensive Gemini CLI project configuration with hooks, skills, agents, commands, and GitHub Actions workflows.

License

Notifications You must be signed in to change notification settings

joeangel/gemini-showcase

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Gemini Code Project Configuration Showcase

Most software engineers are seriously sleeping on how good LLM agents are right now.

Once you've got Gemini Code set up, you can point it at your codebase and have it operate like a super-powered teammate. The real unlock is building a solid set of Skills and Agents for the stuff you do all the time.

For background on how this project was produced, see the companion notes repo: https://github.com/joeangel/gemini-showcase-notes

✨ The Magic

This project demonstrates specific "Magic" capabilities powered by Gemini:

1. Auto-Repair (/fix)

See an issue? Just comment:

@gemini /fix

Gemini will analyze the issue, write the code to fix it, and open a PR for you.

2. Auto-Review (/review)

Open a PR, and Gemini automatically reviews it against our Code Review Agent checklist (Security, Types, UI States).

3. Auto-Triage (/triage)

Open an issue, and Gemini immediately analyzes it and applies the correct labels.

4. Smart Refactor (/refactor)

Want to modernize your code? Comment:

@gemini /refactor convert this to async/await

Gemini acts as a Senior Engineer, using our specialized Smart Diff tool to safely restructure your code.

5. Auto-Plan (/plan)

Have a big idea but don't know where to start?

@gemini /plan implement user login

Gemini acts as a Project Manager, breaking down your request into a detailed task.md checklist.

6. Chat (@gemini)

Mention @gemini in any comment to ask questions or request changes.


📚 Documentation

Detailed documentation has been moved to keep this README token-friendly for AI agents.

Topic Description
Configuration AIMD, settings.json, MCP, LSP, Hooks
Skills & Agents Creating Custom Skills, Agents, and Commands
Workflows Dispatch, Review, Triage, Refactor, Plan, Fixer
Extensions [NEW] Smart Diff & Local Tool Extensions
Cost & Usage Billing, API Limits, and Security (MUST READ)

⚠️ Prerequisites & Safety

Before you start, please read our Cost & Usage Guide.

1. Essentials

2. Critical Configuration

  • Add Secret: Go to Settings -> Secrets -> Actions and add GEMINI_API_KEY.
  • Permissions: Enable Read and write permissions in Settings -> Actions -> General.

Caution

Private Repository Users: Scheduled workflows consume your 2,000 free minutes. See Fixed Costs Table to avoid unexpected quotas usage.


🚀 Quick Start

1. Create the .gemini directory

mkdir -p .gemini/{agents,commands,hooks,skills}

2. Add Project Memory

Create GEMINI.md in your project root. See Example GEMINI.md.

3. Add Settings

Create .gemini/settings.json. See Example settings.json.


License

MIT

Notice: Portions of this software are derived from ChrisWiles/claude-code-showcase, copyright (c) 2025 Chris Wiles, licensed under the MIT License.

About

Comprehensive Gemini CLI project configuration with hooks, skills, agents, commands, and GitHub Actions workflows.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •