first commit

docs/cli-agents/gemini-cli.mdx

@@ -0,0 +1,106 @@
+---
+title: "Gemini CLI"
+description: "Use Google's Gemini CLI with Bifrost for advanced reasoning capabilities with any provider."
+icon: "diamond"
+---
+
+[Gemini CLI](https://github.com/google-gemini/gemini-cli) is Google's powerful coding assistant with advanced reasoning capabilities.
+
+
+<Note>
+If your Allowed Headers are already set to `*`, you can skip this note. If not and you face issues integrating Bifrost with Gemini CLI, try switching to `*` or adding the specific headers required by your client. By default, Bifrost whitelists: `Content-Type`, `Authorization`, `X-Requested-With`, `X-Stainless-Timeout`, and `X-Api-Key`.
+</Note>
+
+## To install Gemini CLI
+
+```bash
+npm install -g @google/gemini-cli
+```
+
+## Configuring Gemini CLI to work with Bifrost
+
+Gemini CLI supports multiple authentication methods. Choose the one that matches your account type.
+
+### Google account (OAuth)
+
+Log in with your Google account for free-tier access (60 requests/min, 1,000 requests/day).
+
+1. **Set the Bifrost base URL**
+   ```bash
+   export GOOGLE_GEMINI_BASE_URL=http://localhost:8080/genai
+   ```
+
+2. **Run Gemini CLI and sign in**
+   ```bash
+   gemini
+   ```
+   Select **Login with Google** and authenticate via your browser. All traffic automatically routes through Bifrost.
+
+### API key based usage
+
+For users with a Gemini API key (obtain one from [Google AI Studio](https://aistudio.google.com/apikey)):
+
+1. **Configure environment variables**
+   ```bash
+   export GEMINI_API_KEY=your-api-key  # Gemini API key or Bifrost virtual key
+   export GOOGLE_GEMINI_BASE_URL=http://localhost:8080/genai
+   ```
+
+2. **Run Gemini CLI**
+   ```bash
+   gemini
+   ```
+   Select **Use Gemini API Key** in the CLI prompt for authentication.
+
+![Gemini CLI authentication](../media/gemini-cli.png)
+
+### Google Cloud / Vertex AI
+
+For enterprise users with Vertex AI access:
+
+```bash
+export GOOGLE_API_KEY=your-api-key  # Google API key or Bifrost virtual key
+export GOOGLE_GENAI_USE_VERTEXAI=true
+export GOOGLE_GEMINI_BASE_URL=http://localhost:8080/genai
+gemini
+```
+
+<Tip>
+For paid Code Assist License users, set your Google Cloud project: `export GOOGLE_CLOUD_PROJECT="your-project-id"`
+</Tip>
+
+Now all Gemini CLI traffic flows through Bifrost, giving you access to any provider/model configured in your Bifrost setup, plus observability and governance.
+
+## Model Configuration
+
+Use the `-m` flag to start Gemini CLI with a specific model:
+
+```bash
+gemini -m gemini-2.5-flash
+gemini -m gemini-2.5-pro
+```
+
+## Using Non-Google Models with Gemini CLI
+
+Bifrost automatically translates GenAI API requests to other providers, so you can use Gemini CLI with models from OpenAI, Anthropic, Mistral, and more. Use the `provider/model-name` format to specify any Bifrost-configured model.
+
+```bash
+# Start with an OpenAI model
+gemini -m openai/gpt-5
+
+# Start with an Anthropic model
+gemini -m anthropic/claude-sonnet-4-5-20250929
+
+# Start with a Groq model
+gemini -m groq/llama-3.3-70b-versatile
+```
+
+### Supported Providers
+
+Bifrost supports the following providers with the `provider/model-name` format:
+
+`openai`, `azure`, `gemini`, `vertex`, `bedrock`, `mistral`, `groq`, `cerebras`, `cohere`, `perplexity`, `xai`, `ollama`, `openrouter`, `huggingface`, `nebius`, `parasail`, `replicate`, `vllm`, `sgl`
+
+<Warning>
+Non-Google models **must support tool use** for Gemini CLI to work properly. Gemini CLI relies on tool calling for file operations, terminal commands, and code editing. Models without tool use support will fail on most operations.
+</Warning>