Skip to main content
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 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 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 all workflows and schemas from staging to production.”The agent runs suprsend sync with the right --source-workspace, --target-workspace, and --assets flags.
“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.
“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.
“Push every event schema in ./schemas to staging.”Works for schemas, events, preference categories, and translations - same patterns as workflows.
“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: 
export SUPRSEND_SERVICE_TOKEN="your_service_token_here"
Best for CI/CD and one-off shells.

​
Common gotchas

These are the mistakes the skill is built to prevent - but worth knowing if something looks off.
Why: Command expects --slug or --dir, not a file path.Fix: Use --slug or --dir suprsend/workflow/.
Why: Pushed workflows are drafts by default.Fix: Add --commit=true.
Why: Wrong active profile or workspace.Fix: Run suprsend profile list and switch.
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.