suprsend-cli

Let your AI agent run SuprSend CLI commands correctly the first time - push workflows, sync workspaces, generate types, and more.

Use this skill when you want your AI agent to push, sync, or manage SuprSend assets from the terminal - without you having to remember --slug vs --dir, or whether --commit=true is needed.

The skill loads the full SuprSend CLI reference into your agent’s context: every command, every flag, and the gotchas that catch people most.

Install

npx skills add https://github.com/suprsend/skills --skill suprsend-cli

Full CLI Reference

Every command, subcommand, flag, and output format.

---

Try it

1. Ask your agent

   Push the cart-abandonment workflow to staging and commit it
   with the message "initial version".
   
2. Your agent runs the right command

   suprsend workflow push --slug cart-abandonment --commit=true \
     --commit-message "initial version"
   

   No guessing at flags. No silent Successfully pushed: 0.

---

Things you can ask your AI to do

Push and version a workflow

“Push the onboarding workflow as a draft, then commit it once I confirm.”

Your agent will push without --commit=true first, wait for your sign-off, then run a follow-up commit.

Pull, edit, push

“Pull the password-reset workflow from production, change the SMS delay from 5 minutes to 2, and push the change to staging.”

Full lifecycle - pull, modify locally, push back - handled by the agent.

Sync between workspaces

“Sync all workflows and schemas from staging to production.”

The agent runs suprsend sync with the right --source-workspace, --target-workspace, and --assets flags.

Generate type-safe SDK code

“Generate TypeScript types for all my event schemas into ./types.”

The agent runs suprsend generate types for TypeScript, Python, Go, Java, Ruby, Swift, or Kotlin.

Set up CI/CD

“Add a GitHub Actions step that pushes any changed workflows on merge to main.”

The agent generates the workflow YAML using the right CLI commands and environment variables.

Manage schemas, events, categories, translations

“Push every event schema in ./schemas to staging.”

Works for schemas, events, preference categories, and translations - same patterns as workflows.

Start the MCP server

“Start the SuprSend MCP server.”

The agent runs suprsend start-mcp-server with the right scopes. See MCP Server.

---

Before your first command

The CLI needs a service token. Pick the auth flow that fits your setup:

Environment variable

export SUPRSEND_SERVICE_TOKEN="your_service_token_here"

Best for CI/CD and one-off shells.

Saved profile

suprsend profile list
suprsend profile use --name <profile-name>

Best for day-to-day development when you switch between workspaces.

--workspace switches between workspaces within an account. The profile command is for self-hosted or BYOC deployments. See Setting Up CLI Access.

---

Common gotchas

These are the mistakes the skill is built to prevent - but worth knowing if something looks off.

workflow push myfile.json silently pushes 0

Why: Command expects --slug or --dir, not a file path.

Fix: Use --slug or --dir suprsend/workflow/.

Workflow pushed but nothing fires

Why: Pushed workflows are drafts by default.

Fix: Add --commit=true.

"Successfully pushed: 0"

Why: Wrong active profile or workspace.

Fix: Run suprsend profile list and switch.

Validation error on push

Why: Referenced schema or category doesn’t exist.

Fix: Push dependencies first.

Run suprsend --help or suprsend <command> --help for full flag details.

---

Learn more

Workflow Schema skill

Generate the workflow JSON your agent will push.

Template Schema skill

Generate the template variants your agent will push.

Docs & Support skill

Let your agent fetch live SuprSend docs while debugging.

Agent Skills Overview

All available skills.