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

# Install the CLI

> Install the sumvin command-line tool for your platform.

export const waitlists = {
  earlyAccess: "",
  payments: "",
  openBanking: "",
  developers: "",
  verifiers: ""
};

<Note>
  **Private preview:** this is rolling out and may not be available on your account yet.{waitlists.earlyAccess ? <> <a href={waitlists.earlyAccess}>Request early access →</a></> : null}
</Note>

<Warning>
  **The CLI is for developers.** It's mainly for people building and experimenting on Sumvin. The recommended way to use Sumvin is the [MCP connector](/get-started/connect), or the API if you're building (docs coming).

  An agent running in your terminal can approve Stamped Mandates that the CLI signs for you. Never give an unattended agent `--yes`.
</Warning>

The `sumvin` command-line tool gives your terminal the same capabilities as the connector: sign in, verify your identity, and manage Stamped Mandates and errands without leaving a shell.

<Tabs>
  <Tab title="Homebrew">
    ```bash theme={null}
    brew install sumvin/tap/sumvin
    ```
  </Tab>

  <Tab title="npm">
    ```bash theme={null}
    npx sumvin login
    ```

    Or with bun:

    ```bash theme={null}
    bunx sumvin login
    ```

    Either name works. `sumvin` is a thin alias for the `@sumvin/cli` package, so `npx @sumvin/cli login` runs the same thing.
  </Tab>

  <Tab title="Install script">
    ```bash theme={null}
    curl -fsSL https://get.sumvin.com/install.sh | sh
    ```

    Installs to a directory on your `PATH` and needs neither Node nor Bun. Pin a version with an environment variable:

    ```bash theme={null}
    SUMVIN_VERSION=v0.1.0 curl -fsSL https://get.sumvin.com/install.sh | sh
    ```
  </Tab>

  <Tab title="Binary">
    Download the binary for your platform from [Sumvin/cli-releases](https://github.com/Sumvin/cli-releases), check it against `SHA256SUMS` from the same release, then move it onto your `PATH`.

    ```bash theme={null}
    chmod +x sumvin
    mv sumvin /usr/local/bin/sumvin
    ```
  </Tab>
</Tabs>

<Note>
  Supported platforms: macOS (Apple Silicon and Intel) and Linux (x64 and arm64, glibc only — Alpine/musl isn't supported). Windows isn't supported yet.
</Note>

<Accordion title="Source code">
  The CLI's source isn't public yet. We plan to open-source it. It's built on the [Sumvin TypeScript SDK](https://github.com/Sumvin/sdk-ts), which is already open source, so you can use the same building blocks in your own tools today.
</Accordion>

## Verify the install

```bash theme={null}
sumvin --version
```

This prints the installed version. If it doesn't run, check that the binary is on your `PATH`.

<Tip>**Next:** [Sign in](/get-started/cli/sign-in) to connect the CLI to your account.</Tip>