> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getunbound.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Gemini CLI

Gemini CLI is a powerful command-line interface tool that provides direct access to Google's Gemini AI models from your terminal. It offers intelligent code generation, natural language processing, and development assistance capabilities. By integrating Gemini CLI with Unbound Security AI Gateway, you can leverage these AI capabilities while maintaining enterprise-grade security, cost control, and compliance.

## Prerequisites

Before setting up the integration, ensure you have:

* **Unbound CLI**: Installed and logged in — see the [CLI guide](/cli/overview)
* **Node.js**: Version 20 or higher
* **Gemini CLI**: Install with `npm install -g @google/gemini-cli`

## Setup with Unbound CLI

```bash theme={null}
unbound setup gemini-cli
```

This sets the `GEMINI_API_KEY` and `GOOGLE_GEMINI_BASE_URL` environment variables to route Gemini CLI through Unbound.

To remove the Unbound configuration:

```bash theme={null}
unbound setup gemini-cli --clear
```

Restart your terminal after setup. When Gemini CLI prompts for authentication, select **"Use Gemini API Key"** and press **Enter** — the key is already configured.

## Usage

### Basic Usage

Once configured, you can start using Gemini CLI in your terminal:

```bash theme={null}
gemini
```

This launches the interactive Gemini interface where you can:

* Generate code for various programming languages
* Ask questions about development topics
* Get assistance with debugging
* Process and analyze text content

### Example Commands

```bash theme={null}
# Start interactive mode
gemini

# Generate code for a specific task
gemini "Create a Python function to sort a list"

# Ask development questions
gemini "How do I implement authentication in a web app?"

# Get help with debugging
gemini "Help me debug this JavaScript error"
```

### Advanced Usage

```bash theme={null}
# Generate code with specific parameters
gemini --model="gemini-pro" "Write a REST API in Node.js"

# Process files
gemini --input="code.py" "Explain this code"

# Generate documentation
gemini "Generate documentation for this function"
```

### Model Selection

You can specify different Gemini models:

```bash theme={null}
# Use specific model
gemini --model="gemini-pro" "Your prompt here"

# List available models
gemini --list-models
```

## Troubleshooting

### Common Issues

**Gemini CLI not found after installation:**

```bash theme={null}
# Check if npm global bin is in your PATH
npm config get prefix
# Add to PATH if needed
export PATH="$(npm config get prefix)/bin:$PATH"
```

**API key not recognized:**

```bash theme={null}
# Verify your environment variables
echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL
# Once the setup is complete, open gemini-cli in a new terminal
```

**Connection issues:**

* Ensure your Unbound API key is valid
* Check that the base URL is correct
* Verify your internet connection
* Confirm the Unbound service is running

**Model not found:**

```bash theme={null}
# Check available models
gemini --list-models
# Use a different model if needed
gemini --model="gemini-pro-vision" "Your prompt"
```

## Security Benefits

Using Gemini CLI with Unbound Security AI Gateway provides:

* **Request Monitoring**: All AI requests are logged and monitored
* **Cost Control**: Set spending limits and track usage across all models
* **Compliance**: Ensure AI interactions meet your organization's standards
* **Guardrails**: Apply security policies to AI responses
* **Audit Trail**: Complete visibility into AI usage patterns
* **Model Routing**: Intelligent routing to optimize performance and costs
* **Rate Limiting**: Prevent abuse and manage resource usage

## Best Practices

### Development Workflow

1. **Start with simple prompts** to test the integration
2. **Use specific, clear instructions** for better results
3. **Iterate on prompts** to improve output quality
4. **Monitor usage** through Unbound dashboard
5. **Set appropriate guardrails** for your use case

### Security Considerations

* Keep your API keys secure and never commit them to version control
* Use environment variables for configuration
* Regularly rotate your API keys
* Monitor usage patterns for anomalies
* Set up appropriate guardrails for your organization's needs

<CardGroup cols={2}>
  <Card title="Unbound CLI" icon="terminal" href="/cli/overview">
    Install the CLI to set up and manage tools
  </Card>

  <Card title="Tool Policies" icon="shield" href="/policies/tool-policies">
    Configure security guardrails for AI tools
  </Card>
</CardGroup>