CLI Reference | Wraps
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
Deploy and manage AWS SES email infrastructure with event tracking, analytics, and domain management.
View Email CommandsDeploy S3 + CloudFront CDN infrastructure with browser-based image optimization.
View CDN CommandsDeploy AWS End User Messaging infrastructure for transactional and marketing SMS.
View SMS CommandsAuthenticate with the Wraps Platform for dashboard access, templates, and workflows.
View Auth CommandsGlobal 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.
- 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.
--port <port>
Port to run the console on (default: 5555)
--no-open
Don't automatically open browser
- 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.
-f, --force
Skip confirmation prompt (use with caution)
--preview
Preview what would be destroyed without making changes
Use service-specific destroy commands to remove individual services:
wraps email destroy- Remove email infrastructure onlywraps 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.
- 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.
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)