How to Use Weaver Alpha in VS Code
Weaver Alpha is for descriptive fiction, character dialogue, and roleplay that calls for longer replies. It aims for Claude-style verbosity, with an explicit warning that coherence and memory will fall short of Claude.
Prompts to try with Weaver Alpha in VS Code
Copy an example into VS Code, or ask in your own words.
Use Weaver Alpha to draft 12 lines of dialogue for the harbor guard using the project's character notes. Keep each line under 20 words, preserve the guard's distrust of strangers, and show me the draft before editing files.
Read the project's lighthouse quest outline, then use Weaver Alpha to write a 350-word arrival scene. Keep all established names and locations, use second person, and stop before the player enters the tower.
Use Weaver Alpha to draft three responses to the player's refusal of the merchant's offer, based on the project's dialogue tree. Make them angry, disappointed, and amused, with no new quest facts.
From the project's lore notes, prepare a brief under 1,000 words and use Weaver Alpha to draft a 250-word journal entry by the missing cartographer. Keep the island's secret out of the entry.
Use Weaver Alpha to rewrite the project's opening tavern description in 200 words with a more uneasy tone. Preserve the exits, objects, and people already listed, and return prose for review.
How to set up Weaver Alpha in VS Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
Use Add to VS Code on the console's Agents & MCP page, or run:
code --add-mcp '{"name":"spiral","type":"http","url":"https://api.spiral.ai/mcp"}' - Sign in
VS Code asks you to sign in when it first starts the server: sign in to Spiral and click Authorize. No API key. Run MCP: List Servers from the Command Palette to check that Spiral is running.
Use the Spiral skill
- Send VS Code this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- Run Weaver Alpha
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": "mancer/weaver", "input": { "messages": [ { "role": "system" } ] } }'
Then paste one of the prompts above: VS Code finds Weaver Alpha on Spiral, shows the price and runs it.
Weaver Alpha providers and prices
Spiral runs Weaver Alpha through OpenRouter. Open a card for today's price, with every fee included.
Up to $0.002677 per run at the default inputs. $0.39 per 1M input tokens, $0.65 per 1M output tokens.
Settings you can ask for
Ask VS Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Seed | a whole number | ||
| Min p | 0 to 1 | ||
| Top k | a whole number from 0 | ||
| Top p | 0 to 1 | ||
| Logprobs | on or off | ||
| Max tokens | 1 to 6000 | The most output tokens to generate. | |
| Temperature | 0 to 2 | ||
| Top logprobs | 0 to 20 | ||
| Presence penalty | -2 to 2 | ||
| Frequency penalty | -2 to 2 | ||
| Repetition penalty | 0 to 2 |
Every API field of Mancer: Weaver (alpha) is on its tool page: open its card above.
What can you do with Weaver Alpha in VS Code?
Create dialogue, quest descriptions, and scene drafts for a game project. Have your coding agent supply a compact brief from the project's lore, then review the prose before adding it to the game.
Game character dialogue
Ask Weaver Alpha for a conversation between a suspicious innkeeper and a stranded traveler. Supply each character's motive and the information they must withhold.
Short story scenes
Give Weaver Alpha an outline for one scene and request a prose draft with a fixed viewpoint, a clear conflict, and a specific stopping point.
Tabletop encounter narration
Use Weaver Alpha to draft a location introduction and an NPC's opening speech. Keep hidden information separate from the text players will hear.
Interactive fiction branches
Ask Weaver Alpha for three short responses to a player's decision. State the story facts that every branch must preserve, then review the results for contradictions.
Character voice exploration
Have Weaver Alpha write the same apology as a proud captain, a frightened apprentice, and an evasive merchant. Compare the dialogue before choosing a voice.
Fictional letters and journals
Ask Weaver Alpha for an in-world letter or diary entry based on a short character brief. Specify what the writer knows and what they misunderstand.
Alternate scene drafts
Give Weaver Alpha one scene brief and request separate versions emphasizing tension, melancholy, or humor. Preserve the same events so you can compare tone.
More on Weaver Alpha and VS Code
Overview
Weaver Alpha in other agents
More VS Code guides
Questions about Weaver Alpha in VS Code
Can VS Code use Weaver Alpha?
Yes. Add Spiral to VS Code as an MCP server, and VS Code can find and run Weaver Alpha like any built-in tool.
How much does Weaver Alpha cost in VS Code?
Up to $0.002677 per run at the default inputs. $0.39 per 1M input tokens, $0.65 per 1M output tokens. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your VS Code plan is separate.
Do I need an OpenRouter account to use Weaver Alpha in VS Code?
No. Spiral runs Weaver Alpha on its own OpenRouter account. You sign in to Spiral once and never paste a key.
How long does it take to set up Weaver Alpha in VS Code?
About two minutes: add the hosted server, then sign in.
Does VS Code wait while Weaver Alpha runs?
Weaver Alpha runs in the background. VS Code starts the run, checks on it and gives you the text, json when it's ready.
What is Weaver Alpha best used for?
Its stated focus is roleplay and narrative writing with verbose replies. Try it for descriptive scenes, fictional conversations, and character monologues.
Does Weaver Alpha write like Claude?
It attempts Claude-style verbosity. Its description explicitly warns that coherence and memory do not reach the same level, so review continuity before accepting a draft.
How much can Weaver Alpha write in one response?
The maximum output is 6,000 tokens, within an 8,000-token context window. Leave room for the reply when supplying character notes and previous dialogue.
How should I prompt Weaver Alpha for an ongoing story?
Given the stated memory limitation, include a short recap, the current scene, and the facts that must stay fixed. Ask for one scene at a time and check each draft against those notes.
How do I make Weaver Alpha's revisions more predictable?
Lower the temperature and keep the creative brief unchanged while comparing drafts. Treat this as a sampling adjustment, not a guarantee of accurate continuity.
Start using Weaver Alpha in VS Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into VS Code:
set up https://spiral.ai/SKILL.md


