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

# Quickstart

> Get up and running with SuprSend CLI in minutes. Complete setup, authentication, and start using right away.

<Note>
  If you install a binary (Homebrew, GitHub Releases, or source build), we recommend verifying the CLI signature to confirm the binary was built by SuprSend and has not been modified in transit. See [Verify CLI Signature](/reference/cli-verify-signature). Signature verification isn't needed when you run via `npx` — npm registry integrity checks handle that for you.
</Note>

## Step 1: Run the CLI

The fastest way to use the SuprSend CLI is with [`npx`](https://docs.npmjs.com/cli/v10/commands/npx) — no install step, always the latest version. Requires [Node.js](https://nodejs.org/) 18+.

<Tabs>
  <Tab title="npx (Recommended)">
    **Zero-install. Works on macOS, Linux, and Windows.**

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

    Every invocation uses the latest published CLI. Run any command the same way:

    ```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>
  </Tab>

  <Tab title="Homebrew">
    **For macOS or Linux users who prefer a package-manager install.**

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

  <Tab title="Binary Releases">
    **Best for Windows users, servers or CI/CD environments without Node.js.**

    Download the binary for your platform from [GitHub Releases](https://github.com/suprsend/cli/releases) and install it:

    <Tabs>
      <Tab title="macOS / Linux">
        ```bash theme={"system"}
        chmod +x suprsend
        sudo mv suprsend /usr/local/bin/
        ```
      </Tab>

      <Tab title="Windows">
        Extract `suprsend.exe` from the downloaded `.zip` and move it to a directory on your `PATH`, such as `C:\Windows\System32`.
      </Tab>
    </Tabs>
  </Tab>

  <Tab title="Source Build">
    **Best for project contributors** or advanced users who want to always have access to the latest binary.

    Requires Go (version 1.20 or later).

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

    # 2. Build the binary
    go build -o suprsend

    # 3. Move the binary to your PATH for easy access
    sudo mv suprsend /usr/local/bin/
    ```
  </Tab>
</Tabs>

***

## Step 2: Authentication

Get your service token from [SuprSend Dashboard → **Account Settings** → **Service Tokens**](https://app.suprsend.com/en/account-settings/service-tokens).

Set it as an environment variable so all CLI commands can use it automatically, or — if you're using the CLI to start the MCP server — pass it as a command flag in your MCP tool setting:

```bash Setting as Environment Variable theme={"system"}
export SUPRSEND_SERVICE_TOKEN="your_service_token_here"
```

```bash Passing service token as a command flag theme={"system"}
npx suprsend start-mcp-server --service-token "your_service_token_here"
```

<Note type="warning">
  Passing tokens as flags may expose them in shell history. Environment variables are preferred for anything persistent.
</Note>

***

## Step 3: Enable Autocompletion (Optional)

Enable [autocompletion](/reference/cli-autocompletion) to get command and flag suggestions with Tab and prevent typos.

***

## You're all set!

You can start using the CLI now:

```bash theme={"system"}
npx suprsend workflow list
```