---
title: "Install in Spinrun CLI"
description: "Add the Spinrun gateway to Spinrun CLI for run and Build surfaces."
url: https://docs.spinrun.ai/install/spinrun
markdown_url: https://docs.spinrun.ai/install/spinrun.md
---

# Install in Spinrun CLI

{/* GENERATED from @spinrun/clients stepsFor() — do not edit by hand. */}

## Run surface [#run-surface]

### 1. Install the CLI [#1-install-the-cli]

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

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

### 2. Sign in [#2-sign-in]

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

```bash
spinrun login
```

### 3. Use it [#3-use-it]

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

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

## Build surface [#build-surface]

### 1. Install the CLI [#1-install-the-cli-1]

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

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

### 2. Sign in [#2-sign-in-1]

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).

```bash
spinrun login
```

### 3. Author an agent [#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.

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

## Related [#related]

* [Install](https://docs.spinrun.ai/install.md)
* [Build vs run](https://docs.spinrun.ai/getting-started/build-vs-run.md)