IntegrationsCoding Agents

Gemini CLI

  1. Sign up — Create an account at platform.respan.ai
  2. Create an API key — Generate one on the API keys page
  3. Add credits or a provider key — Add credits on the Credits page or connect your own provider key on the Integrations page

Add the Docs MCP to your AI coding tool to get help building with Respan. No API key needed.

1{
2  "mcpServers": {
3    "respan-docs": {
4      "url": "https://docs.respan.ai/mcp"
5    }
6  }
7}

What is Gemini CLI?

Gemini CLI is Google’s AI coding agent for the terminal, powered by Gemini models. It can analyze codebases, generate and edit files, run commands, and handle complex multi-step coding workflows with built-in thinking capabilities.

Setup

Prerequisite: Gemini CLI must be installed before integrating with Respan.

$npm install -g @google/gemini-cli
1

Install the Respan CLI

$npm install -g @respan/cli
2

Set your API key

$export RESPAN_API_KEY="YOUR_RESPAN_API_KEY"
3

Integrate

$respan integrate gemini-cli

This automatically configures Gemini CLI’s hooks to send traces to Respan.

4

Use Gemini CLI normally

$gemini "Write unit tests for the payment service"

All conversations are now traced automatically — no changes to your workflow.

5

View your traces

Open the Traces page to see your Gemini CLI conversations with full hierarchy — thinking, tool calls, and responses.

Configuration

Customize the integration with flags:

$respan integrate gemini-cli --customer-id "frank" --project-id "proj-123"
FlagEnv varDefaultDescription
--global——Write user-level config (~/.gemini/settings.json).
--local—LocalWrite per-project config (.gemini/settings.json).
--customer-idRESPAN_CUSTOMER_ID—Customer/user identifier for traces.
--project-idRESPAN_PROJECT_ID—Respan project ID.
--attrs——Custom attributes JSON (e.g. '{"env":"prod"}').
--base-urlRESPAN_BASE_URLhttps://api.respan.ai/apiRespan API base URL.
--dry-run——Preview changes without writing files.

Gemini CLI uses native OpenTelemetry support. The respan integrate command configures the OTLP endpoint and auth headers automatically.

Captured Data

DataDescription
User promptThe user’s input text
Assistant responseGemini CLI’s final response
Thinking blocksThinking / reasoning content
Tool callsTool name, input, and output (file operations, shell commands, etc.)
Token usageInput, output, and cache tokens (when available)
TimingStart time, end time, latency
ModelModel name used (e.g. gemini-2.5-pro, gemini-2.5-flash)

Span Types

Spanlog_typeDescription
RootagentThe complete conversation turn
ThinkinggenerationThinking / reasoning blocks
TooltoolTool invocations (file reads, writes, shell commands, etc.)

Uninstall

To remove the integration:

$respan integrate gemini-cli --remove