Spiral gives your agent every tool with one account. Browse the tools →

Gemini CLI · LLMReleased 2026-04-02

How to Use Gemma 4 31B in Gemini CLI

Gemma 4 31B suits code fixes, complex questions, and analysis of long documents. Google positions its dense architecture for answer quality, while Gemma 4 26B A4B prioritizes speed.

Prompts to try with Gemma 4 31B in Gemini CLI

Copy an example into Gemini CLI, or ask in your own words.

Use Gemma 4 31B with thinking enabled to trace the failing test through the relevant project files. Propose the smallest fix, apply it, and run the affected tests.

Gemma 4 31BGemini CLI
Try asking
  • Use Gemma 4 31B to compare the API implementation with the project's documentation. List mismatches with file locations and propose corrections.

  • Use Gemma 4 31B to review the current diff for incorrect assumptions and missing edge cases. Return findings with file locations, evidence, and suggested regression checks.

  • Use Gemma 4 31B to explain the request path through this repository. Identify entry points, validation, state changes, and error handling, citing the relevant files.

  • Use Gemma 4 31B to draft a migration plan from the project's current implementation to the behavior described in its issue. Check dependencies and return ordered steps with verification criteria.

How to set up Gemma 4 31B 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:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    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.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Gemma 4 31B

    One request; the result comes back by polling or a webhook.

    curl https://api.spiral.ai/v1/runs \
      -H "Authorization: Bearer $SPIRAL_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{
        "provider": "openrouter",
        "model": "google/gemma-4-31b-it",
        "input": {
          "messages": [
            {
              "role": "system"
            }
          ]
        }
      }'

Then paste one of the prompts above: Gemini CLI finds Gemma 4 31B on Spiral, shows the price and runs it.

Gemma 4 31B providers and prices

Spiral runs Gemma 4 31B through OpenRouter. Open a card for today's price, with every fee included.

OpenRouterLLM
Google: Gemma 4 31B
google/gemma-4-31b-it

Settings you can ask for

Ask Gemini CLI for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Seeda whole number
Min p0 to 1
Top ka whole number from 0
Top p0 to 1
Logprobson or off
Max tokens1 to 16384

The most output tokens to generate.

Temperature0 to 2
Top logprobs0 to 20
Presence penalty-2 to 2
Frequency penalty-2 to 2
Repetition penalty0 to 2

Every API field of Google: Gemma 4 31B is on its tool page: open its card above.

What can you do with Gemma 4 31B in Gemini CLI?

Turn project code and documentation into proposed fixes, explanations, and review findings with Gemma 4 31B. Have the coding agent inspect relevant files and verify proposed changes with the project's checks.

Diagnose a code defect

Ask Gemma 4 31B to trace a failing path, propose a small correction, and suggest a regression check.

Compare long documents

Use Gemma 4 31B to compare requirements, identify contradictions, and attach supporting passages to each finding.

Extract structured records

Ask Gemma 4 31B to turn supplied text into JSON records, using null when information is absent.

Draft multilingual responses

Use Gemma 4 31B to draft replies in a requested language while preserving names and approved terminology.

Summarize research

Ask Gemma 4 31B to condense supplied research into findings, disagreements, and unanswered questions.

Check a plan against constraints

Give Gemma 4 31B a proposed plan and explicit constraints, then request conflicts and a revised sequence.

Answer questions from reference text

Use Gemma 4 31B to draft answers grounded in supplied reference material, with evidence for each conclusion.

Questions about Gemma 4 31B in Gemini CLI

Can Gemini CLI use Gemma 4 31B?

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Gemma 4 31B like any built-in tool.

How much does Gemma 4 31B cost in Gemini CLI?

Up to $0.00214 per run at the default inputs. $0.26 per 1M input tokens, $0.52 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 OpenRouter account to use Gemma 4 31B in Gemini CLI?

No. Spiral runs Gemma 4 31B on its own OpenRouter account. You sign in to Spiral once and never paste a key.

How long does it take to set up Gemma 4 31B in Gemini CLI?

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

Does Gemini CLI wait while Gemma 4 31B runs?

Gemma 4 31B runs in the background. Gemini CLI starts the run, checks on it and gives you the text, json when it's ready.

What is Gemma 4 31B useful for?

Use it for code fixes, questions that require reasoning, summaries of long documents, and extracting information into JSON. Google positions the dense 31B model for answer quality.

How much context can Gemma 4 31B handle?

Google specifies a model context window of up to 256K tokens. That describes context capacity, not the length of a single answer.

Can Gemma 4 31B work in languages other than English?

Yes. Google describes Gemma 4 as supporting 140 languages; name the target language and explain which terms, names, or quotations should stay unchanged.

Does Gemma 4 31B have a thinking mode?

Yes. Thinking mode produces reasoning before the final answer; try it for code diagnosis, constraint checking, or questions with several dependent steps.

Which generation settings should I start with?

Google recommends temperature 1.0, nucleus sampling at 0.95, and a top-k value of 64 across use cases. Use those as a baseline before comparing changes on examples from your task.

Get started

Start using Gemma 4 31B in Gemini CLI

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Gemini CLI:

Set up Gemini CLI

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options