Skip to main content
1

Add the server

Leave out --global to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.
2

Sign in

Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, /mcps starts the same sign-in.
3

Check it

Spiral shows as connected.
4

Try a starter prompt

Create a key in the console under API keys, keep it in SPIRAL_API_KEY, and put this in opencode.json:
This installs spiral, signs you in through the browser and adds Spiral’s skill for opencode (~/.agents/skills), so the agent can also run spiral commands in the terminal. It needs Node.js 22.12 or later.
If something does not work, see Troubleshooting.