SuprSend CLI

SuprSend CLI is a command-line interface tool for interacting with the SuprSend API, written in Go. It also doubles as an MCP server so AI agents (Claude, Cursor, Gemini, etc.) can drive your workspace through the same set of operations.

What you can do with it

• Manage workspace resources — `template`, `workflow`, `schema`, `event`, `category`, `translation`, `workspace`. Each supports `list`, `get`, `pull`, `push`, `commit` against your local working directory.
• Sync between workspaces — `suprsend sync` pulls assets from one workspace and pushes to another, with an optional local directory as intermediate storage.
• Generate typed payload code — `suprsend generate-types` emits typed code in Go, TypeScript, Python, Java, Kotlin, Swift, or Dart from your event / workflow JSON Schemas.
• Run as an MCP server — `suprsend start-mcp-server` exposes tools over stdio/SSE/HTTP. Installable directly from the MCP Registry (`npx -y suprsend start-mcp-server`), or wire it into Claude Code / Cursor / Gemini CLI manually.
• Multi-account / multi-environment profiles — `suprsend profile add|modify|list|use|remove` stores per-account credentials and base URLs, so the same CLI works against public cloud, BYOC, staging, pre-prod, etc.

Full command reference: docs.suprsend.com/reference/cli-intro. Or run `suprsend --help` for the command tree.

Installation

npm / npx

Run without installing:

npx suprsend --help

Or install globally:

npm i -g suprsend
suprsend --help

Works on macOS, Linux, and Windows (x64 and arm64). Requires Node.js ≥ 18 (for `npx`).

Homebrew

You can install SuprSend CLI using Homebrew:

brew tap suprsend/tap
brew install --cask suprsend

Binary Releases

Pre-compiled binaries for various platforms are available on the Releases page.

Building from Source

To build SuprSend CLI from source, follow these steps:

1. Ensure you have Go installed on your system (version 1.25 or later — see `go.mod`).

2. Clone the repository:

git clone https://github.com/suprsend/cli.git
    cd cli/cmd/suprsend

3. Build the binary:

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:

sudo mv suprsend /usr/local/bin/

Now you can use the `suprsend` command from anywhere in your terminal.

Usage

After installation, you can use the CLI by running the `suprsend` command. For example:

suprsend --help

Documentation

Please refer to documentation here OR if you want to access the cobra generated docs those are here

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Generating build artifacts locally

`make build` compiles the embedded type-morph Deno binary (requires Deno), then generates CLI documentation in `docs/` and AI skills in `skills/`.

make build

A CI check on PRs to `main` verifies that `docs/` and `skills/` are up to date. Run `make build` and commit the output before opening a PR.

Removing local build artifacts

make clean

License

This project is licensed under the MIT License - see the LICENSE file for details.