Wraps Logo
CLI Reference / AWS

AWS Commands

Set up and diagnose your AWS credentials and permissions for Wraps.

wraps aws setup

Interactive wizard that detects and configures your AWS credentials. Guides you through setting up IAM users or SSO profiles for use with Wraps.

Usage
GNU Bashterminal.sh
npx @wraps.dev/cli aws setup
What It Does
  • Detects existing AWS configuration (environment variables, ~/.aws/credentials, SSO profiles)
  • If SSO profiles are found, offers to use an existing profile
  • If no credentials are detected, guides you through IAM user creation or SSO setup
  • Validates credentials by calling STS GetCallerIdentity
  • Tests SES permissions to ensure your account can send email
  • Displays your AWS account ID and configured region
Examples

Interactive setup (recommended for first time):

GNU Bashterminal.sh
npx @wraps.dev/cli aws setup

wraps aws doctor

Diagnostic tool that checks your AWS configuration and permissions. Run this when you encounter credential or permission errors.

Usage
GNU Bashterminal.sh
npx @wraps.dev/cli aws doctor [options]
Options
--json

Output diagnostic results as JSON for scripting and automation

What It Checks
  • AWS credential chain (environment variables, profile, SSO, instance role)
  • STS identity validation (GetCallerIdentity)
  • SES permissions (SendEmail, GetAccount)
  • Region configuration and availability
  • Reports any issues with specific fix suggestions
Example Output
output.txt
AWS Credential Check  ✓ Credentials found via SSO profile "wraps-dev"  ✓ STS identity validated (Account: 123456789012)  ✓ Region: us-east-1SES Permission Check  ✓ ses:SendEmail — allowed  ✓ ses:GetAccount — allowed  ✓ ses:GetSendQuota — allowedAll checks passed. Your AWS configuration is ready for Wraps.

Next Steps