[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [GPT-5.6 Terra](https://spiral.ai/integrations/gemini-cli/gpt-5-6-terra)

# How to Use GPT-5.6 Terra in Gemini CLI

GPT-5.6 Terra fits everyday coding, document analysis, and scoped agent tasks. Choose it for routine work; Terra Pro applies additional model work to difficult problems.

|  |  |
| --- | --- |
| Model | GPT-5.6 Terra |
| Available through | OpenAI |
| Category | LLM |
| Price | Up to $0.064012 per run at the default inputs. $2.60 per 1M input tokens, $0.26 per 1M cached input tokens, $3.25 per 1M cache write tokens, $15.60 per 1M output tokens. |
| Returns | text, json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with GPT-5.6 Terra in Gemini CLI

- Use GPT-5.6 Terra to inspect the failing tests, fix the smallest relevant code path, and run the affected checks. Report the cause and validation results.
- Use GPT-5.6 Terra to implement pagination in this project's existing list view. Follow its current conventions and verify empty, first-page, and last-page behavior.
- Use GPT-5.6 Terra to compare the README with the current implementation. List outdated claims with file references and proposed corrections.
- Use GPT-5.6 Terra with medium reasoning to review the current diff. Report actionable defects with file references, a concrete failure example, and a suggested fix.
- Ask GPT-5.6 Terra through Spiral to review the diff on this branch and list the three riskiest changes. Save the result in ./assets.

## How to set up GPT-5.6 Terra in Gemini CLI

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run GPT-5.6 Terra**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "openai",
    "model": "openai/gpt-5.6-terra",
    "input": {
      "messages": [
        {
          "role": "system"
        }
      ]
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds GPT-5.6 Terra on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## GPT-5.6 Terra tools and prices

- [GPT-5.6 Terra](https://spiral.ai/tools/openai/openai/gpt-5.6-terra) (OpenAI): Up to $0.064012 per run at the default inputs. $2.60 per 1M input tokens, $0.26 per 1M cached input tokens, $3.25 per 1M cache write tokens, $15.60 per 1M output tokens.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| seed |  | — |  |
| tools |  | — |  |
| top_p | … to 1 | — | Taken only with reasoning effort "none". |
| logprobs |  | — | Taken only with reasoning effort "none". |
| reasoning |  | — | Reasoning effort; reasoning tokens count toward max_tokens. |
| max_tokens | 16 to 128000 | — | The most output tokens to generate. |

## What can you do with GPT-5.6 Terra in Gemini CLI?

Turn project requirements into scoped patches, tests, and code reviews. Use Terra for everyday implementation and Terra Pro for difficult analysis.

### Scoped code changes

Give Terra a concrete bug or implementation request. Ask for the relevant patch and validation results.

### Document comparisons

Compare supplied material against explicit criteria. Request supporting passages for each finding and mark missing evidence.

### Customer conversation classification

Group conversations into defined categories, summarize recurring issues, and separate ambiguous cases for review.

### Difficult analytical reviews

Use Terra Pro to examine a complex proposal, identify conflicting assumptions, and produce a recommendation with supporting evidence.

### Repeatable extraction

Turn supplied text into consistent records with explicit rules for missing values and conflicting information.

### Implementation planning

Ask Terra to turn a bounded engineering requirement into a plan with acceptance criteria and relevant checks.

## Overview

- [OpenAI](https://spiral.ai/providers/openai)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## GPT-5.6 Terra in other agents

- [Amp](https://spiral.ai/integrations/amp/gpt-5-6-terra)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/gpt-5-6-terra)
- [Claude](https://spiral.ai/integrations/claude-desktop/gpt-5-6-terra)
- [Claude Code](https://spiral.ai/integrations/claude-code/gpt-5-6-terra)
- [Cline](https://spiral.ai/integrations/cline/gpt-5-6-terra)
- [Codex](https://spiral.ai/integrations/codex/gpt-5-6-terra)
- [Cursor](https://spiral.ai/integrations/cursor/gpt-5-6-terra)
- [Devin](https://spiral.ai/integrations/devin/gpt-5-6-terra)
- [dots](https://spiral.ai/integrations/dots/gpt-5-6-terra)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/gpt-5-6-terra)
- [Gemini](https://spiral.ai/integrations/gemini/gpt-5-6-terra)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/gpt-5-6-terra)
- [goose](https://spiral.ai/integrations/goose/gpt-5-6-terra)
- [Grok](https://spiral.ai/integrations/grok/gpt-5-6-terra)
- [Grok Build](https://spiral.ai/integrations/grok-build/gpt-5-6-terra)
- [Hermes](https://spiral.ai/integrations/hermes/gpt-5-6-terra)
- [Instinct](https://spiral.ai/integrations/instinct/gpt-5-6-terra)
- [Manus](https://spiral.ai/integrations/manus/gpt-5-6-terra)
- [Muse](https://spiral.ai/integrations/muse/gpt-5-6-terra)
- [Muse Code](https://spiral.ai/integrations/muse-code/gpt-5-6-terra)
- [n8n](https://spiral.ai/integrations/n8n/gpt-5-6-terra)
- [Notion](https://spiral.ai/integrations/notion/gpt-5-6-terra)
- [OpenClaw](https://spiral.ai/integrations/openclaw/gpt-5-6-terra)
- [opencode](https://spiral.ai/integrations/opencode/gpt-5-6-terra)
- [Perplexity](https://spiral.ai/integrations/perplexity/gpt-5-6-terra)
- [Raycast](https://spiral.ai/integrations/raycast/gpt-5-6-terra)
- [VS Code](https://spiral.ai/integrations/vscode/gpt-5-6-terra)
- [Windsurf](https://spiral.ai/integrations/windsurf/gpt-5-6-terra)
- [Zapier](https://spiral.ai/integrations/zapier/gpt-5-6-terra)

## More Gemini CLI guides

- [GPT-5.6 Sol Pro](https://spiral.ai/integrations/gemini-cli/gpt-5-6-sol-pro)
- [GPT-5.6 Terra Pro](https://spiral.ai/integrations/gemini-cli/gpt-5-6-terra-pro)
- [GPT-5.6 Sol](https://spiral.ai/integrations/gemini-cli/gpt-5-6-sol)
- [GPT-6 Astra](https://spiral.ai/integrations/gemini-cli/gpt-6-astra)
- [GPT-5.6 Luna Pro](https://spiral.ai/integrations/gemini-cli/gpt-5-6-luna-pro)
- [GPT-6 Astra Pro](https://spiral.ai/integrations/gemini-cli/gpt-6-astra-pro)

## Questions about GPT-5.6 Terra in Gemini CLI

**Can Gemini CLI use GPT-5.6 Terra?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run GPT-5.6 Terra like any built-in tool.

**How much does GPT-5.6 Terra cost in Gemini CLI?**

Up to $0.064012 per run at the default inputs. $2.60 per 1M input tokens, $0.26 per 1M cached input tokens, $3.25 per 1M cache write tokens, $15.60 per 1M output tokens. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.

**Do I need an OpenAI account to use GPT-5.6 Terra in Gemini CLI?**

No. Spiral runs GPT-5.6 Terra on its own OpenAI account. You sign in to Spiral once and never paste a key.

**How long does it take to set up GPT-5.6 Terra in Gemini CLI?**

About two minutes: add the server, then sign in, then check it.

**Does Gemini CLI wait while GPT-5.6 Terra runs?**

GPT-5.6 Terra runs in the background. Gemini CLI starts the run, checks on it and gives you the text, json when it's ready.

**What is GPT-5.6 Terra good at?**

Use it for everyday implementation, document analysis, and classifying customer conversations. Keep requests scoped around a clear deliverable, such as a patch, comparison table, or categorized summary.

**How does Terra Pro differ from Terra?**

Terra Pro uses the same underlying model with Pro reasoning mode for complex tasks. Choose it for difficult analysis where additional model work may improve the answer.

**How much material can Terra handle?**

Terra has a 1,050,000-token context window and a maximum output allowance of 128,000 tokens. Internal reasoning also consumes the generation allowance, so visible answers can be shorter than that ceiling.

**Can Terra analyze images, audio, or video?**

Terra accepts images for analysis. Audio and video are not natively supported.

**Which reasoning setting should I start with?**

Start with medium reasoning. Try low for straightforward tasks where response time matters, then compare results on examples from your actual workload.

