Wraps CLI Reference

Complete reference for all Wraps CLI commands.

Installation

Email Commands

SMS Commands

CDN Commands

Platform Commands

Wraps Logo
DocsHome
CLI Reference

Wraps CLI Commands

Complete reference for all Wraps CLI commands. Deploy, manage, and monitor your AWS communication infrastructure.

Multi-Service Architecture: Wraps commands are organized by service (e.g., wraps email init, wraps cdn init, wraps sms init).

Service Commands

Email Commands

Deploy and manage AWS SES email infrastructure with event tracking, analytics, and domain management.

View Email Commands
CDN Commands

Deploy S3 + CloudFront CDN infrastructure with browser-based image optimization.

View CDN Commands
SMS Commands

Deploy AWS End User Messaging infrastructure for transactional and marketing SMS.

View SMS Commands
Auth Commands

Authenticate with the Wraps Platform for dashboard access, templates, and workflows.

View Auth Commands
AWS Commands

Set up and diagnose your AWS credentials and permissions.

View AWS Commands
Platform Commands

Connect your AWS infrastructure to the Wraps Platform.

View Platform Commands

Global Commands

wraps push

Push templates and workflows to the Wraps Platform and SES

wraps news

Show latest Wraps news and updates

wraps support

Open support channel

Global Flags

--account <id>

Target a specific AWS account

--token <token>

API token for authentication

--verbose

Enable verbose output

--json

Output JSON (where supported)

Global Options

--help, -h

Display help information for any command

--version, -v

Display the CLI version

--preview

Preview infrastructure changes without deploying. Shows what resources would be created, updated, or deleted along with cost estimates. Available on all deployment commands (init, connect, upgrade, restore, destroy).

-y, --yes

Skip confirmation prompts for non-destructive operations

-f, --force

Force destructive operations without confirmation

wraps status

Display the current status of your Wraps infrastructure across all services, including deployed resources, active features, and configuration details.

Usage
terminal.sh
npx @wraps.dev/cli status
What It Displays
  • AWS account and region
  • All deployed services (email, cdn, sms)
  • Active configuration preset and features per service
  • Deployed AWS resources
  • Links to console and documentation

wraps console

Launch the local Wraps console to view analytics, event tracking, and infrastructure status across all services.

Usage
terminal.sh
npx @wraps.dev/cli console
Options
--port <port>

Port to run the console on (default: 5555)

--no-open

Don't automatically open browser

Features
  • Email history and search
  • Delivery rates and analytics
  • Bounce and complaint tracking
  • Open and click rates
  • CDN file management and uploads
  • Infrastructure resource viewer

wraps destroy

Remove all Wraps infrastructure from your AWS account across all services. This is a destructive operation that requires confirmation.

Usage
terminal.sh
npx @wraps.dev/cli destroy [options]
Options
-f, --force

Skip confirmation prompt (use with caution)

--preview

Preview what would be destroyed without making changes

Important Notes

Use service-specific destroy commands to remove individual services:

  • wraps email destroy - Remove email infrastructure only
  • wraps cdn destroy - Remove CDN infrastructure only

wraps telemetry

Manage anonymous telemetry settings. Wraps collects anonymous usage data to improve the CLI. No personal information, domains, or AWS credentials are ever collected.

Usage
terminal.sh
npx @wraps.dev/cli telemetry         # Show current status
terminal.sh
npx @wraps.dev/cli telemetry enable  # Enable telemetry
terminal.sh
npx @wraps.dev/cli telemetry disable # Disable telemetry
What We Collect
  • Command names and success/failure status
  • CLI version and operating system
  • Never collected: domains, AWS credentials, email content, or any PII

You can also disable telemetry by setting the environment variable WRAPS_TELEMETRY_DISABLED=1

wraps completion

Generate shell completion scripts for bash, zsh, or fish. Enables tab-completion for all Wraps commands and options.

Usage
terminal.sh
npx @wraps.dev/cli completion
Setup

Add the output to your shell configuration file:

Bash: Add to ~/.bashrc

Zsh: Add to ~/.zshrc

Fish: Add to ~/.config/fish/config.fish

Configuration Files

~/.wraps/

Main configuration directory containing deployment metadata and Pulumi state

~/.wraps/connections/

Deployment metadata files (one per AWS account/region combination)

~/.wraps/pulumi/

Pulumi stack state files for infrastructure management

Environment Variables

AWS_PROFILE

AWS CLI profile to use for authentication

AWS_REGION

Default AWS region (can be overridden with --region flag)

AWS_ACCESS_KEY_ID

AWS access key (not recommended, use IAM roles or profiles instead)

AWS_SECRET_ACCESS_KEY

AWS secret key (not recommended, use IAM roles or profiles instead)

Need Help?

If you run into any issues, check our GitHub discussions or open an issue.

Get Help
Morty Proxy This is a proxified and sanitized view of the page, visit original site.