> ## Documentation Index
> Fetch the complete documentation index at: https://docs.suprsend.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Steps to install the SuprSend CLI

### npx (Recommended)

**Best for almost everyone** — zero install, always on the latest version. Requires [Node.js](https://nodejs.org/) 18+. Works on macOS, Linux, and Windows.

```bash theme={"system"}
npx suprsend --help
```

Every invocation fetches and caches the latest CLI, so you can run any command without a global install:

```bash theme={"system"}
npx suprsend workflow list
npx suprsend start-mcp-server
```

<Tip>
  If you run CLI commands frequently, add an alias like `alias suprsend="npx -y suprsend"` to your shell profile so you can just type `suprsend ...`.
</Tip>

### Homebrew

**Best for developers on macOS or Linux** who prefer a package-manager-managed install and don't want Node.js as a dependency.

```bash theme={"system"}
brew tap suprsend/tap
brew install --cask suprsend
```

### Binary Releases

**Best for servers, CI/CD environments, or Windows users** who want a pre-compiled binary without relying on Node.js or package managers.

Download from [GitHub Releases](https://github.com/suprsend/cli/releases).

```bash theme={"system"}
# Linux/macOS
chmod +x suprsend
sudo mv suprsend /usr/local/bin/

# Windows: Extract suprsend.exe to your PATH
```

### Source Build

**Best for contributors or advanced users** who want the latest unreleased features by building from source. Works on macOS, Linux, and Windows with Go installed.

To build SuprSend CLI from source, follow these steps:

1. Ensure you have Go installed on your system (version 1.20 or later).

2. Clone the repository:

```bash theme={"system"}
git clone https://github.com/suprsend/cli.git
cd cli/cmd/suprsend
```

3. Build the binary:

```bash theme={"system"}
go build -o suprsend
```

4. The binary will be created in the current directory. You can move it to a location in your PATH for easy access:

```bash theme={"system"}
sudo mv suprsend /usr/local/bin/
```

## Verify Installation

After installation, you can use the CLI by running the `suprsend` command (or `npx suprsend` if you're using npx). For example:

```bash theme={"system"}
npx suprsend --help
npx suprsend version
```

<Note>
  When you run `suprsend version`, you should see the latest version (currently **v1.0.0**). If you see an older version, you may need to update your installation. With `npx suprsend`, you always get the latest published release automatically.
</Note>

***

## Community Contribution

We welcome community contributions to improve the SuprSend CLI. If you’d like to add features, fix bugs, or improve documentation:

* Visit the [SuprSend CLI GitHub repository](https://github.com/suprsend/cli)
* Fork the repo and create a feature branch
* Open a Pull Request with a clear description of your changes and we'll review and merge it.