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

# Gemini CLI

> Best for simple tasks (Experimental)

<Warning>
  Gemini CLI is currently **experimental** and may have different behavior or limitations compared to the stable agents (Claude Code and Codex).
</Warning>

## Overview

Gemini CLI is powered by Google's Gemini models and is best for simple tasks.

<Note>
  Gemini CLI **cannot be set as a default agent**. You must use the `/gemini` slash command to invoke it.
</Note>

## Latest Model

* **Gemini 3 Pro** - Google's latest model with large context capabilities

## Authentication

Gemini CLI requires a Google AI API key:

1. Get an API key at [Google AI Studio](https://aistudio.google.com/app/apikey)
2. In [Blocks Dashboard](https://blocks.team), go to **Dashboard** → **Agents**
3. Select **Gemini CLI** and choose "API Key"
4. Paste your Google AI API key

<Note>
  Use Google AI Studio (not Google Cloud) to get your API key.
</Note>

## Using Gemini CLI

Since Gemini CLI cannot be set as default, you must use the `/gemini` slash command:

```
@blocks /gemini analyze this codebase
```

## Best For

* Simple tasks

## Cost

Gemini CLI uses your Google AI API key:

* Check pricing at [Google AI Pricing](https://ai.google.dev/pricing)
* Google AI offers a generous free tier
* Monitor usage in [Google AI Studio](https://aistudio.google.com/)
* API usage is billed by Google based on tokens

## Experimental Status

As an experimental agent, Gemini CLI:

* May have occasional unexpected behavior
* Features and capabilities may change
* Is less battle-tested than Claude Code or Codex

<Tip>
  For production-critical tasks, consider using [Claude Code](/using-blocks/agents/claude-code) or [Codex](/using-blocks/agents/codex) which are more stable.
</Tip>

## Next Steps

<CardGroup cols={2}>
  <Card title="Claude Code" icon="brain" href="/using-blocks/agents/claude-code">
    Learn about Claude Code (stable)
  </Card>

  <Card title="Codex" icon="code" href="/using-blocks/agents/codex">
    Learn about Codex (stable)
  </Card>

  <Card title="Multi-Repo Support" icon="folder-tree" href="/using-blocks/features/multi-repo-support">
    Work across repositories
  </Card>
</CardGroup>