Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.suprsend.com/llms.txt

Use this file to discover all available pages before exploring further.

The SuprSend CLI Changelog provides a comprehensive record of all CLI releases, including new features, bug fixes, breaking changes, and security updates.

​
Release History

Repository: suprsend/cli

Release Date: May 22, 2026

Release: v1.0.0

v1.0.0

May 22, 2026

Changelog:

  • ENG-496: CLI 0.2 config refactor and UX fixes (#65)
  • chore(deps): bump sigstore/cosign-installer in the actions group (#68)
  • genskills: agent-friendly description + per-command Tips (#66)
  • genskills: narrow cli skill trigger to running commands only (#67)
  • profile: URL prompts + tighter validation in add/modify (#35)

Repository: suprsend/cli

Release Date: April 30, 2026

Release: v1.0.0-beta.1

v1.0.0-beta.1

Apr 30, 2026

First beta of the 1.0 line. Breaking release — every artifact-pulling resource changes its on-disk shape, and several CLI short flags change identity. Try it on a non-production workspace first.

Install: npm i -g suprsend@beta · npx suprsend@beta · plain npm i -g suprsend still resolves to 0.2.24.

💥 Breaking — on-disk artifact layout

Every non-template resource moves to a plural top-level dir + per-item subdirectory. Pulled metadata files now embed an upstream $schema reference.

ResourceBeforeAfter
Workflowworkflow/{slug}.jsonworkflows/{slug}/workflow.json
Schemaschema/{slug}.json (json_schema inline)schemas/{slug}/schema.json + schemas/{slug}/payload_schema.json
Eventevent/event_schema_mapping.json (bundled)events/{slugified-name}/event.json
Preference categoriescategory/categories_preferences.json + category/translation/{locale}.jsonpreference_categories/categories.json + preference_categories/translations/{locale}.json
Template translationstranslation/{filename}.jsontranslations/{filename}.json
  • Events use dual identity. Backend allows /, spaces, etc.; pull slugifies the name to a directory handle and preserves the original verbatim in event.json#name. mv events/old/ events/new/ does NOT rename the event — edit event.json#name instead.
  • Schema validation runs client-side. Schema push (real and —dry-run) compiles payload_schema.json against JSON Schema draft 2020-12 and rejects schemas whose root type is not object.

💥 Breaking — CLI short flags

Hard breaks; scripts using the dropped forms fail with unknown flag.

ShortOldNew
-m—commit-message—mode only
-f—offset / —forcedropped
-l—limit / —locale—limit only
-n—no-color—dry-run
-Funused—force (uniform)
-Sunused—from (sync source)
-qunused—quiet (root-persistent)
-junused—json (inline payload on push)

Also: —commit is now a clean boolean everywhere (was string on some); —mode added to template list/get/pull; positional slug AND —slug flag both accepted everywhere; TTY-gated prompts (no more silent CI hangs); confirmations on destructive ops; JSON errors when stderr piped, with stable error codes (auth-missing-token, api-not-found, etc.) and exit codes 0/1/2/3/4/5/64.

✨ New

  • suprsend template command group — full CRUD with per-channel variant extraction, mock data, variant ordering.
  • suprsend workspace list · suprsend env · suprsend completion bash|zsh|fish|powershell.
  • MCP server: dynamic workflow-trigger tools register concurrently (cold-start fix for large workspaces); —workflows accepts tag:{tag} selectors; list-tools shows rich descriptions.
  • MCP Registry support — server published to registry.modelcontextprotocol.io on each stable release (skipped for this beta).
  • Glama listing.
  • —dry-run on every destructive command (push / commit / sync / enable / disable).
  • Streaming template pull — large workspaces (~635 templates) went from 120s+ feeling frozen → ~45s with live Pulled N/Total progress.
  • Per-item progress + summary blocks uniformly across push commands; Wrote … to … log lines on pulls.
  • Push API errors prefixed with the on-disk path (e.g. schemas/order_confirmation: failed to push: {reason}).

🐛 Notable fixes

  • translation list —include-content=true now actually returns content (typed-decode bug).
  • translation get {filename} and event get {name} fetch a single item (were returning the whole workspace).
  • schema list shows name instead of the always-empty title.
  • category push pushes translations alongside categories regardless of —commit (matches docstring).
  • category translation push no longer silent-no-ops when only en.json is present.
  • Cobra’s noisy Usage: dump on every error is silenced.

🔄 Migration

Two paths. Both assume the new CLI is installed — verify with suprsend —version.

Path A — clean re-pull (recommended)

Backs everything up, re-pulls fresh in the new layout. Loses any uncommitted local edits.

mv suprsend suprsend.old
suprsend workflow pull
suprsend event pull
suprsend schema pull
suprsend category pull
suprsend translation pull
# verify the new layout looks right, then:
rm -rf suprsend.old

Path B — convert in place (preserves uncommitted edits)

Run each block from the repo root. Every block is guarded by a “source exists” check, so it’s safe to re-run and safe to skip a resource that doesn’t exist locally.

  • Workflows — pure mv
  • Schemas — splits each schema file into two; requires jq
  • Events — unbundle event_schema_mapping.json and slugify names; requires jq
  • Preference categories — rename dirs and files
  • Template translations — pure directory rename
  • Add the $schema reference — required after Path B

For CLI flag breakages, scripts will fail loudly with unknown flag — fix as you encounter them.

Try it

npm i -g suprsend@beta
suprsend —version   # 1.0.0-beta.1

Stable users (npm i suprsend) unaffected. Homebrew taps and the MCP Registry are skipped for betas and will catch up on 1.0.0 stable.

Issues: https://github.com/suprsend/cli/issues

⚠️ Note: This is a pre-release. Breaking changes are expected — try on a non-production workspace first.

Repository: suprsend/cli

Release Date: March 17, 2026

Release: v0.2.21

v0.2.21

Mar 17, 2026

✨ Powers the suprsend-cli Agent Skill

This release’s improved command descriptions and flags are what make the suprsend-cli Agent Skill accurate. Your coding agent (Cursor, Claude Code, Copilot, and others) now resolves the right CLI command and flags on the first try — no hallucinated syntax.

→ Install Agent Skills

Improvements:

  • Better descriptions and flags for improved LLM consumption — structured so AI agents resolve the right command on the first try.
  • Support for getting and saving a single asset without needing to set up a full SuprSend directory — useful for quick one-off pulls in CI or scripting.
  • Added JSON push support.

Bug Fixes:

  • Fixed cross-compilation of type-morph for each target platform.

Repository: suprsend/cli

Release Date: March 17, 2026

Release: v0.2.20

v0.2.20

Mar 17, 2026

Improvements:

  • Bundle signing key in release

Bug Fixes:

  • Fixed JSON Schema draft 2020-12 validation errors in MCP

Repository: suprsend/cli

Release Date: March 12, 2026

Release: v0.2.19

v0.2.19

Mar 12, 2026

Features:

  • MCP workflow list tool

Improvements:

  • Added GitHub Actions workflow to sign and release artifacts

Bug Fixes:

  • Various bugfixes

Repository: suprsend/cli

Release Date: March 5, 2026

Release: v0.2.18

v0.2.18

Mar 5, 2026

Features:

  • Added support for generating SKILLS.md

Improvements:

  • Upgraded dependencies

Repository: suprsend/cli

Release Date: February 19, 2026

Release: v0.2.16

v0.2.16

Feb 19, 2026

Bug Fixes:

  • Translation file data fix

Repository: suprsend/cli

Release Date: December 12, 2025

Release: v0.2.15

v0.2.15

Dec 12, 2025

Features:

  • Support for translations in Preference Categories

Improvements:

  • Updated golang.org/x/crypto from 0.38.0 to 0.45.0

Repository: suprsend/cli

Release Date: November 7, 2025

Release: v0.2.14

v0.2.14

Nov 7, 2025

Bug Fixes:

  • Fixed a bug where CLI was failing if any version no is null

Repository: suprsend/cli

Release Date: October 31, 2025

Release: v0.2.13

v0.2.13

Oct 31, 2025

Bug Fixes:

  • Few bugfixes for translation support

Repository: suprsend/cli

Release Date: October 31, 2025

Release: v0.2.12

v0.2.12

Oct 31, 2025

Features:

  • Type generation support based of available Schema

Repository: suprsend/cli

Release Date: October 30, 2025

Release: v0.2.11

v0.2.11

Oct 30, 2025

Features:

  • Support for translations

Repository: suprsend/cli

Release Date: October 14, 2025

Release: v0.2.10

v0.2.10

Oct 14, 2025

Improvements:

  • Category response update

Repository: suprsend/cli

Release Date: October 9, 2025

Release: v0.2.9

v0.2.9

Oct 9, 2025

Features:

  • Support for Gemini extension

Bug Fixes:

  • Fixed argument handling
  • Fixed URL join and Gemini version

Repository: suprsend/cli

Release Date: October 9, 2025

Release: v0.2.8

v0.2.8

Oct 9, 2025

Features:

  • Support for Gemini extension

Repository: suprsend/cli

Release Date: October 8, 2025

Release: v0.2.7

v0.2.7

Oct 8, 2025

Improvements:

  • Updated goreleaser config to support signing

Repository: suprsend/cli

Release Date: October 8, 2025

Release: v0.2.3

v0.2.3

Oct 8, 2025

Build Update:

  • Updated goreleaser configuration to support binary notarization

Benefits:

  • Enhanced Security: Ensures the CLI binary is cryptographically verified and trusted by the operating system (especially macOS)
  • Improved User Trust: Prevents “unverified developer” warnings during installation or execution
  • Compliance Ready: Aligns with modern distribution standards required by platforms like Homebrew, Apple Gatekeeper, and enterprise IT policies

⚠️ Note: This is a beta release. Features are still evolving and may change before production readiness.

Repository: suprsend/cli

Release Date: October 8, 2025

Release: v0.2.2

v0.2.2

Oct 8, 2025

Upgrade:

  • Updated mcp-go to version 0.41

Build Improvements:

  • Updated goreleaser configuration for improved release workflow

New Feature:

  • Added Homebrew cask support for easier macOS installation

Maintenance:

  • Minor hotfixes and version alignment

⚠️ Note: This is a beta release. Features are still evolving and may change before production readiness.

Repository: suprsend/cli

Release Date: September 29, 2025

Release: v0.2

v0.2

Sep 29, 2025

✨ Features:

  • MCP Enhancements: Added support for events, event triggers, workflows, workflow triggers, preferences, profiles, and object subscriptions
  • Type & Schema Tools: New type generation (including TypeMorph, TypeScript-Zod), schema commit/reset commands, schema merging, and linkage with workflows
  • CLI Improvements: New subcommands (sync, workflow push/pull/commit, get & trigger, HTTP proxy, category push/pull). Added spinners, progress bar, structured error responses, and improved help/output

🛠 Fixes & Refactors:

  • Multiple bug fixes across profiles, schema, workflow, and MCP tools
  • Refactored workflow flows, profile handling, sync commands, and error handling
  • Improved consistency in output, error messages, and tool naming

📑 Documentation & Cleanup:

  • Expanded documentation and updated README
  • Cleaned up flags, commands, and code structure

🔄 Dependency & Build Updates:

  • Upgraded mcp-go, cobra, viper, and related libraries

⚠️ Note: This is a beta release. Features are still evolving and may change before production readiness.

Repository: suprsend/cli

Release Date: June 20, 2025

Release: v0.1.1

v0.1.1

Jun 20, 2025

New Features:

  • Tenant management tools
  • User fetch/update/prefs
  • Docs command
  • Generate-config subcommand

Improvements:

  • Cleaner CLI output
  • YAML support
  • Better help text
  • Color disabled in piped output

Fixes:

  • License, goreleaser config, version handling, merge conflicts

Other:

  • Project restructuring and build script additions

⚠️ Note: This release is experimental and not intended for production use.

Repository: suprsend/cli

Release Date: May 6, 2025

Release: v0.1

v0.1

May 6, 2025

Setup & Documentation:

  • Initial setup
  • Added MCP Server documentation
  • Created and updated README
  • Improved docs with default mode set to pretty

Improvements:

  • Cleanup, minor changes
  • Updated goreleaser config

⚠️ Note: This release is experimental and not intended for production use.