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

Gemini CLI · LLMReleased 2026-10-28

How to Use Particle-1 in Gemini CLI

Particle-1 is built for debugging, code changes, and data engineering. Post-trained on DeepSeek V4.1 Flash, it targets fewer reasoning and tool-call tokens while keeping task accuracy close to that model.

Prompts to try with Particle-1 in Gemini CLI

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

Use Particle-1 to inspect this project's failing build, identify the first actionable error, make a targeted fix, and rerun the affected checks.

Particle-1Gemini CLI
Try asking
  • Use Particle-1 to fix keyboard navigation in this React project's menu. Add a focused regression test and report the behavior you verified.

  • Use Particle-1 to trace product ID types through this dbt project. Correct inconsistent casts and check joins for lost or duplicated rows.

  • Use Particle-1 to investigate this repository's async startup failure. Check dependency order, implement a fix, and test both successful startup and dependency failure.

  • Use Particle-1 to review this project's merge-conflict handling. Add a regression case for the reported failure and document any behavior the fix changes.

How to set up Particle-1 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 Particle-1

    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": "particle-ai/particle-1",
        "input": {
          "messages": [
            {
              "role": "system"
            }
          ]
        }
      }'

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

Particle-1 providers and prices

Spiral runs Particle-1 through OpenRouter. Open a card for today's price, with every fee included.

OpenRouterLLM
Particle AI: Particle-1
particle-ai/particle-1

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 131072

The most output tokens to generate.

Temperature0 to 2
Top logprobs0 to 20
Presence penalty-2 to 2
Reasoning effortnone, minimal, low, medium, high, xhigh, or maxhigh

How much the model reasons.

Frequency penalty-2 to 2
Repetition penalty0 to 2

Every API field of Particle AI: Particle-1 is on its tool page: open its card above.

What can you do with Particle-1 in Gemini CLI?

Turn project requirements and failing checks into code changes with Particle-1. Give it concrete acceptance criteria and name the tests it must complete.

Fix a failing build

Use Particle-1 to inspect compiler errors, identify the cause, propose a targeted fix, and verify the build.

Repair a React interaction

Ask Particle-1 to correct broken navigation or row selection and check the affected behavior.

Correct dbt transformations

Have Particle-1 trace inconsistent types or key generation through a dbt project and propose tests.

Implement a codebase change

Give Particle-1 a concrete requirement and acceptance criteria, then request an implementation with regression checks.

Plan a debugging session

Provide an error trace and relevant code. Ask Particle-1 for ranked hypotheses and checks that distinguish them.

Triage recurring engineering failures

Use Particle-1 to review incoming build errors or data-job failures and draft investigation steps.

Produce structured engineering reports

Ask Particle-1 for JSON summaries of errors, proposed fixes, and verification evidence, then validate the results.

Questions about Particle-1 in Gemini CLI

Can Gemini CLI use Particle-1?

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

How much does Particle-1 cost in Gemini CLI?

Up to $0.002667 per run at the default inputs. $0.078 per 1M input tokens, $0.65 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 Particle-1 in Gemini CLI?

No. Spiral runs Particle-1 on its own OpenRouter account. You sign in to Spiral once and never paste a key.

How long does it take to set up Particle-1 in Gemini CLI?

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

Does Gemini CLI wait while Particle-1 runs?

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

What is Particle-1 best suited for?

Particle-1 focuses on software engineering and data engineering. Its published evaluations cover terminal tasks, React fixes, dbt projects, and codebase changes.

How does Particle-1 compare with DeepSeek V4.1 Flash?

Particle-1 is post-trained on DeepSeek V4.1 Flash to use fewer tokens. Particle reports 28.4% to 52.2% fewer output tokens across four engineering benchmarks, with pass rates within the base model's confidence intervals.

How much context and output can Particle-1 handle?

The context window holds 1,048,576 tokens across the prompt and completion. The output ceiling is 131,072 tokens, including reasoning.

When should I reduce Particle-1's reasoning?

Consider lower effort for straightforward explanations or narrow edits, and compare results on representative tasks. Reasoning is enabled by default and consumes part of the output allowance.

Can I rely on Particle-1 to match a JSON schema?

Validate the result before your application uses it. Particle's documentation distinguishes valid JSON from guaranteed compliance with your application's schema.

Get started

Start using Particle-1 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