[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Fugu Ultra](https://spiral.ai/integrations/gemini-cli/fugu-ultra)

# How to Use Fugu Ultra in Gemini CLI

Fugu Ultra is built for difficult coding, research, and reasoning tasks that need several steps. Unlike Fugu, it coordinates multiple expert agents within a request to prioritize answer quality.

|  |  |
| --- | --- |
| Model | Fugu Ultra |
| Available through | OpenRouter |
| Category | LLM |
| Price | Up to $0.159972 per run at the default inputs. $6.50 per 1M input tokens, $39.00 per 1M output tokens. |
| Returns | text, json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Fugu Ultra in Gemini CLI

- Use Fugu Ultra to review the current diff and its callers. Report reproducible bugs with file references, triggering inputs, and a focused regression test.
- Use Fugu Ultra to investigate the failing tests in this project. Compare plausible root causes, reproduce the failure, and make the smallest supported fix.
- Use Fugu Ultra to turn the research method in this project's documentation into an implementation plan. Identify missing experimental details before editing code.
- Use Fugu Ultra to review this project's authentication flow. Trace authorization checks across routes and services, then propose tests for each suspected gap.
- Use Fugu Ultra to inspect the experiment logs and training code. Propose one controlled change, run the relevant evaluation, and compare the result with the baseline.

## How to set up Fugu Ultra 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 Fugu Ultra**: 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": "openrouter",
    "model": "sakana/fugu-ultra",
    "input": {
      "messages": [
        {
          "role": "system"
        }
      ]
    }
  }'
```

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

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

## Fugu Ultra tools and prices

- [Sakana: Fugu Ultra](https://spiral.ai/tools/openrouter/sakana/fugu-ultra) (OpenRouter): Up to $0.159972 per run at the default inputs. $6.50 per 1M input tokens, $39.00 per 1M output tokens.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| tools |  | — |  |
| reasoning |  | — | Reasoning effort; reasoning tokens count toward max_tokens. |
| tool_choice |  | — |  |
| reasoning_effort | high, xhigh, max | xhigh | How much the model reasons. |

## What can you do with Fugu Ultra in Gemini CLI?

Fugu Ultra can help investigate bugs, review changes, and turn research methods into working code. Give the agent a concrete completion check so it can connect implementation work with test results.

### Review a difficult code change

Ask for defects that depend on interactions across functions, with a reproduction case and suggested fix for each finding.

### Investigate a persistent bug

Provide the symptoms, relevant code, and test results. Ask for competing explanations and tests that distinguish them.

### Plan a paper reproduction

Turn a research method into implementation steps, experiment controls, evaluation criteria, and a list of missing details.

### Compare research findings

Compare supplied papers by method, evidence, assumptions, and disagreements. Require a source reference for each conclusion.

### Map patent claims

Compare supplied patent claims with technical literature and identify overlapping concepts for further investigation.

### Review application security

Analyze supplied authentication logic or security findings. Request evidence, affected paths, and a verification plan.

### Design the next research experiment

Use results from previous experiments to propose a testable hypothesis, controlled change, and measurable success criterion.

## Overview

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

## Fugu Ultra in other agents

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

## More Gemini CLI guides

- [Fugu Max](https://spiral.ai/integrations/gemini-cli/fugu-max)
- [Fugu Ultra v2](https://spiral.ai/integrations/gemini-cli/fugu-ultra-v2)
- [Ember-1](https://spiral.ai/integrations/gemini-cli/ember-1)
- [GLM 4.5 Air](https://spiral.ai/integrations/gemini-cli/glm-4-5-air)
- [Elorian Glimpse](https://spiral.ai/integrations/gemini-cli/elorian-glimpse)
- [GLM 4.7 Flash](https://spiral.ai/integrations/gemini-cli/glm-4-7-flash)

## Questions about Fugu Ultra in Gemini CLI

**Can Gemini CLI use Fugu Ultra?**

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

**How much does Fugu Ultra cost in Gemini CLI?**

Up to $0.159972 per run at the default inputs. $6.50 per 1M input tokens, $39.00 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 Fugu Ultra in Gemini CLI?**

No. Spiral runs Fugu Ultra on its own OpenRouter account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Fugu Ultra in Gemini CLI?**

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

**Does Gemini CLI wait while Fugu Ultra runs?**

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

**What is Fugu Ultra best suited for?**

Difficult coding, research, and reasoning tasks that require several steps. Sakana reports early use in paper reproduction, cybersecurity analysis, literature reviews, and patent investigations.

**How does Fugu Ultra differ from Fugu?**

Fugu Ultra can compose a workflow involving multiple expert agents within one request. Its design prioritizes answer quality on difficult problems.

**How much context can Fugu Ultra handle?**

Fugu Ultra supports a 1,000,000-token context window and up to 128,000 completion tokens. Treat these as separate limits when planning a large review or report.

**Does maximum reasoning always add more reasoning than extra high?**

Sakana documents those settings as equivalent for the unversioned Fugu Ultra model. Its documentation identifies v1.1 as a release with a distinct maximum level, so the behavior depends on the release.

**Does a short output limit restrict all of Fugu Ultra's internal work?**

Sakana says the output limit applies to the final response; the orchestrator still uses its own maximum token limit. Use the limit to control answer length.

