[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Muse Spark 1.2](https://spiral.ai/integrations/gemini-cli/muse-spark-1-2)

# How to Use Muse Spark 1.2 in Gemini CLI

Muse Spark 1.2 is built for multi-file refactors, long debugging sessions, and turning visual references into code. It improves on Muse Spark 1.1 with a coding-focused update and a 1,048,576-token context window.

|  |  |
| --- | --- |
| Model | Muse Spark 1.2 |
| Available through | OpenRouter |
| Category | LLM |
| Price | Up to $0.022688 per run at the default inputs. $1.625 per 1M input tokens, $5.525 per 1M output tokens. |
| Returns | text, json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Muse Spark 1.2 in Gemini CLI

- Use Muse Spark 1.2 with high reasoning effort to trace how this project handles expired sessions. Reproduce the reported logout loop, fix the cause, and run the relevant tests.
- Use Muse Spark 1.2 to replace duplicated date-formatting code with one shared utility. Find every caller, preserve existing behavior, and report the checks you ran.
- Use Muse Spark 1.2 to study this repository's data-access layer and plan its migration to the next major database library version. List dependencies between changes and a validation check for each stage.
- Use Muse Spark 1.2 to implement the supplied screenshot using this project's existing components. Render the result, compare spacing and hierarchy with the reference, and correct visible mismatches.
- Use Muse Spark 1.2 to investigate why this project's background job sometimes processes an event twice. Compare the retry path, acknowledgment timing, and restart behavior, then test the most likely cause.

## How to set up Muse Spark 1.2 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 Muse Spark 1.2**: 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": "meta/muse-spark-1.2",
    "input": {
      "messages": [
        {
          "role": "system"
        }
      ]
    }
  }'
```

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

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

## Muse Spark 1.2 tools and prices

- [Meta: Muse Spark 1.2](https://spiral.ai/tools/openrouter/meta/muse-spark-1.2) (OpenRouter): Up to $0.022688 per run at the default inputs. $1.625 per 1M input tokens, $5.525 per 1M output tokens.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| tools |  | — |  |
| top_k | 0 to … | — |  |
| top_p | 0 to 1 | — |  |
| reasoning |  | — | Reasoning effort; reasoning tokens count toward max_tokens. |
| max_tokens | 1 to 943718 | — | The most output tokens to generate. |
| temperature | 0 to 2 | — |  |

## What can you do with Muse Spark 1.2 in Gemini CLI?

Muse Spark 1.2 can carry a refactor or debugging investigation across multiple files and turns. Give it the relevant project context and a concrete check for success.

### Refactor across several files

Use Muse Spark 1.2 to trace a shared interface, update its callers, and check that the affected behavior still works.

### Investigate a persistent bug

Give Muse Spark 1.2 the symptoms and relevant code, then work through competing explanations and test a targeted fix.

### Plan a software migration

Ask Muse Spark 1.2 to compare architecture choices and order the changes so dependencies and validation are explicit.

### Build from a visual reference

Have Muse Spark 1.2 translate a screenshot or demonstration video into interface code, then compare the rendered result with the reference.

### Read charts and diagrams

Ask Muse Spark 1.2 to extract visible labels and values, explain relationships, and identify details that need a closer view.

### Extract structured records

Use Muse Spark 1.2 to turn unstructured descriptions into JSON records with a defined schema for downstream processing.

### Classify incoming requests

Have Muse Spark 1.2 assign predefined categories to support requests and return a consistent structure for review or routing.

### Summarize recorded demonstrations

Ask Muse Spark 1.2 to explain what happens in a video, identify the relevant sequence of actions, and turn it into written instructions.

## Overview

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

## Muse Spark 1.2 in other agents

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

## More Gemini CLI guides

- [Muse Spark 1.1](https://spiral.ai/integrations/gemini-cli/muse-spark-1-1)
- [Muse Spark 1.2 Contributor](https://spiral.ai/integrations/gemini-cli/muse-spark-1-2-contributor)
- [Muse Glimmer 30B (batch)](https://spiral.ai/integrations/gemini-cli/muse-glimmer-30b-batch)
- [Muse Spark 1.3](https://spiral.ai/integrations/gemini-cli/muse-spark-1-3)
- [Muse Glimmer 30B](https://spiral.ai/integrations/gemini-cli/muse-glimmer-30b)
- [Muse Spark 1.3 Contributor](https://spiral.ai/integrations/gemini-cli/muse-spark-1-3-contributor)

## Questions about Muse Spark 1.2 in Gemini CLI

**Can Gemini CLI use Muse Spark 1.2?**

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

**How much does Muse Spark 1.2 cost in Gemini CLI?**

Up to $0.022688 per run at the default inputs. $1.625 per 1M input tokens, $5.525 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 Muse Spark 1.2 in Gemini CLI?**

No. Spiral runs Muse Spark 1.2 on its own OpenRouter account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Muse Spark 1.2 in Gemini CLI?**

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

**Does Gemini CLI wait while Muse Spark 1.2 runs?**

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

**What is Muse Spark 1.2 best suited for?**

Multi-file refactors, long debugging sessions, and coding tasks that take several rounds of work. Meta describes it as a moderate improvement over Muse Spark 1.1.

**How much context can Muse Spark 1.2 handle?**

Its context window is 1,048,576 tokens. That is the context capacity, not a promise that every answer can be that long.

**Can Muse Spark 1.2 generate images, video, or audio?**

Its output is text, including code and structured JSON. It can analyze images, video, and audio, but does not return generated media.

**When should I increase reasoning effort?**

Use more reasoning for complex code generation, architecture tradeoffs, and planning with several dependent steps. Leave enough output budget for both internal reasoning and the final answer.

**Should I lower temperature for more focused answers?**

Meta recommends the default temperature of 1.0 for most work. Start by making the task, constraints, and expected answer more explicit.

