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

Gemini CLI · LLMReleased 2025-09-26

How to Use Relace Apply 3 in Gemini CLI

Relace Apply 3 merges proposed edits into existing code. Give it the original code and an abbreviated edit snippet to get the merged code back.

Prompts to try with Relace Apply 3 in Gemini CLI

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

Use Relace Apply 3 to merge a prepared fix for empty input in the project's Python parser. Read the current implementation first, then review the diff.

Relace Apply 3Gemini CLI
Try asking
  • Prepare a TypeScript edit that renames the selected function and its call sites. Use Relace Apply 3 to merge it, then check the diff for unrelated changes.

  • Use Relace Apply 3 to merge revised labels into the project's HTML form. Include the original markup and a focused edit snippet.

  • Prepare a snippet removing the obsolete Ruby method, including surrounding context. Use Relace Apply 3 to merge the deletion and inspect the result.

  • Use Relace Apply 3 to merge the approved installation-section rewrite into README.md. Compare the result with the original to confirm other sections remain intact.

How to set up Relace Apply 3 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 Relace Apply 3

    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": "relace/relace-apply-3",
        "input": {
          "messages": [
            {
              "role": "system"
            }
          ]
        }
      }'

Then paste one of the prompts above: Gemini CLI finds Relace Apply 3 on Spiral, shows the price and runs it.

Relace Apply 3 providers and prices

Spiral runs Relace Apply 3 through OpenRouter. Open a card for today's price, with every fee included.

OpenRouterLLM
Relace: Relace Apply 3
relace/relace-apply-3

Settings you can ask for

Ask Gemini CLI for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Seeda whole number
Max tokens1 to 128000

The most output tokens to generate.

Every API field of Relace: Relace Apply 3 is on its tool page: open its card above.

What can you do with Relace Apply 3 in Gemini CLI?

Turn proposed changes into merged project code with Relace Apply 3. Have the coding agent prepare focused edits, then inspect the resulting diff against the request.

Apply a TypeScript refactor

Merge a proposed function rename and updated call sites into existing TypeScript code, then inspect the resulting diff.

Merge a JavaScript bug fix

Apply a prepared correction to a calculation or event handler while retaining the surrounding implementation.

Update Python validation

Merge a proposed validation branch into a Python function using the original code and a focused edit snippet.

Revise Ruby application logic

Apply an approved method change to existing Ruby code and review the diff for unintended edits.

Apply HTML changes

Merge a prepared markup change, such as revised form labels, into the original HTML.

Maintain Markdown documentation

Merge a proposed section replacement into an existing Markdown document while retaining unrelated sections.

Questions about Relace Apply 3 in Gemini CLI

Can Gemini CLI use Relace Apply 3?

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

How much does Relace Apply 3 cost in Gemini CLI?

Up to $0.006695 per run at the default inputs. $1.105 per 1M input tokens, $1.625 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 Relace Apply 3 in Gemini CLI?

No. Spiral runs Relace Apply 3 on its own OpenRouter account. You sign in to Spiral once and never paste a key.

How long does it take to set up Relace Apply 3 in Gemini CLI?

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

Does Gemini CLI wait while Relace Apply 3 runs?

Relace Apply 3 runs in the background. Gemini CLI starts the run, checks on it and gives you the text, json when it's ready.

What is Relace Apply 3 best used for?

Use it to merge an already proposed change into existing code. A useful workflow separates deciding what to change from applying that change.

How should I format a Relace Apply 3 prompt?

Put the original code inside <code> tags and the proposed edit inside <update> tags. Add a brief instruction describing the intended change when the snippet could be ambiguous.

Which programming languages does Relace Apply 3 cover?

Relace reports training across dozens of languages, emphasizing TypeScript, JavaScript, Python, Ruby, HTML, and Markdown. That training coverage does not establish equal accuracy across languages.

Should I send very large source code blocks?

Relace recommends refactoring files above 32,000 tokens to improve output quality. Treat that recommendation as a quality guideline when choosing how much code to send.

How do I make deletions clear?

Include surrounding code that identifies the section to remove. Preserve the indentation and structure you want in the final result.

Get started

Start using Relace Apply 3 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