Skip to Content
IntegrationsGemini CLI

Gemini CLI

Connect SpecForge to Gemini CLI with MCP tools for planning and implementation.

Quick Setup

From the root of your repository:

specforge init

The CLI detects Gemini CLI and generates .gemini/settings.json and GEMINI.md.

MCP Configuration

The generated .gemini/settings.json:

{
  "mcpServers": {
    "specforge": {
      "command": "npx",
      "args": ["@specforge/cli@latest"]
    }
  }
}

⚠️ Gemini CLI reads the API key from your environment. Set SPECFORGE_API_KEY in your shell profile or .env file before starting Gemini CLI.

Agent Instructions

GEMINI.md is generated at the project root. It tells Gemini how to work with SpecForge tools, which tickets to pick up, and how to structure its work.

Available Tools

Once connected, Gemini CLI has access to all 22 SpecForge MCP tools — planning, queries, implementation, and reports. Tell Gemini what you want, and it picks the right tool.

Next Steps

Cursor & VS CodeCodex CLI