# StormForge CLI

> Install and authenticate the StormForge CLI

---

Site [llms.txt](/llms.txt)

---

The StormForge CLI is a standalone binary that provides the core set of capabilities for managing StormForge. To connect AI agents to StormForge, use the [hosted MCP server](/docs/guides/mcp-server/).

<div class="alert alert-info" role="alert"><div class="h4 alert-heading" role="heading">Getting started</div>


- If you haven't already, create a StormForge account at [**app.stormforge.io/signup**](https://app.stormforge.io/signup).
- Alternatively, log in to our [**sandbox**](/docs/sandbox), then install and authenticate to explore the CLI without impacting workloads.
</div>


## Install

You can download and install using:


**Linux**

Choose one of the two methods below to install the StormForge CLI.

Copy the following command to a terminal window:

```bash
# Automatically selects either AMD64 or ARM64 architecture, downloads
# the appropriate binary, then moves it to a location in PATH
{ [ "$(uname -sm)" = "Linux x86_64"  ] && curl -L https://downloads.stormforge.io/stormforge-cli/latest/stormforge_linux_amd64.tar.gz | tar -xz; } ||
{ [ "$(uname -sm)" = "Linux aarch64" ] && curl -L https://downloads.stormforge.io/stormforge-cli/latest/stormforge_linux_arm64.tar.gz | tar -xz; } &&
sudo mv stormforge /usr/local/bin/
```

* * *

Download the appropriate Linux binary and extract the files.

[Amd64](https://downloads.stormforge.io/stormforge-cli/latest/stormforge_linux_amd64.tar.gz) | [Arm64](https://downloads.stormforge.io/stormforge-cli/latest/stormforge_linux_arm64.tar.gz)

Then, run:

```bash
sudo mv stormforge /usr/local/bin/
```

**Windows**

Choose one of the two methods below to install the StormForge CLI.

Download the appropriate Windows binary and extract the files.

[Amd64](https://downloads.stormforge.io/stormforge-cli/latest/stormforge_windows_amd64.zip) | [Arm64](https://downloads.stormforge.io/stormforge-cli/latest/stormforge_windows_arm64.zip)

Then, move `stormforge.exe` to a folder defined in your Windows PATH environment variable.

* * *

Run the following PowerShell install command:

```powershell
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
If ($env:PROCESSOR_ARCHITECTURE -eq "AMD64") { Invoke-WebRequest -Uri "https://downloads.stormforge.io/stormforge-cli/latest/stormforge_windows_amd64.zip" -Outfile "stormforge.zip" }
If ($env:PROCESSOR_ARCHITECTURE -eq "ARM64") { Invoke-WebRequest -Uri "https://downloads.stormforge.io/stormforge-cli/latest/stormforge_windows_arm64.zip" -Outfile "stormforge.zip" }
Expand-Archive "stormforge.zip" "." -WarningVariable $w; if ($w.Count -eq 0) { Remove-Item "stormforge.zip" } 
```

Then, move `stormforge.exe` to a folder defined in your Windows PATH environment variable.

**macOS**

Choose one of the three methods below to install the StormForge CLI.

Homebrew:

```sh
brew install thestormforge/tap/stormforge
```

* * *

Copy the following macOS install command to a terminal:

```bash
# Automatically selects either AMD64 or ARM64 architecture, downloads
# the appropriate binary, then moves it to a location in PATH
{ [ "$(uname -sm)" = "Darwin x86_64" ] && curl -L https://downloads.stormforge.io/stormforge-cli/latest/stormforge_darwin_amd64.tar.gz | tar -xz; } ||
{ [ "$(uname -sm)" = "Darwin arm64"  ] && curl -L https://downloads.stormforge.io/stormforge-cli/latest/stormforge_darwin_arm64.tar.gz | tar -xz; } &&
sudo mv stormforge /usr/local/bin/
```

* * *

Download the appropriate macOS binary and install it using your preferred binary installer.

[Amd64](https://downloads.stormforge.io/stormforge-cli/latest/stormforge_darwin_amd64.tar.gz) | [Arm64](https://downloads.stormforge.io/stormforge-cli/latest/stormforge_darwin_arm64.tar.gz)

**Docker**

We provide a container image at `registry.stormforge.io/library/stormforge-cli` (for `linux/amd64` and `linux/arm64`):

```bash
docker pull registry.stormforge.io/library/stormforge-cli
```

If you prefer to use the container image directly, set the `STORMFORGE_TOKEN` environment variable (from [`auth create -o token`](/docs/stormforge-cli/reference/#stormforge-auth-create)).



## Authenticate

Before using other CLI commands, authenticate your session:

```sh
stormforge login
```

This command opens a browser and attempts to authenticate using your StormForge account. If you aren't already logged in, you will be prompted to sign in.

See the [CLI reference for `stormforge login`](/docs/stormforge-cli/reference/#stormforge-login) for additional details and options.

Once authenticated, you're ready to use the StormForge CLI.

## Releases

For the list of CLI releases, see [StormForge CLI releases](/docs/releases/stormforge-cli/).

## Documentation

- Get started with common [StormForge CLI workflows](/docs/stormforge-cli/common-cli-workflows/)
- [Connect AI agents to StormForge with MCP](/docs/guides/mcp-server/)
- View the full [StormForge CLI command reference](/docs/stormforge-cli/reference/)

---

Section pages:

- [Common StormForge CLI workflows](/docs/stormforge-cli/common-cli-workflows/): Common StormForge CLI tasks, from authentication to managing recommendations
- [Reference](/docs/stormforge-cli/reference/): Commands and options for the StormForge CLI