# Sendsets CLI

Use the `sendsets` CLI to drive SendSets as a signed-in user - sign in with `sendsets...

- Repository: https://github.com/hashgraph-online/awesome-codex-plugins (1479 stars)
- Category: Testing
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add hashgraph-online/awesome-codex-plugins --skill sendsets-cli -g -a claude-code -y`
Codex: `npx skills add hashgraph-online/awesome-codex-plugins --skill sendsets-cli -g -a codex -y`
Cursor: `npx skills add hashgraph-online/awesome-codex-plugins --skill sendsets-cli -g -a cursor -y`
Gemini CLI: `npx skills add hashgraph-online/awesome-codex-plugins --skill sendsets-cli -g -a gemini-cli -y`

## Description

Use the `sendsets` CLI to drive SendSets as a signed-in user - sign in with `sendsets login`, run `sendsets doctor`, then connect the app (`connection`), add or test mailboxes and their warmup (`mailbox`), send product events (`events send`), and build, validate, test and launch campaigns, including app_action and wait_for_event steps, on the hosted service or any self-hosted instance. Use whenever the task is to set up or operate SendSets from a terminal or a script and a `sendsets` binary is available, with no dashboard. For instance recovery and accounts (database-level), use sendsets-ops instead.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Driving SendSets through the `sendsets` CLI

`sendsets` is the customer CLI: it signs in as a person, keeps its own
credential, and speaks only the public REST API. Every command is bounded by the
scopes the sign-in approved. Never open, print or copy the CLI's stored
credential; `sendsets auth status --json` says everything an agent needs.

If the binary is not on PATH, install it without a toolchain or root:

Install it with `brew install addisonhoff/tap/sendsets` (macOS, Linux) or `scoop bucket add sendsets https://github.com/AddisonHoff/homebrew-tap` then `scoop install sendsets` (Windows). Without a package manager, download the archive for your platform and `checksums.txt` from https://github.com/AddisonHoff/sendsets-releases/releases/latest, check the archive against `checksums.txt`, and unpack the `sendsets` binary onto PATH. It is also inside the
backend image on a self-hosted instance (`docker compose -p sendsets exec
backend sendsets ...`).

It is not `sendsetsctl`. That one talks to Postgres and exists for recovery and
accounts (the `sendsets-ops` skill). If both are available and the task is
product work, use `sendsets`.

## The setup order

From nothing to a launched campaign, every step is a command and every failure
prints a `fix:` line:

The rest: https://github.com/hashgraph-online/awesome-codex-plugins/blob/HEAD/plugins/AddisonHoff/sendsets/skills/sendsets-cli/SKILL.md