Spinrun Docs
Install

Install in Spinrun CLI

Add the Spinrun gateway to Spinrun CLI for run and Build surfaces.

Run surface

1. Install the CLI

One command. It verifies its own download, installs to ~/.spinrun, and adds itself to your PATH.

curl -fsSL https://spinrun.ai/install | sh

2. Sign in

Opens your browser once, then picks up the workspace you choose. No key to copy.

spinrun login

3. Use it

Find a tool by describing what you want, then run it.

spinrun search "create an issue"
spinrun execute GITHUB_CREATE_ISSUE -d '{"owner":"acme","repo":"api","title":"..."}'

Build surface

1. Install the CLI

One command. It verifies its own download, installs to ~/.spinrun, and adds itself to your PATH.

curl -fsSL https://spinrun.ai/install | sh

2. Sign in

Opens your browser once, then picks up the workspace you choose. Tick "Build authorization" on the consent screen, or enable it later under Settings → Applications (workspace owners only).

spinrun login

3. Author an agent

Read an agent as a JSON document, edit it, and put it back. The CLI sends the document's updated_at as If-Match so a concurrent edit is refused rather than overwritten.

spinrun agent list
spinrun agent get my-agent > agent.json
spinrun agent put --file agent.json

On this page