SkillAgentSearch skills...

sendsets-cli

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…

Install / Use

npx skills add hashgraph-online/awesome-codex-plugins --skill sendsets-cli

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

93/100

Supported Platforms

Universal

Tags

Our assessment of sendsets-cli

sendsets-cli scores 93/100 on our quality scale, 770th of 4,698 Development & Engineering skills we index (top 17%).

Its SKILL.md is 13 KB long, well organised into 10 sections with 5 code examples: a thorough specification that gives an agent plenty to work with.

With 1,075 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
30/30
Structure
20/20
Description
15/15
Adoption
13/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so sendsets-cli is actively maintained.
  • Our last check on 2026-10-25 found the source still online.
  • It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-07. Automated pattern scan on 2026-10-07. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

sendsets-cli compared with similar skills

All 4 of these similar skills score higher than sendsets-cli; compare them before choosing.

SkillScoreStarsUpdatedFormat
sendsets-cli (this skill)by hashgraph-online931.1k53d agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md
claude-howtoby luongnv8910047.3k2d agoCLAUDE.md
lobehubby lobehub10085.6ktodayMCP Server

Frequently asked questions

How do I install sendsets-cli?
Run npx skills add hashgraph-online/awesome-codex-plugins --skill sendsets-cli. The install tabs above show the steps for each supported agent.
Which AI agents does sendsets-cli work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is sendsets-cli safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is sendsets-cli still maintained?
The repository was last updated about 2 months ago, so sendsets-cli is actively maintained.

name: sendsets-cli 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.

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:

sendsets login --hostname sendsetsapi.com   # or SENDSETS_TOKEN=ssk_... plus SENDSETS_HOST=sendsetsapi.com
sendsets whoami                     # workspace, credential, scopes, agent policy
sendsets doctor                     # what is set up, what is not, a fix per gap; exit 1 when not ready
sendsets connection create --name app --base-url https://app.example.com/sendsets   # secret printed once
sendsets connection test CONNECTION_ID
sendsets mailbox add --provider outlook                                           # prints a Microsoft consent link
sendsets mailbox provision providers                                                              # what can be ordered, with live per-mailbox pricing
sendsets mailbox provision renewals                                                               # when managed domains renew, and anything needing a person
sendsets mailbox provision --provider google --count 3 --domain acme-outreach.com --warmup --wait   # SendSets Cloud: managed inboxes, checkout link for the user
sendsets mailbox provision --provider google --count 25 --domains a.com,b.com,c.com --warmup        # spread mailboxes across several domains
sendsets mailbox test MAILBOX_ID
sendsets mailbox warmup enable MAILBOX_ID
sendsets events send trial.started --email jane@acme.com --data '{"plan":"pro"}'
sendsets campaign create --name "Q3" --daily-limit 25 --stop-on-reply                         # 25 per mailbox per day, not per campaign
sendsets campaign add-step CAMPAIGN_ID --subject "..." --body-plain "Hi {{.FirstName}}"
sendsets campaign add-step CAMPAIGN_ID --kind app_action --connection CONNECTION_ID --path /audit --output-key audit --inputs '{"domain":"{{.Company}}"}'
sendsets campaign add-step CAMPAIGN_ID --kind wait_for_event --event report.opened --timeout-minutes 4320
sendsets campaign set-senders CAMPAIGN_ID --input '{"senders":[{"email_account_id":"MAILBOX_ID"}]}'
sendsets campaign validate CAMPAIGN_ID     # exit 1 with the problems and fixes when it cannot launch
sendsets campaign test CAMPAIGN_ID --prospect you@example.com --wait   # real mail, real app calls, one prospect
sendsets events send report.opened --email you@example.com             # from another shell when the test waits
sendsets campaign start CAMPAIGN_ID        # policy or human approval decides

Run sendsets doctor again whenever something fails; it names the gap.

Getting authenticated

Check first, because a non-interactive agent cannot complete a browser flow:

sendsets auth status
  • Signed in (exit 0): carry on.
  • Not signed in (exit 4): you need a credential. In order of preference:
    1. SENDSETS_TOKEN in the environment. It overrides everything and is never written to disk, so it is the right answer for a script or a CI job.
    2. echo "$KEY" | sendsets auth login --with-token, when a key was supplied.
    3. sendsets auth login, which needs a human at a browser. Print the code and the URL it shows and hand back to the user; do not sit in the poll loop waiting for something only they can do.

Set SENDSETS_HOST (or --host) for a self-hosted instance, and SENDSETS_API_URL only when the API is not at api.<host>.

Exit code 4 always means the credential: missing, rejected, or short a scope. sendsets auth status names which, and where the token came from.

Output: always ask for JSON

Tables are for humans. Every command takes --json, and output is JSON automatically when stdout is not a terminal, but pass it explicitly so the shape does not depend on how you were invoked.

sendsets campaign list --json
sendsets campaign list --json --all      # every page, cursor followed
sendsets contact list --json --limit 100

Lists are {"data": [...], "pagination": {"next_cursor", "has_more"}}. Page with --cursor <next_cursor>, or let --all do it. Cursors are opaque, never construct one, and a cursor belongs to the ordering it came from: changing the sort halfway through a walk is rejected, not silently reordered.

