GC-301b · Module 3

Discovery & Update Management

3 min read

The Extensions Gallery at geminicli.com is the primary discovery channel. Extensions are searchable by keyword, filterable by type (tool, context, composite), and ranked by install count and ratings. But the Gallery is not the only discovery path. GitHub topics (gemini-cli-extension), community lists, and team-shared configuration files that reference specific extensions all serve as discovery mechanisms. The most reliable signal is a teammate's recommendation backed by a settings.json that already configures the extension.

Update management is manual by default. Run gemini extensions update to check for and apply available updates. For teams, pin extension versions in your shared .gemini/settings.json to prevent surprise updates from changing behavior mid-sprint. Version pinning follows semver — pin to a major version to get patches and minor features, or pin to an exact version for maximum stability. The tradeoff is clear: pinned versions prevent surprises but miss security patches.

# Discover extensions
gemini extensions search "database"
gemini extensions search "ci/cd"
gemini extensions info firebase  # detailed manifest and changelog

# Update management
gemini extensions update           # update all to latest
gemini extensions update firebase  # update specific extension
gemini extensions list --outdated  # check for available updates

# Version pinning in settings.json
# "extensions": {
#   "firebase": "^2.0.0",     Pin to major version
#   "jira": "1.2.0"           Pin to exact version
# }

Do This

  • Pin extension versions in shared settings.json for team consistency
  • Check for updates weekly and test before rolling out to the team
  • Use gemini extensions info to review changelogs before updating

Avoid This

  • Run gemini extensions update on every machine independently — versions will drift
  • Ignore update notifications — they often include security patches
  • Auto-update in CI/CD pipelines without testing the new version first