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

Windsurf · LLMReleased 2026-09-08

How to Use Nex-N2.5 Mini in Windsurf

Nex-N2.5 Mini suits coding, browser tasks, and work that needs repeated checks. It trails Nex-N2.5 Pro on Nex AGI's SWE-Bench Pro evaluation, making bounded fixes with explicit tests a sensible starting point.

Prompts to try with Nex-N2.5 Mini in Windsurf

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

Use Nex-N2.5 Mini to reproduce the failing test in this project, find its cause, make the smallest reasonable fix, and rerun it. Report the changed files and actual test result.

Nex-N2.5 MiniWindsurf
Try asking
  • Use Nex-N2.5 Mini to inspect this project's search page and fix the filter-reset bug. Verify that resetting filters restores the full result list and preserves keyboard access.

  • Use Nex-N2.5 Mini with reasoning_effort high to investigate this intermittent parser failure. Build a minimal reproduction, test the suspected cause, and add a regression check before changing the parser.

  • Use Nex-N2.5 Mini to add empty-state handling to this project's results component. Follow existing styles and verify populated, empty, and error states in the browser.

  • Use Nex-N2.5 Mini to diagnose the project's failing build command. Test a focused correction, rerun the build, and distinguish resolved errors from remaining failures.

How to set up Nex-N2.5 Mini in Windsurf

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

Use Spiral's MCP server

  1. Add the server

    Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:

    {
      "mcpServers": {
        "spiral": {
          "url": "https://api.spiral.ai/mcp"
        }
      }
    }
  2. Sign in

    Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

    devin mcp login spiral
  3. Check it

    Spiral is listed under This computer in Customize › MCPs. From the terminal:

    devin mcp list

Use the Spiral skill

  1. Send Windsurf 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 Nex-N2.5 Mini

    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": "nex-agi/nex-n2.5-mini",
        "input": {
          "messages": [
            {
              "role": "system"
            }
          ]
        }
      }'

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

Nex-N2.5 Mini providers and prices

Spiral runs Nex-N2.5 Mini through OpenRouter. Open a card for today's price, with every fee included.

OpenRouterLLM
Nex AGI: Nex-N2.5-Mini
nex-agi/nex-n2.5-mini

Settings you can ask for

Ask Windsurf for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Top ka whole number from 0
Top p0 to 1
Logprobson or off
Max tokens1 to 235929

The most output tokens to generate.

Temperature0 to 2
Top logprobs0 to 20
Reasoning effortnone, medium, or highhigh

How much the model reasons.

Every API field of Nex AGI: Nex-N2.5-Mini is on its tool page: open its card above.

What can you do with Nex-N2.5 Mini in Windsurf?

Turn a reproducible problem into a patch with evidence that it works. Give Nex-N2.5 Mini relevant project files, a narrow scope, and a specific test or browser check.

Fix a reproducible bug

Give Nex-N2.5 Mini the failing behavior and expected result. Ask for a focused patch, a regression check, and the observed outcome.

Check a browser workflow

Have Nex-N2.5 Mini work through a defined path, such as searching a catalog and applying filters. Request expected versus observed behavior for each step.

Implement a bounded feature

Describe one feature with clear acceptance criteria. Ask Nex-N2.5 Mini to implement it and demonstrate the result through tests or browser checks.

Investigate a technical question

Ask Nex-N2.5 Mini to research a specific question, compare primary sources, and produce a short answer with links and unresolved points.

Reproduce a calculation

Provide an equation, assumptions, and expected units. Ask Nex-N2.5 Mini to write and run a calculation, check edge cases, and explain discrepancies.

Investigate a failed command

Use Nex-N2.5 Mini to trace a repeatable command failure, test a proposed correction, and report the command's actual result.

Monitor a public website

Give Nex-N2.5 Mini a fixed checklist for public pages. Request a dated report of broken navigation, changed content, and issues it could reproduce.

Questions about Nex-N2.5 Mini in Windsurf

Can Windsurf use Nex-N2.5 Mini?

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

How much does Nex-N2.5 Mini cost in Windsurf?

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

Do I need an OpenRouter account to use Nex-N2.5 Mini in Windsurf?

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

How long does it take to set up Nex-N2.5 Mini in Windsurf?

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

Does Windsurf wait while Nex-N2.5 Mini runs?

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

What is Nex-N2.5 Mini good at?

Its intended uses include coding, browser tasks, software testing, and research that requires checking results. Give it an observable finish line, such as a passing test or a finding backed by a source.

How does Nex-N2.5 Mini compare with Nex-N2.5 Pro?

Nex AGI positions Mini for fast instruction following and tool execution. Its published SWE-Bench Pro score is 43.8 versus Pro's 61.2, so start Mini with narrowly scoped changes and concrete acceptance tests.

How much context can Nex-N2.5 Mini handle?

The context window is 262,144 tokens. Keep the task, relevant evidence, and acceptance criteria together instead of filling the request with unrelated material.

When should I use adaptive or high thinking?

Adaptive thinking lets Nex-N2.5 decide whether and how much to think; high thinking always enables it. Try adaptive thinking for routine work and high thinking for a difficult diagnosis, then judge the result against your tests.

Which sampling settings should I start with?

Nex AGI's recommended starting values are temperature 0.7, top-p 0.95, and top-k 40. Use those as a baseline before changing one setting at a time.

Get started

Start using Nex-N2.5 Mini in Windsurf

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Windsurf:

Set up Windsurf

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options