Command map

sendsets <command> --help lists subcommands; sendsets <command> <sub> --help gives the arguments and flags. Ids are positional, not flags.

| Command | Covers | |---|---| | login, logout, whoami, auth | the credential; whoami shows workspace, scopes and the effective agent policy | | doctor | the readiness checklist: auth, API, workspace, app connections (pinged), product events, mailboxes, runtime | | status | one call for "what is happening": mailboxes needing attention, what is sending, what is unread | | connection | list, create, get, update, delete, rotate-secret, test: the app your campaigns call | | events | send <name> (records a product event, names the steps it resumed), list, get, tail | | mailbox | list, get, add, update, delete, enable, disable, test, health, recheck, hold, release, sync, identity, warmup enable/disable/pause/resume/status, and provision [quote/status/list/cancel] | | campaign | list, create, edit, status, steps, add-step, edit-step, delete-step, senders, set-senders, preflight, validate, test-email, start, stop, logs, import | | run | a campaign YAML file as a durable, policy-checked run | | inbox | list, read, draft, reply | | stats, policy show | the headline numbers; the calling credential's agent policy and budget | | api | any endpoint at all, including contacts (/contacts), suppressions, segments, webhooks, keys |

Checklist commands (doctor, connection test, mailbox test, campaign validate) print a tick or cross per row with a fix: line under a failure and exit 1 when not ready; with --json they emit {checks, ready}. The campaign test walk-through of one prospect through the real runtime is the same shape.

Anything without a command is reachable through the passthrough. Paths are relative to /v1:

sendsets api "/campaigns?limit=10" --paginate
sendsets api /contacts -f email=jane@example.com -f first_name=Jane
sendsets api /campaigns/CAMPAIGN_ID -X PATCH -F daily_limit=40
sendsets api /contacts/search -X POST --input filter.json

-f keeps a string, -F guesses the type (true, null, numbers, @file), key[sub]=v nests, repeated key[]=v builds an array.

Sending safety, read before anything that sends

These put real mail on the wire and prompt before doing so: campaign test, campaign test-email, mailbox send, inbox reply, inbox compose, inbox approve-draft. campaign start and inbox reply do not prompt: the agent policy bound to the credential decides, and without an autonomous grant the answer is awaiting_approval with a URL for a person. Everything else is safe to run freely.

  • With no terminal they refuse rather than send. --yes is what proceeds, so only pass --yes when the user asked for that specific send. Never add it globally to be rid of prompts.
  • Run sendsets campaign validate CAMPAIGN_ID before campaign start and act on what it reports. It costs nothing, stores nothing, and catches missing senders, empty audiences, broken tracking, an app action with no connection, an event wait with no timeout, and a template that reads an .App key no step produces.
  • mailbox provision spends the user's money every month. Read the catalog with mailbox provision providers rather than assuming a platform or a price: both come from the upstream provider and move. Always show the quote (mailbox provision quote) and get the user's yes before ordering, never pass --yes to it on your own, and hand the checkout or approval link to the user rather than trying to complete it. An order over the credential's policy cap waits for a person by design. A quote holds its prices for fifteen minutes only, because they are the upstream provider's live costs; re-quote rather than provisioning against a stale one.
  • Managed domains renew automatically about a month out, charged at the provider's current renewal price. A renewal in requires_action will lapse and take its mailboxes with it: surface it to the user with its error.fix rather than retrying, because the fix is a card or the provider's console. Check it with mailbox provision renewals whenever a user asks why a managed mailbox stopped working.
  • Never raise a mailbox's daily cap casually. The default is 50 campaign emails per mailbox per day with 600 seconds between sends; a fresh mailbox starts around 10-20. Do not go above 50 unless the user asked and the mailbox has the history to justify it.
  • Keep warmup running on mailboxes that campaign. Do not stop warmup because a campaign started.
  • To stop emailing ONE contact for a while, use sendsets campaign pause-lead CAMPAIGN_ID CONTACT_ID --until 2026-09-21T17:00:00Z, not an unsubscribe and not the suppression list: both of those are workspace-wide and permanent. resume-lead lifts it. SendSets already writes the same hold by itself when a recipient answers with an out-of-office auto-reply, in every campaign that contact is a lead of, so do not also pause a lead that reads paused for that reason.
  • If deliverability shows rising bounces or complaints, stop the campaign and report. Do not push volume into a degrading mailbox.

Errors

Failures print the API's code, request_id and, when the API knows one, a Fix: line to stderr. Branch on code (not_found, forbidden, rate_limit_exceeded, mailbox_auth_failed, event_contact_not_found, campaign_no_mailbox, ...), do what the fix says, and quote request_id when reporting. On rate_limit_exceeded, wait the Retry-After it names.

For a write you retry, pass --idempotency-key <same-key> so a retry cannot double-apply. Any unique string works; reuse it only for the identical retry.

Exit codes: 0 worked, 1 failed, 2 bad command line or a prompt with no terminal, 4 credential.

Watching what happens

sendsets events tail --json --intent EMAIL

Streams the live event stream as newline-delimited JS

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars1.1k
CategoryDevelopment
Updated1mo ago
Forks294

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions
sendsets-cli — Universal Skill: Install & Safety Check | SkillAgent