[Integrations](https://spiral.ai/integrations) › [goose](https://spiral.ai/integrations/goose) › [GPT-5 Mini](https://spiral.ai/integrations/goose/gpt-5-mini)

# How to Use GPT-5 Mini in goose

GPT-5 Mini suits focused coding tasks, text extraction, and summaries with clear requirements. It responds faster than GPT-5 and works best when you specify exactly what a successful answer includes.

|  |  |
| --- | --- |
| Model | GPT-5 Mini |
| Available through | OpenAI |
| Category | LLM |
| Price | Up to $0.010662 per run at the default inputs. $0.325 per 1M input tokens, $0.0325 per 1M cached input tokens, $2.60 per 1M output tokens. |
| Returns | text, json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with GPT-5 Mini in goose

- Use GPT-5 Mini to investigate the failing tests in this project. Identify the expected behavior, fix the underlying issue with a focused patch, and run the affected tests. Report the changes and actual test results.
- Use GPT-5 Mini with high reasoning effort to trace why this project's retry logic can submit the same job twice. Add a regression test and a focused fix. Preserve the documented retry behavior.
- Use GPT-5 Mini to write tests for the parser in this project. Cover empty input, malformed records, and missing required values using the existing test framework. Derive expected results from the parser's documented contract.
- Use GPT-5 Mini to review the current diff for violations of the acceptance criteria in the issue description. Return only actionable findings, each with a file location, the violated requirement, and a suggested correction.
- Use GPT-5 Mini to extract the public functions from this project's authentication module. Return JSON containing each function's name, parameters, return type, and documented errors. Mark undocumented behavior as unknown.

## How to set up GPT-5 Mini in goose

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the extension**: In goose Desktop, open the sidebar, click Extensions, then Add custom extension. Enter:

2. **Sign in**: When goose first connects to Spiral, your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key. If the browser does not open, goose prints the link to open yourself.

### Use the Spiral skill

1. **Send goose 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 GPT-5 Mini**: 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": "openai",
    "model": "openai/gpt-5-mini",
    "input": {
      "messages": [
        {
          "role": "system"
        }
      ]
    }
  }'
```

Then paste one of the prompts above: goose finds GPT-5 Mini on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/goose

## GPT-5 Mini tools and prices

- [GPT-5 Mini](https://spiral.ai/tools/openai/openai/gpt-5-mini) (OpenAI): Up to $0.010662 per run at the default inputs. $0.325 per 1M input tokens, $0.0325 per 1M cached input tokens, $2.60 per 1M output tokens.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| seed |  | — |  |
| tools |  | — |  |
| reasoning |  | — | Reasoning effort; reasoning tokens count toward max_tokens. |
| max_tokens | 16 to 128000 | — | The most output tokens to generate. |
| tool_choice |  | — |  |
| response_format |  | — |  |

## What can you do with GPT-5 Mini in goose?

Turn a reproducible bug or acceptance criterion into a focused patch and regression tests with GPT-5 Mini. Supply the relevant project context, define the expected behavior, and require evidence from checks.

### Extract order details

Turn order messages into consistent records containing order numbers, requested changes, and dates. Require a missing value when the message does not provide a detail.

### Sort support requests

Assign incoming messages to clearly defined categories such as billing, access, and product questions. Include a short supporting excerpt for each decision.

### Summarize meeting decisions

Extract decisions, owners, deadlines, and unresolved questions from a transcript. Keep proposed actions separate from agreed commitments.

### Draft answers from supplied policies

Prepare support reply drafts using the customer's message and current policy text. Flag questions the policy does not answer.

### Fix a specific software bug

Investigate a reproducible failure, propose a focused patch, and check it against the expected behavior. Keep the task scoped to the reported issue.

### Write regression tests

Turn a bug report and acceptance criteria into tests for the reported failure and relevant edge cases. Review the tests against the intended behavior.

### Prepare a daily change digest

Compare supplied updates with the previous digest and report changes, unresolved items, and supporting excerpts. Use explicit rules to exclude repeated information.

## Overview

- [OpenAI](https://spiral.ai/providers/openai)
- [All goose guides](https://spiral.ai/integrations/goose)

## GPT-5 Mini in other agents

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

## More goose guides

- [GPT-5](https://spiral.ai/integrations/goose/gpt-5)
- [GPT-5 Nano](https://spiral.ai/integrations/goose/gpt-5-nano)
- [GPT-4o mini (2024-07-18)](https://spiral.ai/integrations/goose/gpt-4o-mini-2024-07-18)
- [GPT-5 Pro](https://spiral.ai/integrations/goose/gpt-5-pro)
- [GPT-4o mini](https://spiral.ai/integrations/goose/gpt-4o-mini)
- [GPT-5.1](https://spiral.ai/integrations/goose/gpt-5-1)

## Questions about GPT-5 Mini in goose

**Can goose use GPT-5 Mini?**

Yes. Add Spiral to goose as an MCP server, and goose can find and run GPT-5 Mini like any built-in tool.

**How much does GPT-5 Mini cost in goose?**

Up to $0.010662 per run at the default inputs. $0.325 per 1M input tokens, $0.0325 per 1M cached input tokens, $2.60 per 1M output tokens. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your goose plan is separate.

**Do I need an OpenAI account to use GPT-5 Mini in goose?**

No. Spiral runs GPT-5 Mini on its own OpenAI account. You sign in to Spiral once and never paste a key.

**How long does it take to set up GPT-5 Mini in goose?**

About two minutes: add the extension, then sign in.

**Does goose wait while GPT-5 Mini runs?**

GPT-5 Mini runs in the background. goose starts the run, checks on it and gives you the text, json when it's ready.

**What is GPT-5 Mini best suited for?**

Start with well-defined tasks: extract details from text, summarize a discussion against a checklist, or fix a specific coding issue. Give it the source material and a clear description of the result you need.

**How much text can GPT-5 Mini handle?**

Its context window is 400,000 tokens, and its maximum output is 128,000 tokens. Reasoning also consumes the generation budget, so that output limit does not mean 128,000 tokens of visible text.

**Does GPT-5 Mini know about recent events?**

Its built-in knowledge cutoff is May 31, 2024. Supply recent source material when dates, policies, or other changing details matter.

**How should I prompt GPT-5 Mini?**

State the task, separate the source text from your instructions, and specify the required format and length. Remove conflicting requirements and give a clear rule for missing information.

**When should I give GPT-5 Mini more reasoning effort?**

Test higher effort when a task involves difficult debugging or several dependent decisions. Lower effort is worth testing for straightforward work where less exploration is useful.

