[Integrations](https://spiral.ai/integrations) › [Raycast](https://spiral.ai/integrations/raycast) › [gpt-oss-20b](https://spiral.ai/integrations/raycast/gpt-oss-20b)

# How to Use gpt-oss-20b in Raycast

gpt-oss-20b handles coding, reasoning, and tool-assisted text tasks. OpenAI positions it for lower latency and specialized work, while gpt-oss-120b targets more demanding reasoning.

|  |  |
| --- | --- |
| Model | gpt-oss-20b |
| Available through | OpenRouter |
| Category | LLM |
| Price | Up to $0.000695 per run at the default inputs. $0.039 per 1M input tokens, $0.169 per 1M output tokens. |
| Returns | text, json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with gpt-oss-20b in Raycast

- Use gpt-oss-20b with medium reasoning effort to explain the technical passage I paste next. Define unfamiliar terms, give one worked example, and identify assumptions the passage leaves unstated.
- Use gpt-oss-20b with high reasoning effort to check the math solution I paste next. Check units and assumptions, use a calculation tool if available, and give the corrected result with a brief explanation.
- Use gpt-oss-20b to turn the support messages I paste next into a JSON array. For each message, include its topic, requested action, and any stated deadline; use null for missing details.
- Use gpt-oss-20b to answer questions about the policy text I paste next. Support each answer with a short passage from the text and say when the policy does not provide an answer.
- Use gpt-oss-20b with low reasoning effort to explain the error message and code snippet I paste next. Give the likely cause and one small example of a correction.

## How to set up gpt-oss-20b in Raycast

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

### Use the Raycast connector

1. **Install the server**: In Raycast run Install MCP Server. Name it Spiral, set Transport to HTTP, paste this URL and keep OAuth Type on Dynamic:

```text
https://api.spiral.ai/mcp
```

2. **Sign in to Spiral and approve**: Spiral opens in your browser: sign in, pick the organization and click Authorize. No API key. Spiral gives the connection its own key; Raycast never sees it, and you can remove it under Settings › Connected apps in the console.

### Use the Spiral skill

1. **Send Raycast 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-oss-20b**: 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": "openai/gpt-oss-20b",
    "input": {
      "messages": [
        {
          "role": "system"
        }
      ]
    }
  }'
```

Then paste one of the prompts above: Raycast finds gpt-oss-20b on Spiral, shows the price and runs it.

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

## gpt-oss-20b tools and prices

- [OpenAI: gpt-oss-20b](https://spiral.ai/tools/openrouter/openai/gpt-oss-20b) (OpenRouter): Up to $0.013037 per run at the default inputs. $0.0221 per 1M input tokens, $0.1105 per 1M output tokens.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| seed |  | — |  |
| stop |  | — |  |
| min_p | 0 to 1 | — |  |
| tools |  | — |  |
| top_k | 0 to … | — |  |
| top_p | 0 to 1 | — |  |

## What can you do with gpt-oss-20b in Raycast?

gpt-oss-20b can help explain technical questions and turn supplied text into organized answers. Provide the passage or problem and specify the evidence and detail you want in the response.

### Debug a failing test

Give gpt-oss-20b the failure output and relevant code. Ask for a minimal fix and a regression test that reproduces the problem.

### Review a code change

Ask gpt-oss-20b to inspect a diff for logic errors, missed edge cases, and assumptions that need tests.

### Extract structured records

Turn support messages or intake text into JSON records. Specify the required keys and use null for information the source does not contain.

### Explain technical material

Provide a technical passage and ask gpt-oss-20b to explain its assumptions, define unfamiliar terms, and work through a small example.

### Check a quantitative argument

Ask gpt-oss-20b to examine units, assumptions, and calculations in a proposed solution. Use an available Python tool to verify the arithmetic.

### Draft answers from reference text

Supply policy or product documentation and ask for answers with supporting passages. Require an explicit unknown when the text does not answer the question.

### Triage recurring operational reports

Use gpt-oss-20b to classify supplied incident summaries, identify repeated symptoms, and propose the next diagnostic question for each unresolved issue.

## Overview

- [OpenRouter](https://spiral.ai/providers/openrouter)
- [All Raycast guides](https://spiral.ai/integrations/raycast)

## gpt-oss-20b in other agents

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

## More Raycast guides

- [Weaver Alpha](https://spiral.ai/integrations/raycast/weaver-alpha)
- [o3](https://spiral.ai/integrations/raycast/o3)
- [Voxtral Small 24B](https://spiral.ai/integrations/raycast/voxtral-small-24b)
- [o3-pro](https://spiral.ai/integrations/raycast/o3-pro)
- [Venice Uncensored](https://spiral.ai/integrations/raycast/venice-uncensored)
- [AI Ark company search](https://spiral.ai/integrations/raycast/ai-ark-company-search)

## Questions about gpt-oss-20b in Raycast

**Can Raycast use gpt-oss-20b?**

Yes. Add Spiral to Raycast as an MCP server, and Raycast can find and run gpt-oss-20b like any built-in tool.

**How much does gpt-oss-20b cost in Raycast?**

Up to $0.000695 per run at the default inputs. $0.039 per 1M input tokens, $0.169 per 1M output tokens. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Raycast plan is separate.

**Do I need an OpenRouter account to use gpt-oss-20b in Raycast?**

No. Spiral runs gpt-oss-20b on its own OpenRouter account. You sign in to Spiral once and never paste a key.

**How long does it take to set up gpt-oss-20b in Raycast?**

About two minutes: install the server, then sign in to Spiral and approve.

**Does Raycast wait while gpt-oss-20b runs?**

gpt-oss-20b runs in the background. Raycast starts the run, checks on it and gives you the text, json when it's ready.

**What is gpt-oss-20b good at?**

Coding, reasoning, and tasks that combine text with tool calls are its clearest fits. Try focused bug fixes, technical explanations, and extracting structured records from supplied text.

**How much text can gpt-oss-20b handle?**

OpenAI lists a 131,072-token context window and a maximum output of 131,072 tokens. Treat those as model specifications, rather than a target length for every answer.

**Can gpt-oss-20b understand screenshots or recordings?**

It processes text only. For a screenshot or recording, provide extracted text or a transcript and ask questions about that text.

**Which reasoning level should I choose?**

Start with low effort for straightforward dialogue and medium for everyday analysis. Try high effort for difficult debugging or multistep problems, then compare results on representative tasks.

**Which languages should I use with gpt-oss-20b?**

Its training data was mostly English, with an emphasis on STEM, coding, and general knowledge. For another language, test examples from your actual task before relying on the results.

