add-gemini-extension

Add a new Gemini CLI extension to the marketplace as a Type 4 synced plugin.

Arguments: $ARGUMENTS (format: <extension-name> <github-repo-url>)

Example: /add-gemini-extension firebase https://github.com/pleaseai/firebase-plugin

---

Step 1 — Parse & Validate Input

Parse $ARGUMENTS to extract:

• EXTENSION_NAME: first token (e.g. open-aware)
• REPO_URL: second token (e.g. https://github.com/qodo-ai/open-aware)

Validate:

• Both tokens are present. If not, stop and show: Usage: /add-gemini-extension <name> <github-repo-url>
• REPO_URL matches pattern https://github.com/<owner>/<repo> (or [email protected]:<owner>/<repo>). Normalize to HTTPS form.
• EXTENSION_NAME contains only alphanumeric characters, hyphens, and underscores.

Read scripts/meta.ts and verify EXTENSION_NAME is NOT already a key in the extensions object. If it already exists, stop and report: Extension '<name>' already exists in scripts/meta.ts.

Step 2 — Explore Repository

Use the GitHub MCP tool or gh CLI to fetch the gemini-extension.json from the repository:

gh api repos/<owner>/<repo>/contents/gemini-extension.json --jq '.content' | base64 -d

If not found, stop and report:

No gemini-extension.json found in <REPO_URL>.
This repository does not appear to be a Gemini CLI extension.

From gemini-extension.json, extract:

• name, version, description (may be absent)
• contextFileName (optional — triggers SessionStart hook generation)
• mcpServers (optional — defaults to {} if absent)
• Presence of commands/ directory (check via GitHub API)

Check for a commands/ directory (a 404 response means the directory is absent — treat it as an expected optional case, not an error):

gh api repos/<owner>/<repo>/contents/commands 2>/dev/null || echo "[]"

Display a summary of what was found:

Found Gemini extension in <REPO_URL>:
  name:            <name>
  version:         <version>
  description:     <description or "(none)">
  contextFileName: <file or "(none)">
  mcpServers:      <list of server names>
  commands/:       <yes/no — N .toml files>