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

# Gemini CLI

> Using Google's Gemini CLI with CliDeck

[Gemini CLI](https://github.com/google-gemini/gemini-cli) is Google's CLI coding agent. CliDeck supports it with one-click telemetry setup.

## Setup

<Steps>
  <Step title="Launch a Gemini CLI session">
    Click **Gemini CLI** in the session launcher. The session starts normally.
  </Step>

  <Step title="Configure telemetry">
    On first launch, CliDeck shows a setup toast: **"Gemini CLI — Status Tracking"**. Click **Configure automatically**.

    CliDeck adds a `telemetry` section to `~/.gemini/settings.json` with the correct endpoint settings.
  </Step>

  <Step title="Restart the session">
    After configuration, click **Restart Session** on the toast. The new session will have telemetry active.
  </Step>
</Steps>

This is a one-time setup. All future Gemini CLI sessions will have telemetry enabled automatically.

## What the Config Looks Like

CliDeck adds this to your `~/.gemini/settings.json`:

```json theme={null}
{
  "telemetry": {
    "enabled": true,
    "target": "local",
    "otlpEndpoint": "http://localhost:4000",
    "otlpProtocol": "http",
    "logPrompts": true
  }
}
```

You can also add this manually if you prefer.

## Session Resume

Gemini CLI supports session resume. CliDeck captures the session ID from telemetry and uses `gemini --resume <sessionId>` to reconnect to previous sessions.

## Disabling Telemetry

If you want to stop sending telemetry from Gemini CLI to CliDeck:

1. Open **Settings** > **CLI Agents** > **Gemini CLI**
2. Toggle off **CliDeck integration**

CliDeck will remove the `telemetry` section from your Gemini settings file.

<Warning>
  If Gemini CLI releases a major update that changes its configuration or telemetry format, you may need to update CliDeck. Check for the latest version with `npm update -g clideck`.
</Warning>